Skip to main content
New authentication requiredCriteo 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.