added

Version 2022.10 Release Notes

Version 2022.10 of the Criteo retail media API is live as of October 25th and will be supported until October 31st, 2023. A new version of the Criteo SDK libraries and Postman collection is also now available for 2022.10.

What's New

In this new release, we introduce a series of new endpoints for preferred deals campaign types only. For a copy of these documents, please reach out to your account representative.

Category Search

Product categories allow retailers to create a hierarchal structure that helps narrow down products into unique groups or sub-groups based on shared characteristics.

With the API you can now easily search for a retailer product based on a particular category name, or categories belonging to a retailer.

GETCategory by Category ID Search for categories based on category ID
GETCategories by Retailer Search for retailer categories and filter down by a specific category name

Creatives for Commerce Display

In v2022.10 we are also introducing a set of new API endpoints that allows building commerce display creatives completely through the API. With the new endpoints you will be able to:

✔️ Upload creative image assets
✔️ View available retailer creative templates
✔️ Build new creatives using either one of our built-in templates or using a custom template
✔️ Associate the product SKUs you wish to display on each creative

Step 1 - Creative Asset Uploads

Upload creatives asset files using a new POST call:

POST Upload Image Asset Upload creative asset image file

Step 2 - Creative Builder

Construct new creative assets for preferred deals line items. Here we introduced four new endpoints:

GET Retailer Templates Get a list of available creative templates for a specified retailer
POST Create Creative Create a new account creative
GET Get Creative by Creative ID Get account creative by creative id
PUT Update an Existing Creative Update an existing creative

Step 3 - Creative Product SKU Collection

Launching commerce onsite display creatives requires associating product SKUs with the creative before activating a line item. To support this functionality we introduce the following new endpoints:

GET Get Product SKUs by Line-Item-Id Get a single Product SKU collection (product button)
GET Get Product SKUs by Line Item Id and Product SKU Collection Id Get all the Product SKU collection (product buttons) associated with a line item
POST Create Product SKU Collection to Line Item Create a new Product SKU collection (product buttons) on a line item
PUT Update Line Item Product SKU Collection Update a Product SKU collection (product button)
DELETE Delete Product SKU Collection from a Line Item Id Delete a Product SKU collection (Product Button)