## 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**](https://developers.criteo.com/retail-media/v2022.10/docs/api-client-libraries) and [**Postman**](https://developers.criteo.com/retail-media/v2022.10/docs/use-postman-with-the-criteo-retail-media-api) 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.

|  |  |  |
| --- | --- | --- |
| **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 allow 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)_ |