Criteo Connector Setup Guide | Server-Side Connectors

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.