Migration guide for MAPI users
New authentication required
Criteo API requires to use credentials issued through Developer Dashboard. Please see this Authentication guide for more information.
Introduction
This article is intended for account owners and application owners to serve as a guidance for migrating MAPI connector to Criteo API connector. Article lists actions required to perform successful migration and has an overview of the equivalent Criteo API endpoints. This will help you migrate before the MAPI deprecation by June 2021.
Audience
-
Account owners - anyone with administrative ownership rights over Criteo account.
-
Application owners - team or organization who owns and maintains the code.
If account owner and application owner is the same entity then organization name in the developer portal should be set the same as advertiser name.
Pre-requisites
-
Application owners should complete the on-boarding in our new Developer Portal as indicated in the on-boarding checklist.
-
As per-instructions, once you generate the consent URL share the URL by email, Slack or any other means with the account owner - Advertiser, Brand or Publisher.
-
Application owners and account owners should get familiar with the versioning policy document. Versioning policy ensures adherence to industry standard of software development in regards to controlling feature upgrades and deprecations.
Authorization
Once account owner (e.g Account Administrator) receives and clicks on the consent link, they will be redirected to the Criteo Consent Portal where they can provide you the requested authorization levels for the accounts in their portfolio.
Endpoints parity
Below, you can see the Criteo API's equivalent for your MAPI endpoints. The column "Versioning" indicates whether the endpoint complies to versioning policy or not. In other words, whether the endpoint will evolve (marked as "Y") or stay the same (marked as "N") from the perspective of adding new features. This document will be kept up-to-date and serve as a quick reference during the migration.
| Type | MAPI | Criteo API | Description | Versioning policy |
|---|---|---|---|---|
| POST | /v1/statistics ReportType: CampaignPerformance | /2020-10/statistics/report This endpoint contain breaking changes. Please follow the migration instructions here. | Retrieve advertiser performances reports. | Y |
| POST | /v1/statistics ReportType: TransactionID | /2020-10/transaction/report This endpoint contain breaking changes. Please follow the migration instructions here. | Retrieve advertiser performances reports. | Y |
| GET | /v1/portfolio | /legacy/marketing/v1/portfolio | Retrieve your AudienceID(s) | N |
| GET | /v1/advertisers/{advertiserId}/campaigns | /legacy/marketing/v1/advertisers/{advertiserId}/campaigns | Retrieve your campaign(s) and categories for a specific advertiser | N |
| GET | /v1/advertiser/{advertiserID}/categories | /legacy/marketing/v1/advertiser/{advertiserID}/categories | Retrieve your campaign(s) and categories for a specific advertiser | N |
| GET | /v1/advertiser/{advertiserID}/categories/{categoryHashCode} | /legacy/marketing/v1/advertiser/{advertiserID}/categories/{categoryHashCode} | Retrieve specific categories for a specific advertiser | N |
| GET | /v1/audiences | /legacy/marketing/v1/audiences | Import the list of audiences | N |
| POST | /v1/audiences/userlist/ | /legacy/marketing/v1/audiences/userlist/ | Create an audience | N |
| PUT | /v1/audiences/{audienceId} | /legacy/marketing/v1/audiences/{audienceId} | Change an audience metadata | N |
| PATCH | /v1/audiences/userlist/{audienceId} | /legacy/marketing/v1/audiences/userlist/{audienceId} | Add/Remove users to an audience | N |
| DELETE | /v1/audiences/userlist/{audienceId}/users | /legacy/marketing/v1/audiences/userlist/{audienceId}/users | Remove all users from an audience | N |
| DELETE | /v1/audiences/{audienceId} | /legacy/marketing/v1/audiences/{audienceId} | Delete an audience | N |
| GET | /v1/budgets | /legacy/marketing/v1/budgets | Retrieve budget(s) for your portfolio | N |
| GET | /v1/campaigns/ | /legacy/marketing/v1/campaigns/ | Retrieve campaign(s) for your portfolio | N |
| GET | /v1/campaigns/{campaignId} | /legacy/marketing/v1/campaigns/{campaignId} | Retrieve your campaign and categories for a specific campaign | N |
| GET | /v1/campaigns/{campaignId}/categories | /legacy/marketing/v1/campaigns/{campaignId}/categories | Retrieve your campaign and categories for a specific campaign | N |
| GET | /v1/campaigns/{campaignId}/categories/{categoryHashCode} | /legacy/marketing/v1/campaigns/{campaignId}/categories/{categoryHashCode} | Retrieve specific campaign categories of your portfolio | N |
| GET | /v1/campaigns/bids | /legacy/marketing/v1/campaigns/bids | Retrieve your bid(s) for your portfolio | N |
| PUT | /v1/campaigns/bids | /legacy/marketing/v1/campaigns/bids | Set new bid values to your campaign or campaign categories | N |
| GET | /v1/categories | /legacy/marketing/v1/categories | Retrieve categories for your portfolio | N |
| PUT | /v1/categories | /legacy/marketing/v1/categories | Enabled or disabled categories | N |
| POST | /marketing/oauth2/token | /oauth2/token | Authentication endpoint. Note, expire_in parameter has been increased from 300 to 900 thus allowing bearer token to live longer than previously. In addition, Criteo API authentication endpoint strictly adheres to OAuth standard. This means that invalid headers, json header with form body will be rejected. | Not applicable |
Updated over 3 years ago