Criteo Connector Setup Guide

[#1]

This article describes how to set up the Criteo connector.

In this article:

• Connector Actions
• Configure Settings
• Action Settings - Parameters and Options
• Action - Homepage Event
• Action - Listing Event
• Action - Product Event
• Action - Cart Event
• Action - Conversion Event
• Action - Search Event

Connector Actions

Action Name	AudienceStream	EventStream
Homepage Event	✓	✓
Listing Event	✓	✓
Product Event	✓	✓
Cart Event	✓	✓
Conversion Event	✓	✓
Search 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.

Action - Homepage Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.

Action - Listing Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.
Item ID(s) to Set	Required: Set a list of item IDs. Passing of both lists or single attributes are supported.

Action - Product Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.
Item ID	Required: Set the item ID. Map single or array type attribute.

Action - Cart Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.
Item Quantity	(Required)
Item Price	(Required)

Action - Conversion Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Deduplication
New Customer
Transaction ID
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.
Item Quantity	(Required)
Item Price	(Required)

Action - Search Event

Parameters

Parameter	Description
Criteo ID/Encrypted User ID	Required: This is the same as the user_id from the sync end-point
Site Type	Optional: The device type (or site version) used for browsing. Default option is "desktop".
Dynamic Site Type	Optional: The dynamic value of the device type (or site version) parameter. Note: Setting this field will overwrite the existing value. Attribute must contain one of the following: d (for Desktop) t (for Tablet) m (for Mobile)
Event Data to Set	Optional: Map parameter value(s) to parameter key(s). Use this to collect additional information on this event.
Search Data to Set	Optional: Map parameter value(s) to parameter key(s). Set this when you want to alert Criteo of some event that is not tied to a specific action or product (i.e. life-time value of a user).