This article describes how to set up the Criteo connector.
In this article:
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).
|