Analytics from MAPI to Criteo API

❗️

Sunset of MAPI

All MAPI endpoints were migrated to Criteo API on July 18, 2022. To learn more about using the Criteo APIs please see our Onboarding checklist.

This guide shows you how to update to Statistics v2022-01

https://api.criteo.com/2023-01/statistics/report

If you are currently using the Statistics V1 endpoint

https://api.criteo.com/marketing/v1/statistics

This article focuses on the changes required to use the endpoint. But you will need to update also your authentication system.
Please see our Onboarding checklist to learn how to create a developer Account, get access to your new credentials and request access to your users.
And please see our Authentication guide to learn how to authenticate and get your token.

Statistics 2022-01 has 100+ new metrics across marketing goals and channels, including App, Web, and Store campaigns.
Additionally, you can now:

• Specify your time zone (list available in our Timezones Supported guide)
• Keep track of your category history
• Benefit from a nearly real-time look into your data and campaign performance
• ROAS and AverageCart metrics are now available for every attribution model (including PC30D, PC7D, PC1D, PV24H, and PC30DPV24H)
• Omnichannel campaigns are easier to analyze, with the xDevice parameter and the inclusion of PV24H and client attribution as new attribution models
• App campaigns metrics have been renamed for clarity

Below you can find how requests in Statistics 2022-01 are different, and how to update your integration.

Changes to requests

Below is a summary of the changes that you’ll want to reflect in your requests.

Additional updates

• There are now no restrictions on the number of dimensions (previously 3) or the order of dimensions (previously a limited set of combinations/ordering)
• We removed that non-time dimensions (advertiser, adset, category) when requested would return both the id and name dimension. Now you must explicitly request the one you’d like
• We removed the behavior where the AdvertiserId dimension was always added, whether or not it was requested
• The returned key will always match the requested key. Metrics previously were returned with translated keys. For example, if you requested "SalesPc", the response would be "Sales PC" and translated based on user language
• Category names that were unknown previously had the translated value of "Unknown". This will no longer be translated
• We now report explicitly on each category currently disabled or enabled. Previously, any categories that were disabled at the time of the request the stats were grouped into an "Other" category dimension

New metrics in Statistics 2022-01

You can now slice and dice your data with 100+ new metrics across marketing goals and channels, including App, Web, and Store campaigns.

Below are some of the new ways that you can analyze your campaigns’ performance through Statistics 2022-01.

Some metrics allow for specifying the device, attribution, and deduplication parameters.

Metrics are created with a common structure, such as: SalesAllPc30dClientAttribution

The naming follows the following pattern:
[Measurement][Devices][AttributionModel][LookbackWindow] 

 

All metrics available in Criteo Commerce Growth are available through the Statistics API. To explore all available metrics, dimensions, and options, see the Statistics guide.