Version 2023.01 Release Notes - Criteo Docs
Version 2023.01 of the Criteo Retail Media API
Version 2023.01 of the Criteo retail media API is live as of January 17th and will be supported until January 30th, 2024. A new Postman collection will also be available in the upcoming days for 2023.01.
This version introduces new capabilities to the Criteo Retail Media API and changes to existing endpoints. This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.
New Base URL
With the introduction of this new version, the base URL will now change from:
https://api.criteo.com/2022-10/retail-media/{endpoint}
to:
https://api.criteo.com/2023-01/retail-media/{endpoint}
What’s New
In v.2023.01, we introduced new campaign and line-item features and attributes.
Bid Multipliers
We introduced two new endpoints in the latest release to support bid multiples for open auction line items. Bid Multipliers provide campaign managers more control over managing bids at the line item level while also optimizing campaign performance goals at a page-type level. Bid multipliers are available for enabled page types for Open Auction line items.
New Endpoints Include
| Verb | Endpoint | Description |
|---|---|---|
| GET | /line-items/{lineItemId}/bid-multipliers |
Returns all bid multipliers for valid page types of the specified line item. |
| PUT | /line-items/{lineItemId}/bid-multipliers |
Replaces all existing bid multipliers with the provided bid multipliers or the default value (1.0). |
New Campaign Attributes
In the Campaigns API, we added five new campaign attributes to support campaign management. These attributes are available starting with API version 2023.01. The new attributes include the following:
- monthlyPacing - The maximum monthly spend allowed for the campaign in the currency of the account.
- daily pacing - The maximum daily spend allowed for the campaign in the currency of the account.
- isAutoDailyPacing - automatically controls your daily pacing by calculating the days left in the month of the account.
- startDate - set a campaign start date.
- endDate - set a campaign end date.