Criteo Audience Match Connector Setup Guide

[#1]

This article describes how to set up the Criteo Audience Match connector.

Deprecated Version
The previous version of this connector was named "Criteo Audience Match (Customer-Provided Credentials)" and was integrated with the Criteo Marketing API (MAPI), which is planned for deprecation. That connector has been deprecated and the name changed to "Criteo Audience Match (Deprecated Marketing API v1)".
Current Version
The current connector is named "Criteo Audience Match" and is integrated with the Criteo API that was released in January 2021. Read more about migrating from MAPI to Criteo API:
Criteo: Sample Migration Plan
Criteo: Marketing API Migration Guide

In this article:

• Connector Actions
• API Information
• Batch Limits
• Configure Settings
• Request Consent Link from Criteo
• Add Connector and Configure Settings
• Action Settings - Parameters and Options
• Action - Add User to Audience
• Action - Remove User from Audience

Connector Actions

Action Name	AudienceStream	EventStream
Add User to Audience	✓	✓
Remove User from Audience	✓	✓

API Information

This connector uses the following vendor API:

• API Name: Criteo API
• API Version: 2021-07
• API Endpoint: https://api.criteo.com/2021-01/audiences
• Documentation: Criteo Audiences API

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met:

• Max number of requests: 50000
• Max time since oldest request: 15 minutes
• Max size of requests: 10 MB

Configure Settings

Request Consent Link from Criteo

If you intend to use this connector, send an email to asintegrations@tealium.com to receive a consent link that authorizes the Tealium Customer Data Hub to manage audiences on behalf of advertisers. Learn more from Criteo Developers: Send an Authorization Request to Your Users.

This step may take up to three (3) working days for approval.

After receiving the Criteo activation link, complete the following steps:

1. Click the activation link provided.
   You are directed to the Criteo Consent Portal.
2. Grant the requested authorization levels for the account.

Add Connector and Configure Settings

Go to the Connector Marketplace and add the Criteo Audience Match connector to your profile. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

• Advertiser ID (Required)
  Configure the Advertiser ID associated with an integration in your Criteo account

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Add User to Audience

Parameters

Parameter	Description
Audience	Select an audience to add user to or provide an Audience ID directly.
Email	Send email value as-is without applying built-in hashing. Select this option if value requires no hashing or is already hashed.
Email (apply MD5 hash)	Hash email value with MD5 before sending.
Email (apply MD5 SHA256 hash)	Hash email value with MD5 and then SHA256 before sending.
Mobile ID	IDFA mobile ID for Apple. ADID mobile ID for Android.
Identity Link	Identity Link
Gum ID	Identifier obtained from cookie matching. A corresponding Gum Caller ID is automatically added to the request.

Action - Remove User from Audience

Parameters

Parameter	Description
Audience	Select an audience to remove a user from or provide an Audience ID directly.
Email	Send email value as-is without applying built-in hashing. Select this option if value requires no hashing or is already hashed.
Email (apply MD5 hash)	Hash email value with MD5 before sending.
Email (apply MD5 SHA256 hash)	Hash email value with MD5 and then SHA256 before sending.
Mobile ID	IDFA mobile ID for Apple. ADID mobile ID for Android.
Identity Link	Identity Link
Gum ID	Identifier obtained from cookie matching. A corresponding Gum Caller ID is automatically added to the request.