Skip to content

Product panels

The predefined product panels all display product information based on the parameters and incoming arguments that are sent with a panel query.

For mandatory arguments for all panels including request URL format, see Panel query.

Product information panel

The result of a query to this panel is a list of the products as specified in the panel arguments. The sort order of the products are according to positions of the product keys in the products argument. Product keys that are included in the query but not found will not be listed.

Panel arguments

Name Type Description Example
presentation_attributes
Guide
string A comma-separated list of the attributes from the product data to present. Default presentation attributes are used if omitted in query. title,brand,description
products string A comma-separated list of the product keys of the products that should be listed. Returns an empty result if omitted P1,P3,P2
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10

Example panel content

The following example will use the panel argument products=0633225_en-US,0659854_en-US to return product data.

JSON
  {
      "productInformation": [
          {
              "name": "product-information",
              "ticket": "Oy9wcm9kdWN0LWluZm9ybWF0aW9uOyM7IzsjOyM7IzsjOyM7",
              "path": "/product-information",
              "description": "Displays information for one or more specified products.",
              "displayName": "Product Information",
              "attributes": {},
              "resultType": "products",
              "products": [
                  {
                      "key": "0633225_en-US",
                      "ticket": "Oy9wcm9kdWN0LWluZm9ybWF0aW9uOyM7cHJvZHVjdF9rZXk7MDYzMzIyNV9lbi1VUzswNjMzMjI1MDA0X2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0633225004_en-US",
                              "ticket": "Oy9wcm9kdWN0LWluZm9ybWF0aW9uOyM7cHJvZHVjdF9rZXk7MDYzMzIyNV9lbi1VUzswNjMzMjI1MDA0X2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Skinny Fit Blazer"
                          ]
                      }
                  },
                  {
                      "key": "0659854_en-US",
                      "ticket": "Oy9wcm9kdWN0LWluZm9ybWF0aW9uOyM7cHJvZHVjdF9rZXk7MDY1OTg1NF9lbi1VUzswNjU5ODU0MDA1X2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0659854005_en-US",
                              "ticket": "Oy9wcm9kdWN0LWluZm9ybWF0aW9uOyM7cHJvZHVjdF9rZXk7MDY1OTg1NF9lbi1VUzswNjU5ODU0MDA1X2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Kaftan with Tie Belt"
                          ]
                      }
                  }
              ]
          }
      ]
  }

Those who bought also bought panel

The result of a query to this panel is a list of recommended product given a previous purchase. The sort order of the products are according to a product score. The score of a product, p, is equal to the number of visitors who bought the product p and also bought the product given in the product_key argument.

The result can be filtered through arguments to only include particular types of products and variants. The product given in the product_key argument is never included in the result.

Each product element in the result list specify all presentation attributes and the list rank of that product. Each product element also contain all its variants that match the filter ranked by sales.

The arguments product_key, window_first, and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
filter
Guide
filter An expression limiting the considered product and variant set. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
presentation_attributes
Guide
string A comma-separated list of the attributes from the product data to present. Default presentation attributes are used if omitted in query. title,author
product_key string The product key to base the recommendations on.
Required argument.
P1
remove_recently_bought boolean A boolean indicating if the recent purchases of a visitor should be excluded from the result. Defaults to false if omitted in the query. true
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: window_firstwindow_last ≤ 10 000.
Required argument.
5

Example panel content

The following example will use the panel arguments product_key=0633225_en-US, window_first=1, and window_last=3 to return product data.

JSON
  {
      "thoseWhoBoughtAlsoBought": [
          {
              "name": "those-who-bought-also-bought",
              "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7IzsjOyM7IzsjOyM7",
              "path": "/those-who-bought-also-bought",
              "description": "Displays products purchased by others who also purchased a specified product.",
              "displayName": "Those Who Bought Also Bought",
              "attributes": {},
              "resultType": "products",
              "products": [
                  {
                      "key": "0226964_en-US",
                      "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDIyNjk2NF9lbi1VUzswMjI2OTY0MDEzX2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0226964013_en-US",
                              "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDIyNjk2NF9lbi1VUzswMjI2OTY0MDEzX2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Derby Shoes"
                          ]
                      }
                  },
                  {
                      "key": "0548793_en-US",
                      "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDU0ODc5M19lbi1VUzswNTQ4NzkzMDA0X2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0548793004_en-US",
                              "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDU0ODc5M19lbi1VUzswNTQ4NzkzMDA0X2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Bomber Jacket"
                          ]
                      }
                  },
                  {
                      "key": "0484262_en-US",
                      "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDQ4NDI2Ml9lbi1VUzswNDg0MjYyMDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0484262001_en-US",
                              "ticket": "Oy90aG9zZS13aG8tYm91Z2h0LWFsc28tYm91Z2h0OyM7cHJvZHVjdF9rZXk7MDQ4NDI2Ml9lbi1VUzswNDg0MjYyMDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Knee-length Corduroy Shorts"
                          ]
                      }
                  }
              ]
          }
      ]
  }

Those who viewed also viewed panel

The result of a query to this panel is a list of products that were viewed after a specified product was viewed. The sort order of the products are according to a product score. The score of a product, p, is equal to the number of sessions where where a visitor has clicked on the product given in the product_key argument and then clicked on the product p.

The result can be filtered through arguments to only include particular types of products and variants. The product given in the product_key argument is never included in the result.

