Here is a list of configurable variables in the container.

Partner ID

Variable Name	Criteo - Partner ID
Variable Type	Constant
Variable Value	[Dynamic value from partnerId]

Email
In order to use Criteo's cross-device capabilities, we require that you pass your users' emails to the Criteo tags.

Variable Name	Criteo - Email (Plain Text)
Variable Type	Data Layer Variable
Variable Value	<Plain Text Email Variable Data Layer Path>
Set Default Value	Enabled
Default Data Layer Variable Name	user_email_plan_text
Default Value	(empty)
Comment	If the variable in your data layer is different than user_email_plan_text change it according to your variable

Variable Name	Criteo - Email (MD5)
Variable Type	Data Layer Variable
Variable Value	<MD5-hashed Email Variable Data Layer Path>
Set Default Value	Enabled
Default Data Layer Variable Name	user_email_md5
Default Value	(empty)
Comment	If the variable in your data layer is different than user_email_md5 change it according to your variable

Variable Name	Criteo - Email (SHA256)
Variable Type	Data Layer Variable
Variable Value	<MD5-hashed Email Variable Data Layer Path>
Set Default Value	Enabled
Default Data Layer Variable Name	user_email_sha256
Default Value	(empty)
Comment	If the variable in your data layer is different than user_email_sha256 change it according to your variable

Criteo - Ecommerce – Items
Data Layer event variable that captures product details on the listing, basket, and purchase pages.

Variable Name	Criteo - Ecommerce - Items
Variable Type	Data Layer Variable
Variable Value	`[` `{` `'item_id': '##ProductID_1##',` `'item_category': '##Category Name 1##',` `'item_category2': '##Category Name 2##',` `'item_category3': '##Category Name 3##',` `'item_category4': '##Category Name 4##',` `'item_category5': '##Category Name 5##',` `}` `]`
Set Default Value	Enabled
Default Data Layer Variable Name	criteo.ecommerce.items
Default Value	(empty)
Comment	If the variable in your data layer is different than `criteo.ecommerce.items` change it according to your variable This variable expects an array of objects representing the information about individual products on the listing page If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer we would need: Listing Page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_listing',` `'criteo.ecommerce': {` `'items': [` `{` `'item_id': 'ProductID_1'` `},` `{` `'item_id': 'ProductID_2'` `},` `{` `'item_id': 'ProductID_3'` `}` `]` `}` `});` `</script>` Add to Cart: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_addtocart',` `'criteo.ecommerce': {` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Basket page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_checkout',` `'criteo.ecommerce': {` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Purchase page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_purchase',` `'criteo.ecommerce': {` `'transaction_id': '7654322',` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>`

Criteo - Listing IDs
This variable is used to retrieve the first 3 product IDs from the listing page.

Variable Name	Criteo - Listing IDs
Variable Type	Custom JavaScript
Value Example	['ProductID_1','ProductID_2','ProductID_2']
Custom JavaScript	`function () {` `var listingIds = [];` `var items = {{Criteo - Ecommerce - Items}} \|\| [];` `listingIds = items.slice(0,3).map(function(i){` `return i.item_id;` `});` `return listingIds;` `}`
Comment	If the variable in your data layer is different than `Criteo - Ecommerce - Items` change it according to your variable This variable expects array of objects representing the information about individual product in the listing page If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer implementation: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_listing',` `'criteo.ecommerce': {` `'items': [` `{` `'item_id': 'ProductID_1'` `},` `{` `'item_id': 'ProductID_2'` `},` `{` `'item_id': 'ProductID_3'` `}` `]` `}` `});` `</script>`

Criteo - Listing Category (Optional)
A custom JS variable that is used to obtain the category information passed from the Data Layer, into the format required by the Criteo Listing Tag.

Variable Name	Criteo – Listing Category
Variable Type	Custom JavaScript
Value Example	'Electronics>Audio>Headphones'
Custom JavaScript	`function () {` `var category_attributes = ["item_category", "item_category2", "item_category3"];` `var items = {{Criteo - Ecommerce - Items}} \|\| [];` `if(items.length > 0){` `var categories = [];` `var item = items[0];` `for(var i = 0; i < category_attributes.length; i++){` `var category_attribute = category_attributes[i];` `if(category_attribute in item && item[category_attribute])` `categories.push(item[category_attribute]);` `}` `return categories.join(">");` `}` `}`
Comment	If the variable in your data layer is different than `Criteo - Ecommerce - Items` change it according to your variable. This variable expects an array of objects representing the information about individual products on the listing page. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer implementation: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_listing',` `'criteo.ecommerce': {` `'items': [{` `'item_id': 'ProductID_1',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Apple',` `},` `{` `'item_id': 'ProductID_2',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Apple',` `},` `{` `'item_id': 'ProductID_3',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Huawei',` `},` `]` `}` `});` `</script>`

Criteo – Keywords (Optional)
Data Layer variable that can be used by the advertiser to map keywords used by a user when searching for products on the site, so they can be added to a Listing Tag.

Variable Name	Criteo - Keywords
Variable Type	Data Layer Variable
Variable Example	'wireless headphones'
Set Default Value	Enabled
Default Data Layer Variable Name	keywords
Default Value	(empty)
Comment	If the variable in your data layer is different than `keywords` change it according to your variable. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer implementation: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_listing',` `'keywords': 'wireless headphones',` `'criteo.ecommerce': {` `'items': [{` `'item_id': 'ProductID_1',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Apple',` `},` `{` `'item_id': 'ProductID_2',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Apple',` `},` `{` `'item_id': 'ProductID_3',` `'item_category': 'Electronics',` `'item_category2': 'Audio',` `'item_category3': 'Headphones',` `'item_category4': 'Wireless',` `'item_category5': 'Huawei',` `},` `]` `}` `});` `</script>`

