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
- Log in to Criteo.
- In the bottom right corner, click Developer portal.
- Click Create to open the app project creation page.
- Give your app a meaningful name and description.
- Click Next. Select the "Client credentials" authentication method, then click Create.
- On the next page, select C-Growth and Marketing solutions, or if you're connecting to Criteo Retail Media, select C-Max and Retail Media.
- Click Next.
- Set every option to Read (or Manage).
Without these permissions, your queries will fail. Learn more about how we secure the data you process with us. - Click Activate app.
- On the next page, you see the App credentials section.
- Click Create new key. This will download a text file to your browser.
- 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.
Step 2: Generate consent links
Next, you’ll need to generate consent URLs so advertisers you’ll be reporting on will have approved access.
- Log in to Criteo.
- In the bottom right corner, click Developer portal.
- Click the app you created in Step 1: Create a Criteo app and API keys.
- 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.
- Copy the URL.
- 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.
- Open Supermetrics in your destination.
- Choose Criteo from the data source options, either in the sidebar or in the Supermetrics pane.
- 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.
- Click Start.
Once this is done, you’re ready to create your first Supermetrics query with Criteo.