Skip to content

Ads Panels

The pre-defined ads panels all display ads 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.

Ad information panel

The result of a query to this panel is a list of the ads that were specified in the ads argument. The ads will be ordered according to the ad keys ads argument. Ad keys that cannot be found in the data will not be listed.

The result is a list of ad elements, each specifying all presentation attributes and the list rank of that ad together with a list of products (with variants) from the included filter attribute of the ad. The number of products in the result depends on the value of the attribute live_products for each ad.

Products in a result will be internally ranked based on sales and sorted by the personal sort order.

Panel arguments

Name Type Description Example
ads string A comma-separated list of ad keys of the ads that should be listed. Will return empty result if omitted in the query. AD1,AD3,AD2
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Presentation attributes for ads may also be specified. Default presentation attributes are used if omitted in the query. product_name,image_url
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 ads: AD1,AD3,AD2 to return ad information.

JSON
{
  "resultType": "ads",
  "ads": [
    {
      "key": "AD1",
      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDE",
      "attributes": {
      "ad_key": "AD1",
      "campaign_key": "C1",
      "rank": "1",
      "end_time": "2018-01-07T10:00+02:00",
      "included": "UNIVERSE",
      "related": "UNIVERSE",
      "start_time": "2017-12-21T10:00+02:00",
      "custom_ad_attribute": "valueAD1"
      },
      "products": [
      {
        "key": "P1",
        "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMDs",
        "variants": [
        {
          "key": "V1",
          "ticket": "Oy9hZC1pbmZvcm1hdGlvblw7O2FkMTtwcm9kdWN0X2tleTtQMTtWMTsjOyM7Izs",
          "attributes": {
            "custom_attribute": "value"
          }
                  }
        ],
        "attributes": {
        "product_key": "P1",
        "rank": "1",
        "custom_attribute1": "value1",
        "custom_attribute2": "value2"
        }
      },
      {
        "key": "P8",
        "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMTs",
        "attributes": {
        "product_key": "P8",
        "rank": "2",
        "custom_attribute1": "value1",
        "custom_attribute2": "value2"
        }
      },
      {
        "key": "P7",
        "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMjs",
        "attributes": {
        "product_key": "P7",
        "rank": "3",
        "custom_attribute1": "value1",
        "custom_attribute2": "value2"
        }
      }
      ]
    },
    {
      "key": "AD3",
      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDM",
      "attributes": {
        "ad_key": "AD3",
        "campaign_key": "C1",
        "rank": "2",
        "end_time": "2017-12-01T10:00+02:00",
        "included": "UNIVERSE",
        "related": "UNIVERSE",
        "start_time": "2017-11-01T10:00+02:00",
        "custom_ad_attribute": "valueAD3"
      },
      "products": []
    },
    {
       "key": "AD2",
       "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDI",
       "attributes": {
        "ad_key": "AD2",
        "rank": "3",
        "included": "category:'c1'",
        "related": "category:'c1'",
        "start_time": "2017-11-01T10:00+02:00",
        "end_time": "2018-11-01T10:00+02:00",
        "custom_ad_attribute": "valueAD2"
      },
       "products": [ 
        {
          "key": "P18",
          "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMDs",
          "attributes": {
          "product_key": "P18",
          "rank": "1",
          "custom_attribute1": "value1",
          "custom_attribute2": "value2"
          }
        },
        {
          "key": "P6",
          "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMTs",
          "attributes": {
          "product_key": "P6",
          "rank": "2",
          "custom_attribute1": "value1",
          "custom_attribute2": "value2"
          }
        },
        {
          "key": "P12",
          "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMjs",
          "attributes": {
          "product_key": "P12",
          "rank": "3",
          "custom_attribute1": "value1",
          "custom_attribute2": "value2"
          }
        }
      ]
    }
  ]
}

Ads by customer panel

The result of a query to this panel is a list of ads based on the history of clicks, purchases, and the current cart of a visitor. If several ads are considered equally relevant to the visitor, or if no such history is present, the ads will be ranked based on their general performance, see the Top ads panel.

Note

Only ads that have set the included filter attribute can be included in the personalised ranking. The filter must include products that are somehow related to the visitor's history. Ads without an included filter can be included in the backfill ranking.

