Criteo OneTag Setup Guide for Tealium iQ Tag Management

[#1]

This article is a step-by-step guide for installing the Criteo OneTag in your Tealium iQ profile.

In this article:

• Tag Configuration
• Load Rules
• Data Mappings
• Vendor Documentation

Tag Configuration

Go to the Tag Marketplace and add the Criteo OneTag to your profile (see Adding a Tag).

After adding the tag, configure the following settings:

1. Title: The default title is "Criteo OneTag". You have the option to replace it with a descriptive name.
2. Account (Required): Enter your Criteo account number. If you have more than one account, you may enter multiple account numbers as a comma-separated list.
   

   You may override or dynamically set this value using the Tag's Data Mappings tab (more on this below).

Load Rules

Load Rules determine when and where to load an instance of Criteo OneTag on your site.

Create custom Load Rules to load the tag on any page where you want trigger Criteo Events. For example, if you are tracking conversion events, load this tag on the checkout page or the confirmation page. 

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.

The destination variables for Criteo OneTag are built into the Data Mappings tab. The available destination variables are described in the following sections.

Standard

Tag destination	Description
Account ID	Criteo account number.  Overrides account.
Email (email)	Customer's email address.
Retailer Visitor ID (retailer_visitor_id)	A unique unauthenticated ID that is consistent over multiple sessions on the the same device.
Customer ID (customer_id)	An identifier for an authenticated user that is consistent for all logged in sessions. Criteo requires that this ID not contain personally identifiable information such as names, email addresses, unencrypted phone numbers, etc. Leave it empty if the customer is unknown or your site does not have unique IDs. NOTE: This variable is not related to E-Commerce Extension's _ccustid variable.
Site Type (site_type)	Version of the site. The value can be one of the following: m - The mobile version of your site t - The tablet version of your site d (default) - The classic version of your site. This is often the site that browsers access.
Hashed Email (hashed_email)	Customer's hashed email address.
Zip Code (zip_code)	Customer's zip code.

E-Commerce

Since the Criteo OneTag is e-commerce enabled, it automatically uses the default E-Commerce Extension mappings. Manual mapping destinations in this category is typically only needed in the following situations:

• You need to override any Extension mappings.
• The required ecommerce variable is not offered in the Extension.

Tag Destination	Description
Order ID (order_id)	Unique transaction identifier. Overrides _corder.
Product IDs [Array]	Unique identifier of each product in the product array.  Overrides _cprod.
Product Prices [Array]	Unit price of each product in the product array. Overrides _cprice.
Product Quantities  [Array]	Quantity of each product in the product array. Overrides _cquan.

Events

To trigger Criteo events on a page, map variables to these destinations. The event triggers when the supplied value is found in the Data Layer.

1. Select an event from the Events dropdown list.
2. In the Trigger field, enter the value of the variable being mapped.
3. Click +Add.
4. To map more events, repeat steps 1, 2, and 3.

Event Name	Description
viewHome	Home page viewed.
viewCategory	Product category viewed.
viewSearchResult	Search results viewed.
viewItem	Product viewed.
viewBasket	Cart viewed.
viewList	List of products viewed.
addToCart	Product added to cart.
trackTransaction	Transaction page activity.

Passing Parameters with Events

To pass additional data with the Event destinations you mapped earlier, map variables to the corresponding parameters. If a user has filtered a product list, the filters can be included as parameters.

To pass a parameter with a mapped Criteo event:

1. Select an event from the Events dropdown.
2. Select a parameter from the Parameters dropdown.
3. Click +Add. 

The available parameters and filters vary depending on the selected event, as shown in the following table:

Event	Parameters	Filters
viewHome	Page ID Custom	None
viewCategory viewSearchResult	Item Keyword Category Page Number Page ID Custom	Name Operator Value
viewItem	Item Price Availability Custom	None
viewBasket addToCart	Page ID Custom	ID Price Quantity
viewList	Item Custom	None
trackTransaction	Transaction ID Custom	ID Price Quantity

Vendor Documentation

• Intro to the Criteo OneTag
• Criteo OneTag for Sponsored Products 
• Criteo Support Center (login required)