You are on page 1of 24

Implementing Criteo via Tealium IQ

Criteo Support

12/01/2015

Copyright 2014 Criteo

Content
Criteo Basics

Tag Types
Common Elements

Tealium Basics
Load Rules
Adding Tags
Custom Fields
Adding Email for Cross-Device

Copyright 2014 Criteo


2

Tag Types
Criteo supports the ability to tag users at every stage of their site visit.
Your Criteo support team will send you an integration guide indicating which
tag types youll need to create inside Tealium.
Tag Types include:

Home Page, Listing Page, Product Detail Page


Basket Page, Conversion Page

Want to know which tags youll need to add?

Look for slides in your custom integration guide that mention X tracker

Copyright 2014 Criteo


3

Common Elements
There are many elements that Criteo collects across all the tag types.
Please find below the chart for details.
Element

Description

Mandatory

Account ID

1. This is the client specific ID.


2. You will receive this with the Integration Guide.

Yes

Site Type

1. This indicates where the user is on your Desktop site, Mobile site or
Tablet site.
2. By default, this value is set to "d" for Desktop

Yes

Hashed Email

1. This element allows Criteo to match your users across multiple


devices.
2. This is an MD5 hash of the user's email.
3. While not Mandatory, highly recommended

No

Copyright 2014 Criteo


4

Tealium Basics
Tealium/Criteo integration will require that you do 2 things:
1. Create a tag per page type
You will know which ones in the Integration Guide
2. Create a Load Rule for each page type
This will tell Tealium when to fire each tag that you create

Enable E-Commerce Extensions. This will make getting common ecommerce related data into the Criteo tag much easier.

Copyright 2014 Criteo


5

Tealium Basics
Tealium IQ Login URL: https://my.tealiumiq.com
Criteo has an App in the Tag Marketplace
To add a new Tag, click on
Search for Criteo OneTag

Youll have to create a new tag for each tag type in your custom integration guide

Copyright 2014 Criteo


6

Tealium Basics
To better understand what data elements are available to use on each page,
please make sure you use the Tealium bookmarklet. To add, please create a
bookmark with the url as:

javascript:(function(){if(typeof%20__tealium_tagcompanion=='undefined'){__tealium_tagcompanion
=document.createElement('SCRIPT');__tealium_tagcompanion.type='text/javascript';__tealium_tag
companion.src='//tealium.hs.llnwd.net/o43/utui/utui.tagcompanion.js?v='+Math.random();document.
getElementsByTagName('head')[0].appendChild(__tealium_tagcompanion);}})();

If you use Chrome, you can also use the following extension

https://chrome.google.com/webstore/detail/tealiumtools/gidnphnamcemailggkemcgclnjeeokaa

Copyright 2014 Criteo


7

Tealium Basics
To know what is accessible by the Tag Manager and what is inside the Tealium
DataLayer:
Load the bookmark/plugin from previous slide
Click on Data
Click on Universal Data Layer

Copyright 2014 Criteo


8

Load Rules
Load Rules tell Tealium when a specific tag should fire. For Criteo, we typically
look to fire a specific tag type on a specific page type
i.e. Product Tag on Product Detail Pages

Load rules can be configured separately or during Tag configuration.


For ease of implementation, well walk through how to create load rules up
front.
What youll need:
The list of tags youll be implementing from your Criteo Integration Guide
(See list of possible tag types, pg. 3)

Bookmark/Plugin to see DataLayer

Copyright 2014 Criteo


9

Load Rules
Example: Product Page Tracker
Go to your sites product detail page
Load the Tealium companion and access the
Universal DataLayer
Search for a variable named page_type
*Depending on your specific integration, you may have a different
variable which stores what type of pages you are on.

Create a new Load Rule

Copyright 2014 Criteo


10

Load Rules
1.
2.
3.
4.

Give the rule a good title indicating where it will work


Select the data source variable name (as seen in the previous slide)
Pick the equals comparator
Type in the value seen in the DataLayer in previous step

Copyright 2014 Criteo


11

Adding Tags
Example: Product Page Tags
What your integration guide may look like:

Data needed from Criteo Tags:


