Criteo Connector Setup Guide
This article describes how to set up the Criteo connector.
Connector Actions
Action Name | AudienceStream | EventStream |
---|---|---|
Send Event | ✓ | ✓ |
Configure Settings
Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.
After adding the connector, configure the following settings:
- Client Account ID
Required: This is the Client ID in Criteo.
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.
Automatic Deduplication
Use the Automatic Deduplication action to send a unique identifier generated from your Criteo OneTag tag with the event dataset. Ensure that you have enabled Generate Page View ID in your Criteo OneTag tag configuration. The event attribute uses the following naming convention:
criteo_page_view_id_<Tag ID>
For example: criteo_page_view_id_32
To configure automatic deduplication, in the Automatic Deduplication section, select Add Mapping. In the mapping, provide the Criteo OneTag tag ID and map it to the Tealium iQ Tag ID.
You can find your Criteo OneTag tag ID in the Tags screen in the UID column.
After you configure automatic deduplication, Tealium automatically looks for the Criteo page view ID being sent from Tealium iQ and adds it to the event payload for deduplication.
Action - Send Event
Event Type
Parameter | Description |
---|---|
Event Type | The standard web, travel, or store event to send. For more information, see Criteo Server to Server - Event Payloads. |
Standard Parameters
Criteo highly recommends mapping IP Address, Full URL, and User Agent for most accurate data collection.
Parameter | Description |
---|---|
Account | The partner ID of the account you are sending the data to. It can be filled on the connector configuration screen or on the action screen. The value on the action screen has higher priority than on the connector configuration screen. |
Site Type | The device type (or site version) used for browsing. Default option is desktop . Available values are d (for Desktop), t (for Tablet), m (for Mobile). |
Full URL | The full url where the event is triggered. |
Previous URL | The previous url where the event is triggered. |
IP | The IP address of the user. |
User Agent | The user agent string from the users browser. |
Retailer Visitor ID | A unique ID that is consistent across multiple sessions for an unauthenticated user. For example, First-party cookie ID. |
User Identifiers
Criteo recommends mapping both a Mapped User ID and email where possible. Providing an email address allows for cross-device attribution when available and may enable addressing events without a Mapped User ID.
Parameter | Description |
---|---|
GUM ID | The Criteo salted user ID (GUM ID) returned by the GUM call. For more information, see Criteo Server to Server - Criteo GUM Call. |
GAID | Google’s advertising identifier. |
IDFA | Apple’s identifier for Advertisers unique identifier. |
Email Raw | The user’s raw email address. Will use the first non-empty value of email. |
Email MD5 (apply MD5 hash) | The user’s unhashed email address. |
Email MD5 (already MD5 hashed) | The user’s email address hashed with MD5. |
Email SHA256 (apply SHA256 hash) | The user’s unhashed email address. |
Email SHA256 (already SHA256 hashed) | The user’s email address hashed with SHA256. |
Email SHA256 MD5 (apply SHA256 MD5 hash) | The user’s unhashed email address. |
Email SHA256 MD5 (already SHA256 MD5 hashed) | The user’s email address hashed with MD5 and SHA256. |
Event Parameters
Parameter | Description |
---|---|
ID | The order ID used to identify a given order. |
Item (Top 3 Products) | An array of the top 3 products on the listing page a user visited. |
Item (Product Id) | The product ID of the product the user looked at. |
Items Id (String or Array) | The product ID, the unit price, the quantity of the products in the cart. Values could be string with comma (","), separation, or array. |
Items Price (String or Array) | The unit price of the products in the cart. Values could be string with comma (","), separation, or array. |
Items Quantity (String or Array) | The quantity of the products in the cart. Values could be string with comma (","), separation, or array. |
Items Price (Tail) | Tally or a string attribute containing a valid JSON map of item ID(s) to number values. For example, {"PID1":1.99,"PID2":3.99} . For each tally configured, ensure the item ID is used as the tally key and the property value as the tally value. |
Items Quantity (Tail) | Tally or a string attribute containing a valid JSON map of item ID(s) to number values. For example, {"PID1":1.99,"PID2":3.99} . For each tally configured, ensure the item ID is used as the tally key and the property value as the tally value. |
Currency | The ISO code of the currency being passed to the tags. |
Timestamp | The timestamp the event happened for the user in ISO 8601 UTC format YYYY-MM-DDThh:mm:ssZ . If no timestamp is provided, the current timestamp will be used. |
Checkin Date | The check-in date the user submitted in format YYYY-MM-DD . |
Checkout Date | The check-out date the user submitted in format YYYY-MM-DD . |
NBRA | The number of adults searched for. |
NBRC | The number of children searched for. |
NBRI | The number of infants searched for. |
NBRR | The number of rooms searched for. |
Store Id | The store ID as passed to us in the feed. |
Store Ids | The store ID as passed to us in the feed. This is an array for stores with the product available. |
DD | Populate this with a 1 if you want the sale to be attributed to Criteo or a 0 if you do not. The sale will be attributed to Criteo only if the order should have been attributed to criteo through normal attribution. |
Category | The category of the listing page. |
Keyword | The searched keyword of the search listing page. |
Automatic Deduplication
When the Tealium iQ tag ID is provided, we will automatically look for the Event ID value that is sent from Tealium iQ.
This page was last updated: December 6, 2021