Each product element in the result list specify all presentation attributes and the list rank of that product. Each product element also contain all its variants that match the filter ranked by sales.

The arguments product_key, window_first, and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
filter
Guide
filter An expression limiting the considered product and variant set. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
presentation_attributes
Guide
string A comma-separated list of the attributes from the product data to present. Default presentation attributes are used if omitted in query. title,author
product_key string The product key to base the recommendations on.
Required argument.
P1
remove_recently_bought boolean A boolean indicating if the recent purchases of a visitor should be excluded from the result. Defaults to false if omitted in the query. true
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10
window_first int The first position in the list to be presented.
Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented.
Products after this position, according to the sorting, are not present in the result. The following bounds apply: window_firstwindow_last ≤ 10 000.
Required argument.
5

Example panel content

The following example will use the panel arguments product_key=0633225_en-US, window_first=1, and window_last=3 to return product data.

JSON
  {
      "thoseWhoViewedAlsoViewed": [
          {
              "name": "those-who-viewed-also-viewed",
              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7IzsjOyM7IzsjOyM7",
              "path": "/those-who-viewed-also-viewed",
              "description": "Displays products that was viewed immediately after viewing a specified product.",
              "displayName": "Those Who Viewed Also Viewed",
              "attributes": {},
              "resultType": "products",
              "products": [
                  {
                      "key": "0734194_en-US",
                      "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDczNDE5NF9lbi1VUzswNzM0MTk0MDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0734194001_en-US",
                              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDczNDE5NF9lbi1VUzswNzM0MTk0MDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Skinny Fit Blazer"
                          ]
                      }
                  },
                  {
                      "key": "0713995_en-US",
                      "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDcxMzk5NV9lbi1VUzswNzEzOTk1MDA3X2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0713995007_en-US",
                              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDcxMzk5NV9lbi1VUzswNzEzOTk1MDA3X2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Skinny Fit Blazer"
                          ]
                      }
                  },
                  {
                      "key": "0516778_en-US",
                      "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDUxNjc3OF9lbi1VUzswNTE2Nzc4MDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                      "variants": [
                          {
                              "key": "0516778001_en-US",
                              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWFsc28tdmlld2VkOyM7cHJvZHVjdF9rZXk7MDUxNjc3OF9lbi1VUzswNTE2Nzc4MDAxX2VuLVVTOztOT05FOk5PTkU7OTs",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Wool Tuxedo Jacket Skinny fit"
                          ]
                      }
                  }
              ]
          }
      ]
  }

Those who viewed bought panel

The result of a query to this panel is a list of products that were bought after a specified product was viewed. The sort order of the products are according to a product score. The score of a product, p, is equal to the number of sessions where where a visitor has clicked on the product given in the product_key argument and then bought the product p.

The result can be filtered through arguments to only include particular types of products and variants. The product given in the product_key argument is never included in the result.

Each product element in the result list specify all presentation attributes and the list rank of that product. Each product element also contain all its variants that match the filter ranked by sales.

The arguments window_first and window_last must be included in a query to this panel.

Panel arguments

Name Type Description Example
filter
Guide
filter An expression limiting the considered product and variant set. Defaults to UNIVERSE if omitted in the query color:'red' OR color:'blue' AND in_stock:'true'
presentation_attributes
Guide
string A comma-separated list of the attributes from the product data to present. Default presentation attributes are used if omitted in query. title,author
product_key string The product key to base the recommendations on.
Required argument.
P1
remove_recently_bought boolean A boolean indicating if the recent purchases of a visitor should be excluded from the result. Defaults to false if omitted in the query. true
variants_per_product int The maximum number of variants per product to include in the result. No maximum limit. 10
window_first int The first position in the list to be presented. Products before this position, according to the sorting, are not present in the result. The position of the first product in the list is 1.
Required argument.
1
window_last int The last position in the list to be presented. Products after this position, according to the sorting, are not present in the result. The following bounds apply: window_firstwindow_last ≤ 10 000.
Required argument.
5

Example panel content

The following example will use the panel arguments product_key=0633225_en-US, window_first=1, and window_last=3 to return product data.

JSON
  {
      "thoseWhoViewedBought": [
          {
              "name": "those-who-viewed-bought",
              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWJvdWdodDsjOyM7IzsjOyM7IzsjOw",
              "path": "/those-who-viewed-bought",
              "description": "Displays products that was purchased after viewing a specified product.",
              "displayName": "Those Who Viewed Bought",
              "attributes": {},
              "resultType": "products",
              "products": [
                  {
                      "key": "0633225_en-US",
                      "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWJvdWdodDsjO3Byb2R1Y3Rfa2V5OzA2MzMyMjVfZW4tVVM7MDYzMzIyNTAwNF9lbi1VUzs7Tk9ORTpOT05FOzk7",
                      "variants": [
                          {
                              "key": "0633225004_en-US",
                              "ticket": "Oy90aG9zZS13aG8tdmlld2VkLWJvdWdodDsjO3Byb2R1Y3Rfa2V5OzA2MzMyMjVfZW4tVVM7MDYzMzIyNTAwNF9lbi1VUzs7Tk9ORTpOT05FOzk7",
                              "attributes": {}
                          }
                      ],
                      "attributes": {
                          "product_name": [
                              "Skinny Fit Blazer"
                          ]
                      }
                  }
              ]
          }
      ]
  }
×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE