v2022.04 Release Notes - Criteo Docs

Documentation for the Retail Media API

Documentation for the latest version of the Retail Media API is now live! See what’s new in v2022.04

Version 2022.04 of the Criteo API is live as of April 5th, 2022. This version will be supported until April 4th, 2023.

This version introduces several new capabilities to Criteo Retail Media API and introduces changes in previously existing endpoints. This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.

New Base URL

We are moving from:

https://api.criteo.com/2021-10/retail-media/{endpoint}

to

https://api.criteo.com/2022-04/retail-media/{endpoint}

What’s New in v2022.04

🆕 New Capability to Pause or Unpause the Serving of an SKU In this new version, we have introduced two new endpoints that allow to pause or unpause products belonging to a line item. The new endpoints also provide the option to apply a bid override. The new endpoints include

POST - https://api.criteo.com/2022-04/retail-media/line-items/{lineItemId}/products/pause
POST - https://api.criteo.com/2022-04/retail-media/line-items/{lineItemId}/products/unpause

• See the Line item endpoints guide for more details.

📊 Updates Made to Report Field Names, and Metric Calculations Metric Calculation Changes We changed impression calculation for preferred deals and open auction campaigns. These changes in the API are now reflecting the same reporting logic for impressions used by reports within the Retail Media Platform. For the following reports, the API will report impressions as follows:

• For Preferred Deals campaigns - the sum of placement impressions
• For Open Auction campaigns - the sum of product impressions

Summary Report Metrics changed by impression calculation change:

pageType Report Metrics changed by impression calculation change:

Keyword Report Metrics changed by impression calculation change:

Report Field Names In this version, we also updated some report field names. For example, in previous versions where the reports fields such as productCPC or productRoas, in the latest version, we renamed to simply CPC or ROAS.

NOTE Besides metrics that utilize impressions for calculations, no other report metric had its calculation logic modified.

Campaign Reports

Line Item Reports