Account ID
Event Name

Elements needed from Tealiums DataLayer:


PageType

Copyright 2014 Criteo


12

Adding Tags
Tag Configuration
1. Give it a good title indicating which tag
type this is.
2. Enter Account ID from Integration
Guide
3. Select the Event from the drop-down
This should be the same as what the
integration guide shows

4. Click on Load Rules

* Please note, there is no Event for


Conversion tracking, it will automatically fire
if a transaction_id is available on order
confirmation pages.

Copyright 2014 Criteo


13

Adding Tags
1. Find the Load Rule we previously
created.
2. Select only the one that is
applicable

Copyright 2014 Criteo


14

Adding Tags
Data Mapping is only required if:
The integration guide is asking for
additional data (usually seen via an
event type labeled setData)
Your site has multiple product ids and a
specific one needs to be selected (and it
is not product_id in the DataLayer)

If custom data mapping is required,


see next section

Copyright 2014 Criteo


15

Adding Tags
Congrats! Youve added your tag!
Make sure your tags are On and
ready to be published to the desired
locations.

Publish
Click on the Save/Publish button
Add a meaningful note

Copyright 2014 Criteo


16

Custom Fields
Criteo may request you to pass additional data in the tags or you may need to
override the default values the Criteo App uses.
This can be accomplished in multiple ways depending on the type of data
Lets look at how to do this

Copyright 2014 Criteo


17

Custom Fields
Extra Data from DataLayer/Audience
Stream
If the value you want to pass is already in

the DataLayer, its a simple data mapping


to get this value to Criteo.

1. Edit the tag(s) you want to update to send


2.
3.
4.

5.

the extra data


Click on Data Mapping
Select the Data Source (the value you
want to pass)
Click Select Destination (do not select one
of the listed values, just click Apply)
Type in the value as seen in your custom
integration guide

Copyright 2014 Criteo


18

Custom Fields
Extra Data from JavaScript/Query
Parameters
If the value exists on the page, or the URL,
you can extract it and save it as a
DataLayer variable

1.
2.
3.
4.
5.
6.
7.

Click on DataLayer on the top


Click Add Data Source
Enter the JavaScript variable name
Select the type of data (where is it?)
Enter a meaningful description
Apply
You can now go to the Data Mapping and
select this source.

Copyright 2014 Criteo


19

Adding Email for Cross-Device


Your integration guide may ask you to
pass an email address (plain or hashed)
You can easily do this using the custom
fields from the previous section.
Please note, if you pass in Plain Email,
Criteo does NOT store this value, it will be
hashed (MD5) before being stored

1. Edit the tag(s) you want to update to send


2.
3.
4.
5.

the Email
Click Add Data Source
Select customer_email
Click Select Destination
Select Email or Hashed Email

Copyright 2014 Criteo


20

Adding Email for Cross-Device


If youd prefer to pre-MD5 hash the
value before sending to Criteo, you can
use the Crypto Extension in Tealium.

1.
2.
3.
4.
5.
6.

Click on Extensions (Top nav)


Click Add Extension
Click Add next to Crypto Extension

Add Title
Add Scope (all tags or just Criteo tags)
Select Data Source (where the plain email
is)

7. Update Data Mapping to reflect Hashed


Email
Copyright 2014 Criteo
21

Commonly seen issues


If youre Criteo Engineer reaches out
and informs you that a product id,
prices, etc are not being passed
through in the tags, please ensure your
E-Commerce extension is configured
properly.

1. Click on Extensions (Top nav)


2. Select E-commerce
3. Make sure the product values (marked
with an arrow in the screenshot) are set
to the proper dataLayer element.
4. If they are left as -- not used --, they will
not populate in the Criteo tags.
Copyright 2014 Criteo
22

Advanced Help
If you need additional support, you can reach out to the following:
Tealium Community:
https://community.tealiumiq.com/t5/Developers/Criteo-OneTag/m-p/1532/thread-id/3826
Your Tealium Account Manager
Your Criteo Technical Solutions Engineer

Copyright 2014 Criteo


23

THANK YOU!

Copyright 2014 Criteo

You might also like