Criteo

Criteo is an advertising platform that retargets ads to re-engage your customers. Connect it to Marketing to send the audiences you build in Marketing to Criteo for your ad campaigns. Set up the integration, then use the webhook templates to manage who's in each audience.

How the integration works

You can add customers to a Criteo audience or remove them from it, then use that audience in a Criteo ad campaign. You can also create a contact list segment to add customers to or remove them from.

Prerequisites

• A Marketing project with Scenarios and Integration accesses.
• A Criteo Partner Portal account to create the app in.
• Admin permission on the Criteo advertiser account you want to connect.

Set up the integration

Create and activate the app

1. Go to the Criteo developer portal.
2. Select Start building.

3. Enter a Name and Description for the app. Optionally, add a custom logo.

4. Select Client credentials.

5. 

   Select C-Growth and Marketing Solutions.

6. Set the access level for each domain, and give Audiences the Manage permission. Then select Activate app.
7. After you activate the app, select Generate new URL. This creates a consent URL that starts with https://consent.criteo.com/request?.
8. Open the URL in your browser, and log in with an advertiser account that has admin permission.
9. Approve the app for the advertiser accounts you want to connect.

Generate API keys

Select Create new key. This downloads a text file with your client_id and client_secret, which you need in the next step.

Add the OAuth 2.0 integration

To add the OAuth 2.0 Authentication integration:

1. In Marketing, go to Data & Assets > Integrations.
2. Select + Add new integration.

3. Search for OAuth 2.0 Authentication and select + Add integration.

4. Enter the client_id and client_secret from your API key file, and enter https://api.criteo.com/oauth2/token as the Token endpoint.
5. Test the integration, then select Save integration.

Use webhook templates

You'll find two Criteo webhook templates in Marketing scenarios. To access them, open a scenario and go to Actions > Other.

Create audiences

This template is for one-time use, so don't connect it to trigger nodes or conditions.

1. Enter a Contact List Name and Segment Name. They can be the same.
2. Enter your Advertiser ID.
3. Select Test webhook.

The success response is a JSON object that includes the Contact List ID. You'll need it for the next template.

Add or remove customers from audiences

Use this template to add customers to an audience or remove them from it. Enter the Contact List ID in the Criteo Audience ID field, then select add or remove.

Limitations

Rate limits

Criteo's Marketing Solutions API allows up to 250 requests per minute per app. Learn more in Criteo's rate limits documentation.

The Marketing webhook preset sends one identifier per request, so each request covers one customer.

API keys

You can only add customers to or remove them from audiences created with the same API keys.