Open navigation

Criteo: Permissions guide

This guide will walk you through how to to create Criteo's credentials.

Criteo's documentation

To create Criteo's credentials: app and API keys we suggest following the Criteo onboarding guide.

Instructions


Step 1: Create a Criteo app and API keys
  1. Log in to Criteo.
  2. In the bottom right corner, click Developer portal.
  3. Click Create to open the app project creation page.
  4. Give your app a meaningful name and description.
  5. Click Create app. This will open the configuration page for your new app.
  6. Select the "Client credentials" authentication method.
  7. Scroll down to the Service section. Make sure that Marketing solutions is selected.
    If you're connecting to Criteo Retail Media, select Retail Media.
  8. Click Save.
  9. Scroll down to the Authorization section. Set every option to Read or above.
    Without these permissions, your queries will fail. Learn more about how we secure the data you process with us.
  10. Click Save.
  11. Scroll back up to the App credentials section.
  12. Click Create new key. This will download a text file to your browser.
  13. Open the text file to access your client_id and client_secret values. You’ll need these to connect Criteo to Supermetrics.
    Protect these credentials — they’re like your username and password for Criteo, so guard and protect them the way you would any other privileged credentials.
  14. Scroll back up to the top of the page and click Activate app.
  15. Click Activate to confirm.
Step 2: Generate consent links

Next, you’ll need to generate consent URLs so advertisers you’ll be reporting on will have approved access. 

  1. Log in to Criteo.
  2. In the bottom right corner, click Developer portal.
  3. Click the app you created in Step 1: Create a Criteo app and API keys.
  4. Click Generate new URL in the top-right corner. If you don’t see this option, or if it’s grayed out, it means not all app setup steps were completed — go through them again to double-check that they were all completed.
  5. Copy the URL.
  6. Send it to the person who manages the Advertiser you want to report on.


About consent URLs

When you send the consent URL to the person who manages the Advertiser you want to report on, note that:

  • The URL is single-use. It will expire once it’s been clicked.
  • If you manage multiple Advertisers, you’ll need to generate a separate consent URL for each one.
  • 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 an account, Supermetrics won’t be able to report on it.
  • If the Advertiser doesn’t complete the consent form, Supermetrics won’t be able to report on their data.
  • The Advertiser must be an owner of the account to be able to grant consent.
Step 3: Log in to Supermetrics

If you had been using Criteo prior to March 24, 2021, delete your existing logins before proceeding with this step. The old MAPI API keys can sometimes cause issues with the login. 

  1. Open Supermetrics in your destination.
  2. Choose Criteo from the data source options, either in the sidebar or in the Supermetrics pane.
  3. You’ll be prompted to enter your Criteo client ID and client secret. Paste in those values from the text file you downloaded in Step 1: Create a Criteo app and API keys.
  4. Click Start.


Once this is done, you’re ready to create your first Supermetrics query with Criteo.

Did you find it helpful? Yes No

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