Introduction

What is OneTag?The Criteo OneTag is a code snippet to embed in your website’s source code or tag management system. It measures and analyzes user interactions on your site. It also loads asynchronously, ensuring no impact on site performance or customer experience.

Integration Flow

The diagram below illustrates the integration flow for OneTag Offsite. The process has three main phases: preparation (mostly on Criteo’s side), technical integration (involving both parties) and the “Go live”, which is the campaign’s activation.

808fa5757a744f229eb4cd9ac0aa60e371dc421f0f148ed71f08f88d5e5efb3e Copy_of_Criteo_RM_Integration_timeline_1

Common Parameters

There are some common parameters which are shared between all the tags:

Event	Key	Example value	Description
`setAccount`	account	`12345`	Your Criteo Account or Partner ID, provided by your technical contact, to route data to Criteo servers.
`setRetailerVisitorId`	id	`0193553C0A39937F23FC`	A unique, unauthenticated user ID valid for at least 30 days. Used to track visitor behavior across sessions. Typically retrieved via a first-party cookie.
`setCustomerId`	id	`1SDFJI435FH12HFK2`	A consistent, internal ID for logged-in users, linked to accounts, purchase history, or membership programs.
`setEmail`	email	`d9c37700(…)18be88`	User’s email address in SHA256 hash format. Please pass an empty string if the user’s email is unavailable.

Tags

Dynamic Loader

To load the Criteo JavaScript library and ensure the loader is included across all pages, make sure to insert the following script in the head of your site. Also don’t forget to replace the placeholder with your unique Criteo Partner ID:

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

Homepage Tag

Trigger this tag on the homepage (http://www.retailer.com). Substitute all placeholders with actual values.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Homepage Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { event: "viewHome" }
    );
</script>
<!-- END Criteo Homepage Tag -->

Listing Tag

Trigger this tag on all category pages (e.g., https://www.retailer.com/shopping/men) or search result pages. Substitute all placeholders with actual values.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Listing Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { 
            event: "viewList", 
            item: [
                "123", // First item ID
                "456", // Second item ID
                "789"  // Third item ID
            ] 
        }
    );
</script>
<!-- END Criteo Listing Tag -->

Product Tag

Use this tag on product pages (e.g., https://www.retailer.com/shopping/product-jacket-123456). Substitute all placeholders with actual values. For availability, insert boolean value 0 for out of stock, 1 for in stock.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Product Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { event: "viewItem", item: "ABC123", price: 19.99, availability: 1 } // Product ID for the viewed item
    );
</script>
<!-- END Criteo Product Tag -->

Add-to-Cart Tag

Trigger this tag when an item is added to the cart. Substitute all placeholders with actual values.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Add-to-cart Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { 
            event: "addToCart", 
            item: [
                {
                    id: "ABC123", // Product ID
                    price: "49.99", // Product price
                    quantity: "2" // Quantity added to the cart
                }
            ]
        }
    );
</script>
<!-- END Criteo Add-to-cart Tag -->

Basket Tag

Use this tag on the basket page (https://www.retailer.com/basket). Substitute all placeholders with actual values, ensuring prices are the singular unitary price of each item.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Basket / Cart Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { 
            event: "viewBasket", 
            item: [
                {
                    id: "ABC123", // Product ID
                    price: "49.99", // Product price
                    quantity: "2" // Quantity in the basket
                },
                {
                    id: "XYZ789", // Product ID for another item
                    price: "19.99", // Product price
                    quantity: "1" // Quantity in the basket
                }
                // Add a new object for each additional item in the cart
            ]
        }
    );
</script>
<!-- END Criteo Basket / Cart Tag -->

Conversion Tag

Trigger this tag on the “Thank You” page post-purchase. Substitute all placeholders with actual values, ensuring prices are the singular unitary price of each item.

<!-- Criteo Loader File -->
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a=#####" async></script>
<!-- END Criteo Loader File -->

<!-- Criteo Conversion Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    window.criteo_q.push(
        { event: "setAccount", account: "12345" }, // Your partner ID
        { event: "setEmail", email: "d9c378bb0369ee148f7700fc296165d4e8dc356b90ac318be3701ee76f00c588", hash_method: "sha256" }, // User's SHA-256 hashed email
        { event: "setCustomerId", id: "1SDFJI435FH12HFK2" }, // User's logged-in ID
        { event: "setRetailerVisitorId", id: "0193553C0A39937F23FC" }, // User's guest ID
        { 
            event: "trackTransaction", 
            id: "TRX12345", // Transaction ID
            item: [
                {
                    id: "ABC123", // Product ID
                    price: "49.99", // Product price
                    quantity: "2" // Quantity purchased
                },
                {
                    id: "XYZ789", // Product ID for another item
                    price: "19.99", // Product price
                    quantity: "1" // Quantity purchased
                }
                // Add a new object for each additional purchased item
            ]
        }
    );
</script> 
<!-- END Criteo Conversion Tag -->

Start here

Feed & Product Data

Requesting Ads

AD Rendering

AD Tracking

Commerce Video

QA checklists

OneTag JavaScript

Google Ad Manager (GAM)

OneTag for Retail Media Offsite

Introduction

Integration Flow

Common Parameters

Tags

Dynamic Loader

Homepage Tag

Listing Tag

Product Tag

Add-to-Cart Tag

Basket Tag

Conversion Tag

​Introduction

​Integration Flow

​Common Parameters

​Tags

​Dynamic Loader

​Homepage Tag

​Listing Tag

​Product Tag

​Add-to-Cart Tag

​Basket Tag

​Conversion Tag

Introduction

Integration Flow

Common Parameters

Tags

Dynamic Loader

Homepage Tag

Listing Tag

Product Tag

Add-to-Cart Tag

Basket Tag

Conversion Tag