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 Postmancollection 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.

GET

Category by Category ID

Search for categories based on category ID

GET

Categories 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)