Accessing Criteo

Before you can start requesting data from Criteo with Supermetrics, there's a couple of steps you need to take to get the right credentials to access their REST API.


IMPORTANT - Please note that these steps have been updated on March 24th, 2021 to use their newer API, the older instructions/Keys for MAPI no longer work. If you encounter issues with your previously valid API key, such as authentication errors or permissions errors for certain data, please follow these instructions to create a new app and API key.


In short, you will need to create an App with Criteo to obtain your Client ID and Client Secret. Then generate consent URLs for your advertisers to approve access to the App. And finally, use those details to log in to the Supermetrics Criteo data source.


Quick links:


Creating Your Criteo App and API Keys

  1. Go to https://account.criteo.com/ and log into your account.
  2. Click the Developer Portal card in the bottom right corner.
  3. In the top-right, click the Create a new app button.

    Image shows example top-right corner of the Criteo UI, with orange button with with text to "Create a new app"

  4. This will take you to the page to set up an app project necessary for API access.
  5. Give your app a meaning Name and Description.
  6. Click Create App to proceed.

    Page for created a new app project, with text fields for the Name, Description, and a possible image file to show. Has an orange button with white text at the bottom to "Create app"

  7. You will then be redirected to the configuration page for your app.
  8. Scroll down to the "Service" section. Make sure that "Marketing solutions" is selected and click Save.

    Orange arrow points to highlighted "Marketing solutions" option. This is selected with an orange dot in the radio element.

  9. Then scroll down to the "Authorization section". Set every option to at least "Read". This is the minimum required access Supermetrics will need to get the data, and failure to give all at least read-access could cause queries to fail. Click Save.

    Orange boxes highlight the Authorization drop-downs, which have all been set to "Read".

  10. Scroll back up to the "App credentials" section. Click Create new key.

    Orange arrow points to the white box with black text for "Create new key"

  11. This will generate a new text file that the browser will download. Please open this to get your client_id and client_secret values that will be required to log into Supermetrics Criteo data source. 

    Store these carefully as they will be required to get access to the API.

    Important - These are like your username and password to Criteo, guard them as you would any login credentials!

  12. Finally, scroll back up to the top of the page and click Activate app

    In the top-right corner of the app page is the orange button with white text to "Activate app", which will finish the setup process

  13. It will have a confirmation pop-up. Click Activate to confirm and finish the app setup process. 

    Confirmation pop-up to activate your app. Pressing the orange button with the white text "Activate" will complete the setup.

  14. Next you will need to generate consent URLs so those advertisers you will be reporting on will have approved access. Proceed to the Generating Consent Links for Advertisers section below.

If you need additional information about setting up an app in Criteo, please see their official documentation.

Generating Consent Links for Advertisers

  1. If not there already, go to https://account.criteo.com/ and log into your account. Go to the developer portal.
  2. Click on the app created in the previous steps to open the "Application details".
  3. In the top-right corner you should now see the button to Generate new URL.
    • If you do not see this, or the button is greyed out, not all of the app setups steps were completed. Review the steps in the Creating Your Criteo App and API Keys section above to make sure all was completed.
  4. Click the Generate new URL button. This will generate a single-use consent URL for your advertiser to approve.

  5. Please copy and send that URL to the person who manages the Advertiser you wish to report on. They will need to click on that link and follow the instructions. Note that:
    • The URL is single-use. It will expire once clicked.
    •  If you manage multiple Advertisers, you will need to generate a separate consent URL for each to complete.
    • The Advertiser will get the option to decide which portfolios they want to expose to your app as part of the consent process. If they don't add specific accounts, Supermetrics will not be able to report on them.
    • If the Advertiser does not complete the consent form, Supermetrics will not be able to report on their data.
  6. Once the Advertiser(s) have completed the consent form from the URL, you should now be ready to log into the Supermetrics Criteo data source!

For more information about the Consent URL process, please see the official Criteo documentation.

Logging into Supermetrics

  1. If you had been using Criteo prior to March 24th, 2021, you will want to first delete your existing logins before proceeding as the old MAPI API keys can sometimes cause issues with the login. If you have never used Criteo before, you can skip to step 2 
  2. Go to your Supermetrics product that supports Criteo and select the data source from the options.
  3. A window should appear asking for the Criteo Client ID and Criteo Client secret. Fill in those values based on the text file obtained in the Creating Your Criteo App and API Keys section above.Example login window for Criteo for Supermetrics. It shows two text fields, one for "Criteo client ID" and one for "Criteo client secret" which will take the values gotten during the app setup
  4. Click START to begin authentication. If it was successful, it will either give a confirmation or redirect back to the product.

  5. You should now be able to select your advertiser account and continue crafting a query.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.