Ads will only be included in the result if the following two requirements are met:

  1. The ad matches the ad_filter argument.
  2. The time argument is in between the values for the for the start_time and end_time attributes for the ad.

The result is a list of ads, each specifying all presentation attributes and the rank of that ad, together with a list of products (with variants) from the included filter attribute of the ad. The number of products in each ad in the result depends on the value of the attribute live_products for that ad.

Products in a result will be internally ranked based on sales and sorted by the personal sort order.

The argument max_ads must be included in a query to this panel.

Panel arguments

Name Type Description Example
ad_filter
Guide
filter An expression defining the set of ads to consider. Defaults to UNIVERSE if omitted in the query. campaign_key:'summer-sale'
max_ads int The number of ads to return in the result.
Required argument.
3
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Presentation attributes for ads may also be specified. Default presentation attributes are used if omitted in the query. product_name,image_url
time time_point A time to get ads for. The time should be written in ISO 8601 format, including offset. Defaults to server time if omitted in the query. 2017-10-14T12:00:00+01:00

Example panel content

The following example will use the panel argument max_ads: 3 to return ads by customer.

JSON
{
  "resultType": "ads",
  "ads": [
      {
          "key": "AD1",
          "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQx",
          "attributes": {
              "ad_key": "AD1",
              "campaign_key": "C1",
              "rank": "1",
              "end_time": "2018-01-07T10:00+02:00",
              "included": "UNIVERSE",
              "related": "UNIVERSE",
              "start_time": "2017-12-21T10:00+02:00",
              "custom_ad_attribute": "valueAD1"
          },
          "products": [
          {
            "key": "P1",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMDs",
            "variants": [
                {
                  "key": "V1",
                  "ticket": "Oy9hZC1pbmZvcm1hdGlvblw7O2FkMTtwcm9kdWN0X2tleTtQMTtWMTsjOyM7Izs",
                  "attributes": {
                      "custom_attribute": "value"
                  }
              }
            ],
            "attributes": {
                "product_key": "P1",
                "rank": "1",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
            "key": "P8",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMTs",
            "attributes": {
                "product_key": "P8",
                "rank": "2",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
              "key": "P7",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P7",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
          }
          ]
      },
      {
          "key": "AD2",
          "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQy",
          "attributes": {
                "ad_key": "AD2",
                "campaign_key": "C1",
                "rank": "2",
                "end_time": "2017-12-01T10:00+02:00",
                "included": "category:'c1'",
                "related": "UNIVERSE",
                "start_time": "2017-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD2"
          },
          "products": []
      },
      {
          "key": "AD3",
           "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQz",
           "attributes": {
                "ad_key": "AD3",
                "rank": "3",
                "included": "category:'c2' AND price:'99'",
                "related": "category:'c2'",
                "start_time": "2017-11-01T10:00+02:00",
                "end_time": "2018-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD3"
          },
          "products": [ 
            {
              "key": "P18",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMDs",
              "attributes": {
                  "product_key": "P18",
                  "rank": "1",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P6",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMTs",
              "attributes": {
                  "product_key": "P6",
                  "rank": "2",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P12",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P12",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            }
          ]
      }
    ]
}

Ads by product panel

The result of a query to this panel is a ranked list of ads based on product keys supplied in the products argument.

Ads will only be included in the result if the following two requirements are met:

  1. The ad matches the ad_filter argument.
  2. The time argument is in between the values for the for the start_time and end_time attributes for the ad.

The result is a list of ads, each specifying all presentation attributes and the rank of that ad, together with a list of products (with variants) from the included filter attribute of the ad.

The number of products in each ad in the result depends on the value of the attribute live_products for that ad. The rank of the ads are based on the argument products together with the included filter, the related filter, and the measured performance of the different ads, see the Top ads panel.

Products in a result will be internally ranked based on sales and sorted by the personal sort order.

The arguments max_ads and products must be included in a query to this panel.

Panel arguments

Name Type Description Example
ad_filter
Guide
filter An expression defining the set of ads to consider. Defaults to UNIVERSE if omitted in the query. campaign_key:'summer-sale'
max_ads int The number of ads to return in the result.
Required argument.
3
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Presentation attributes for ads may also be specified. Default presentation attributes are used if omitted in the query. product_name,image_url
products string A comma-separated list of product keys.
Required argument.
P1,P2,P3
time time_point A time to get ads for. The time should be written in ISO 8601 format, including offset. Defaults to server time if omitted in the query. 2017-10-14T12:00:00+01:00
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 arguments products: P1,P2,P4 and max_ads: 3 to return ads by product.

JSON
{
  "resultType": "ads",
  "ads": [
      {
          "key": "AD1",
          "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQx",
          "attributes": {
              "ad_key": "AD1",
              "campaign_key": "C1",
              "rank": "1",
              "end_time": "2018-01-07T10:00+02:00",
              "included": "UNIVERSE",
              "related": "UNIVERSE",
              "start_time": "2017-12-21T10:00+02:00",
              "custom_ad_attribute": "valueAD1"
          },
          "products": [
          {
            "key": "P1",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMDs",
            "variants": [
                {
                  "key": "V1",
                  "ticket": "Oy9hZC1pbmZvcm1hdGlvblw7O2FkMTtwcm9kdWN0X2tleTtQMTtWMTsjOyM7Izs",
                  "attributes": {
                      "custom_attribute": "value"
                  }
              }
            ],
            "attributes": {
                "product_key": "P1",
                "rank": "1",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
            "key": "P8",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMTs",
            "attributes": {
                "product_key": "P8",
                "rank": "2",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
              "key": "P7",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P7",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
          }
          ]
      },
      {
          "key": "AD2",
          "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQy",
          "attributes": {
                "ad_key": "AD2",
                "campaign_key": "C1",
                "rank": "2",
                "end_time": "2017-12-01T10:00+02:00",
                "included": "category:'c1'",
                "related": "UNIVERSE",
                "start_time": "2017-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD2"
          },
          "products": []
      },
      {
          "key": "AD3",
           "ticket": "L2Fkcy1ieS1jdXN0b21lcjthZF9rZXk7QUQz",
           "attributes": {
                "ad_key": "AD3",
                "rank": "3",
                "included": "category:'c2' AND price:'99'",
                "related": "category:'c2'",
                "start_time": "2017-11-01T10:00+02:00",
                "end_time": "2018-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD3"
          },
          "products": [ 
            {
              "key": "P18",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMDs",
              "attributes": {
                  "product_key": "P18",
                  "rank": "1",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P6",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMTs",
              "attributes": {
                  "product_key": "P6",
                  "rank": "2",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P12",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P12",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            }
          ]
      }
  ]
}

Ads by search panel

The result of a query to this panel is a ranked list of ads relevant in combination with a specific search result.

Ads will only be included in the result if the following two requirements are met:

  1. The ad matches the ad_filter argument.
  2. The time argument is in between the values for the for the start_time and end_time attributes for the ad.

The result is a list of ads, each specifying all presentation attributes and the rank of that ad, together with a list of products (with variants) from the included filter attribute of the ad.

The number of products in each ad in the result depends on the value of the attribute live_products for that ad. The rank of the ads are based on the arguments filter, search_attributes, and search_phrase together with the included filter, the related filter, and the measured performance of the different ads, see the Top ads panel.

Products in a result will be internally ranked based on the active exposure strategy as set in the Business app, and sorted by the personal sort order.

The argument max_ads must be included in a query to this panel.

Panel arguments

Name Type Description Example
ad_filter
Guide
filter An expression defining the set of ads to consider. Defaults to UNIVERSE if omitted in the query. campaign_key:'summer-sale'
facets
Guide
facets A pipe-separated list of selected facet values used as facets argument for the corresponding Search hits panel. Ignored with no impact on the result if omitted in the query. color:red|blue,size:6
filter
Guide
filter The filter expression used as filter argument for the corresponding Search hits panel. Defaults to UNIVERSE if omitted in the query. color:'red' OR color:'blue' AND in_stock:'true'
max_ads int The number of ads to return in the result.
Required argument.
3
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Presentation attributes for ads may also be specified. Default presentation attributes are used if omitted in the query. product_name,image_url
search_attributes
Guide
string A comma-separated list of the product attributes used as search_attributes argument for the corresponding Search hits panel. Rank order will not be based on search if omitted in the query. name,brand
search_phrase string The search phrase used as search_phrase argument for the corresponding Search hits panel. Rank order will not be based on search if omitted in the query. red dress
time time_point A time to get ads for. The time should be written in ISO 8601 format, including offset. Defaults to server time if omitted in the query. 2017-10-14T12:00:00+01:00
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 arguments search_attribute: artists,title, search_phrase: madonna, and max_ads: 3 to return ads by search.

JSON
{
  "resultType": "ads",
  "ads": [
      {
          "key": "AD1",
          "ticket": "L2Fkcy1ieS1zZWFyY2g7YWRfa2V5O0FEMQ",
          "attributes": {
              "ad_key": "AD1",
              "campaign_key": "C1",
              "rank": "1",
              "end_time": "2018-01-07T10:00+02:00",
              "included": "UNIVERSE",
              "related": "UNIVERSE",
              "start_time": "2017-12-21T10:00+02:00",
              "custom_ad_attribute": "valueAD1"
          },
          "products": [
          {
            "key": "P1",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMDs",
            "variants": [
                {
                  "key": "V1",
                  "ticket": "Oy9hZC1pbmZvcm1hdGlvblw7O2FkMTtwcm9kdWN0X2tleTtQMTtWMTsjOyM7Izs",
                  "attributes": {
                      "custom_attribute": "value"
                  }
              }
            ],
            "attributes": {
                "product_key": "P1",
                "rank": "1",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
            "key": "P8",
            "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMTs",
            "attributes": {
                "product_key": "P8",
                "rank": "2",
                "custom_attribute1": "value1",
                "custom_attribute2": "value2"
            }
          },
          {
              "key": "P7",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P7",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
          }
          ]
      },
      {
          "key": "AD2",
          "ticket": "L2Fkcy1ieS1zZWFyY2g7YWRfa2V5O0FEMg",
          "attributes": {
                "ad_key": "AD2",
                "campaign_key": "C1",
                "rank": "2",
                "end_time": "2017-12-01T10:00+02:00",
                "included": "category:'c1'",
                "related": "UNIVERSE",
                "start_time": "2017-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD2"
          },
          "products": []
      },
      {
          "key": "AD3",
           "ticket": "L2Fkcy1ieS1zZWFyY2g7YWRfa2V5O0FEMw",
           "attributes": {
                "ad_key": "AD3",
                "rank": "3",
                "included": "category:'c2' AND price:'99'",
                "related": "category:'c2'",
                "start_time": "2017-11-01T10:00+02:00",
                "end_time": "2018-11-01T10:00+02:00",
                "custom_ad_attribute": "valueAD3"
          },
          "products": [ 
            {
              "key": "P18",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMDs",
              "attributes": {
                  "product_key": "P18",
                  "rank": "1",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P6",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMTs",
              "attributes": {
                  "product_key": "P6",
                  "rank": "2",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            },
            {
              "key": "P12",
              "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMjs",
              "attributes": {
                  "product_key": "P12",
                  "rank": "3",
                  "custom_attribute1": "value1",
                  "custom_attribute2": "value2"
              }
            }
          ]
      }
  ]
}

Top ads panel

The result of a query to this panel is a list of the ads that are performing best at the moment according to Apptus eSales. The performance of an ad is based on how much revenue an ad has generated, how often the ad has been displayed, and the click-through-rate of the ad.

Ads will only be included in the result if the following two requirements are met:

  1. The ad matches the ad_filter argument.
  2. The time argument is in between the values for the for the start_time and end_time attributes for the ad.

The result is a list of ads, each specifying all presentation attributes and the rank of that ad, together with a list of products (with variants) from the included filter attribute of the ad.

The number of products in each ad in the result depends on the value of the attribute live_products for that ad. Products in a result will be internally ranked based on sales and sorted by the personal sort order.

The argument max_ads must be included in a query to this panel.

Panel arguments

Name Type Description Example
ad_filter
Guide
filter An expression defining the set of ads to consider. Defaults to UNIVERSE if omitted in the query. campaign_key:'summer-sale'
max_ads int The number of ads to return in the result.
Required argument.
3
presentation_attributes
Guide
string A comma-separated list of the attributes in the product data to present. Presentation attributes for ads may also be specified. Default presentation attributes are used if omitted in the query. product_name,image_url
time time_point A time to get ads for. The time should be written in ISO 8601 format, including offset. Defaults to server time if omitted by the query. 2017-10-14T12:00:00+01:00

Example panel content

The following example will use the panel argument max_ads: 3 to return top ads.

JSON
{
   "resultType": "ads",
           "ads": [
              {
                  "key": "AD1",
                  "ticket": "L3RvcC1hZHM7YWRfa2V5O0FEMQ",
                  "attributes": {
                      "ad_key": "AD1",
                      "campaign_key": "C1",
                      "rank": "1",
                      "end_time": "2018-01-07T10:00+02:00",
                      "included": "UNIVERSE",
                      "related": "UNIVERSE",
                      "start_time": "2017-12-21T10:00+02:00",
                      "custom_ad_attribute": "valueAD1"
                  },
                  "products": [
                  {
                    "key": "P1",
                    "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMDs",
                    "variants": [
                        {
                          "key": "V1",
                          "ticket": "Oy9hZC1pbmZvcm1hdGlvblw7O2FkMTtwcm9kdWN0X2tleTtQMTtWMTsjOyM7Izs",
                          "attributes": {
                              "custom_attribute": "value"
                          }
                      }
                    ],
                    "attributes": {
                        "product_key": "P1",
                        "rank": "1",
                        "custom_attribute1": "value1",
                        "custom_attribute2": "value2"
                    }
                  },
                  {
                    "key": "P8",
                    "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMTs",
                    "attributes": {
                        "product_key": "P8",
                        "rank": "2",
                        "custom_attribute1": "value1",
                        "custom_attribute2": "value2"
                    }
                  },
                  {
                      "key": "P7",
                      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDEwcm9kdWN0X2tleTtQMjs",
                      "attributes": {
                          "product_key": "P7",
                          "rank": "3",
                          "custom_attribute1": "value1",
                          "custom_attribute2": "value2"
                      }
                  }
                  ]
              },
              {
                  "key": "AD2",
                  "ticket": "L3RvcC1hZHM7YWRfa2V5O0FEMg",
                  "attributes": {
                        "ad_key": "AD2",
                        "campaign_key": "C1",
                        "rank": "2",
                        "end_time": "2017-12-01T10:00+02:00",
                        "included": "category:'c1'",
                        "related": "UNIVERSE",
                        "start_time": "2017-11-01T10:00+02:00",
                        "custom_ad_attribute": "valueAD2"
                  },
                  "products": []
              },
              {
                  "key": "AD3",
                   "ticket": "L3RvcC1hZHM7YWRfa2V5O0FEMw",
                   "attributes": {
                        "ad_key": "AD3",
                        "rank": "3",
                        "included": "category:'c2' AND price:'99'",
                        "related": "category:'c2'",
                        "start_time": "2017-11-01T10:00+02:00",
                        "end_time": "2018-11-01T10:00+02:00",
                        "custom_ad_attribute": "valueAD3"
                  },
                  "products": [ 
                    {
                      "key": "P18",
                      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMDs",
                      "attributes": {
                          "product_key": "P18",
                          "rank": "1",
                          "custom_attribute1": "value1",
                          "custom_attribute2": "value2"
                      }
                    },
                    {
                      "key": "P6",
                      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMTs",
                      "attributes": {
                          "product_key": "P6",
                          "rank": "2",
                          "custom_attribute1": "value1",
                          "custom_attribute2": "value2"
                      }
                    },
                    {
                      "key": "P12",
                      "ticket": "L2FkLWluZm9ybWF0aW9uO2FkX2tleTthZDIwcm9kdWN0X2tleTtQMjs",
                      "attributes": {
                          "product_key": "P12",
                          "rank": "3",
                          "custom_attribute1": "value1",
                          "custom_attribute2": "value2"
                      }
                    }
                  ]
              }
          ]
}
×