Criteo - Ecommerce - Item ID
This variable is used to retrieve the product ID from the Data Layer on the product page.

Variable Name	Criteo - Ecommerce - Item ID
Variable Type	Data Layer Variable
Value Example	'ProductID_1'
Set Default Value	Enabled
Default Data Layer Variable Name	criteo.ecommerce.items.0.item_id
Default Value	(empty)
Comment	If the variable in your data layer is different than `criteo.ecommerce.items.0.item_id` change it according to your variable, make sure that the returned value is a string representing product id. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer implementation: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_product',` `'criteo.ecommerce': {` `'items': [` `{` `'item_id': 'ProductID_1',` `}` `]` `}` `});` `</script>`

Criteo - Ecommerce – Currency
Data Layer variable that captures the currency code. The ISO code of the currency used.

Variable Name	Criteo - Ecommerce - Currency
Variable Type	Data Layer Variable
Value Example	'USD'
Set Default Value	Disabled
Default Data Layer Variable Name	criteo.ecommerce.currency
Default Value	(empty)
Comment	If the variable in your data layer is different than `criteo.ecommerce.currency` change it according to your variable, make sure that the returned value is an ISO code string representing currency code. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer we would need for: Add to Cart: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_addtocart',` `'criteo.ecommerce': {` `'currency': 'USD,` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Basket page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_checkout',` `'criteo.ecommerce': {` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Purchase page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_purchase',` `'criteo.ecommerce': {` `'transaction_id': '7654322',` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>`

Criteo - Ecommerce - Transaction ID
Data Layer variable that stores the unique transaction ID of the sale conversion.

Variable Name	Criteo - Ecommerce – Transaction ID
Variable Type	Data Layer Variable
Value Example	'ord-1234'
Set Default Value	Enabled
Default Data Layer Variable Name	criteo.ecommerce.transaction_id
Default Value	(empty)
Comment	If the variable in your data layer is different than `criteo.ecommerce.transaction_id` change it according to your variable, make sure that the returned value is a string representing the transaction ID. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer we would need: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_purchase',` `'criteo.ecommerce': {` `'transaction_id': '7654322',` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>`

Criteo – Items
A custom JS variable is used to capture product information and format it into Criteo’s required tag syntax.

Variable Name	Criteo - Items
Variable Type	Custom JavaScript
Value Example	`[` `{` `"id": "ProductID_1",` `"price": 51,` `"quantity": 1` `},` `{` `"id": "ProductID_2",` `"price": 21,` `"quantity": 2` `}` `]`
Custom JavaScript	`function(){` `var items = [];` `var ecommerce_items = {{Criteo - Ecommerce - Items}} \|\| [];` `items = ecommerce_items.slice().map(function(product){` `return {` `id: product.item_id,` `price: parseFloat(product.price),` `quantity: product.quantity` `};` `});` `return items;` `}`
Comment	If the variable in your data layer is different than `criteo.ecommerce.items`, change it according to your variable, make sure that the returned value is an array of objects. If you are missing the required Data Layer variable and you’re not passing any of that information, here is the minimum data layer we would need for: Add to Cart: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_addtocart',` `'criteo.ecommerce': {` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Basket page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_checkout',` `'criteo.ecommerce': {` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>` Purchase page: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_purchase',` `'criteo.ecommerce': {` `'transaction_id': '7654322',` `'currency': 'USD',` `'items': [` `{` `'item_id': 'ProductID_1',` `'price': '200.99',` `'quantity': 2` `}` `]` `}` `});` `</script>`

Criteo - Post Code (Optional)

Variable name	Criteo - Post Code
Variable type	Data Layer Variable
Variable value	<Zipcode Variable Data Layer Path>
Default Data Layer Variable Name	zipcode
Set Default Value	Enabled
Default Value	(empty)
Comment	If the variable in your data layer is different than `zipcode` change it according to your variable. If you are missing the required Data Layer variable and you’re not passing any of that information, we suggest you to implement that variable within the event object that you push, for example: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_home',` `'zipcode': '12345',` `});` `</script>`

If this variable is not present in your data layer, set it up with the default path "zipcode" and it will always take the default value (empty).

Criteo - Store ID (Optional)
Criteo Data Layer variables are used to map the advertiser’s physical store ID.

Variable Name	Criteo - Store ID
Variable Type	Data Layer Variable
Variable Value	<Store ID Variable Data Layer Path>
Default Data Layer Variable Name	store_id
Set Default Value	Enabled
Default Value	(empty)
Comment	If the variable in your data layer is different than the `store_id` change it according to your variable. If you are missing the required Data Layer variable and you’re not passing any of that information, we suggest you to implement that variable within the event object that you push, for example: `<script type="text/javascript">` `window.dataLayer = window.dataLayer \|\| [];` `window.dataLayer.push({` `'event': 'criteo_home',` `'store_id': 'A734Gd87',` `});` `</script>`

Criteo - Visitor ID (Optional)
A 1st party advertiser cookie which can be passed from the advertiser to Criteo to assist in the identification of referred non-logged-in users.

Variable Name	Criteo - Visitor ID
Variable Type	1st-Party Cookie
Default Data Layer Variable Name	insert_1st_party_cookie_name
Set Default Value	Enabled
Default Value	(empty)
Comment	The following variable requires you to change the Cookie name from insert_1st_party_cookie_name to your data layer variable representing your Visitor ID

Google Tag Manager Implementation

Table of contents

Google Tag Manager Implementation