CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

This document is a step by step explanation for the implementation of the Criteo Direct solution with Google AdSense.

Summary
1. a. b. c. 2. a. b. 3. 4. Global Explanation ........................................................................................................ 2 How does it work? ..................................................................................................... 2 When Criteo takes the impression ............................................................................... 3 When Criteo gives the impression back ........................................................................ 4 Set up in the Criteo Direct Interface ................................................................................ 5 Explanation .............................................................................................................. 5 Details of the implementation ..................................................................................... 6 Implementation of the Criteo Ad Code ............................................................................. 7 Test the Criteo Implementation ...................................................................................... 8 How to check the integration? ........................................................................................ 8 Checking list in case of implementation issue ................................................................... 9 How to delete your cookies. ..................................................... Erreur ! Signet non dfini. 5. Glossary ..................................................................................................................... 10

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

1. Global Explanation
Criteo Direct allows you to monetize a significant part of your advertising space at a guaranteed CPM. For every advertising display, Criteo is committed to: Either purchasing this display at the guaranteed CPM. In this case, you get 100% of the guaranteed CPM you have put in the Criteo Direct interface Or we will pass back this display in a transparent manner to your AdSense. In this case, Criteo does not take any commission: you get 100% of the revenue which comes from your usual advertising AdSense network.

a. How does it work?

Instead of implementing the AdSense tags on your site, you will implement the Criteo tags on your site. Criteo will continually monitor the quality of the traffic you send us, in order to offer you the best possible price. For each impression you send us, Criteo will dynamically decide if we are interesting based on the users history. The greater the volume of high performing impressions you send to us, the higher the Guaranteed CPM will be. As we only take a percentage of the impressions you send us (normally from 10% to 40%), the goal is to send us all ad impression. We will then send all the remaining impression to your Google AdSense account.

Total of your impressions

Impressions send to Criteo

Impressions taken by Criteo

CRITEO

AdSense
v1.0

Technical Implementation Guide

b. When Criteo takes the impression

24/08/2010

CRITEO

AdSense
v1.0

Technical Implementation Guide

c. When Criteo gives the impression back

24/08/2010

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

2. Set up in the Criteo Direct Interface

Once you have created an account in the Criteo Direct interface, click on Add a new website on the top left. This will create a new Site and a new Zone. When you create a new website, Criteo needs to approve it to ensure that it fit our policy. Until a site is approved, we will not deliver any ad on your Criteo zones. For more information, please read our Terms of Use. Once you have define the name, the size and the CPM you want for the new zone, you will need to copy a code from your AdSense account in the field Your current advertising code (without Criteo).

a. Explanation
We call this code the Passback Code. It will be called when the Criteo system does not take the impression. It will call back your current AdSense code so it can display an ad from another campaign. You need to paste a HTML AdSense Unit code from your AdSense in that section (see below for more details). For every Criteo Zone you want to create, you need one Ad Unit with the same size from AdSense.

If you have some difficulties to manage your AdSense Ad, please look at the Google documentation here.

CRITEO

AdSense
v1.0

Technical Implementation Guide

b. Details of the implementation

24/08/2010

In order to easily set up your Criteo campaign, you can find bellow the step by step details of the implementation. The Ad code you paste in the Criteo interface is the same than the one you have in your site. You need to create one Criteo Zone per Ad you have on your AdSense account. Then, you just need to replace the Ad Unit code you have on your site by the Criteo code. The Criteo code will be implemented directly in your site and will then redirect to your existing Ad in case Criteo dont take the impression. There is no set up or creation to do in your AdSense account. In AdSense, click on AdSense Setup on the top left, then on Manage Ads. You should now see the list of your running AdSense ads. Click on the Code button for every ad on the right.

If you have some difficulties to manage your ads, please look at the Google documentation here.

Then copy the AdSense ad code you have in the interface.

If you have some difficulties to create your ad code, please look at the Google documentation here.

And then, paste this code in the Criteo Interface into the field Your current advertising code (without Criteo).

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

3. Implementation of the Criteo Ad Code

The set up of the Passback code should now be correct in Criteo Direct. Every zone in Criteo Direct should look like this:

You now need to copy the Criteo code into your site code. You can find this HTML in every zone in the field Your Criteo advertising code. You can see below an example of a Criteo Code:
<script type='text/javascript'><!--//<![CDATA[ var m3_u = (location.protocol=='https:'?'https://cas.criteo.com/delivery/ajs.php':'http://cas.criteo.com/delivery/ajs.php'); var m3_r = Math.floor(Math.random()*99999999999); if (!document.MAX_used) document.MAX_used = ','; document.write ("<scr"+"ipt type='text/javascript' src='"+m3_u); document.write ("?nodis=1&amp;zoneid=XXXX"); document.write ('&amp;cb=' + m3_r); if (document.MAX_used != ',') document.write ("&amp;exclude=" + document.MAX_used); document.write (document.charset ? '&amp;charset='+document.charset : (document.characterSet ? '&amp;charset='+document.characterSet : '')); document.write ("&amp;loc=" + escape(window.location)); if (document.referrer) document.write ("&amp;referer=" + escape(document.referrer)); if (document.context) document.write ("&context=" + escape(document.context)); if (document.mmm_fo) document.write ("&amp;mmm_fo=1"); document.write ("'><\/scr"+"ipt>"); //]]>--></script>

With AdSense, you have one piece of code to implement on your site for every ad. This Ad Unit code displays an AdSense ad. As these pieces of code are now in the Criteo Direct, you need to delete them and replace them by the corresponding Criteo code. Whenever you have the bellow type of AdSense code in your site, replace it by the Criteo Code:
<script type="text/javascript"><!-google_ad_client = "pub-XXXXXXXXXXXXX"; /* 300x250, RG */ google_ad_slot = "XXXXXXXXX"; google_ad_width = 300; google_ad_height = 250; //--> </script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

4. Test the Criteo Implementation

How to check the integration?
a) Delete all your Cookies (see below). b) Visit several product pages of a CRITEO advertiser (for example http://www.booking.com/ ) c) Display your website in your browser (refresh a few times if needed) -> Criteo banner must be served

You can check the banners are from Criteo with clicking on the i.

It will link to a Criteo webpage.

If you cant see any Criteo banners even after several refresh, there might be an issue on the implementation. (Checks below).

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

If you can see a banner from Criteo, refresh the page several times until you see other ads from AdSense. It you see white displays or no ads on your website, there might be a problem with the passback code. To be sure, you can use tools like Firebug or Fiddler to check that Criteo calls your adserver back if we dont want the impression.

Checking list in case of implementation issue

Check the integration: OK Your website has been approved by Criteo Direct Maximum limit of impressions taken by Criteo (in the Criteo Direct interface) Criteo Guaranteed CPM is too high Your AdSense ad units are Active and showing ads If you still cant see any Criteo banners after all those checks, please contact us. NOK

How to delete your cookies.

Mozilla Firefox In the taskbar, click the Tools menu and then Options ... Select the Privacy tab Click on Delete specific cookies then at the bottom of this window click on remove all cookies Click Close to close the Cookies window Internet Explorer In the taskbar, click the Tools menu and then Internet Options In the General tab, under the heading Browsing History, click Delete In the new window, check that Cookie is activated Then in the bottom click Delete You can then close this window. Chrome In the taskbar click on the symbol and choose Options In the tab Under the hood click Clear Browsing Data Select Delete cookies and other site data and clear Everything, then click on Clear browsing data Safari In the taskbar click on the symbol then Preferences ... Select the Select the Security tab Under "Accept cookies": click on Show Cookies At the bottom of this window select Remove all. Click Finish to close this window Opera In the taskbar, click the Opera Menu, then Settings, and finally Delete private Data Select the Detailed Options in the new window Select Delete all cookies, then at the bottom click Delete. Then close this window. 9

CRITEO

AdSense
v1.0

Technical Implementation Guide

24/08/2010

5. Glossary
Ad Unit: defines in AdSense the size of an ad and its specific properties. Ad Unit Code: JavaScript code from AdSense that need to be place in Criteo Direct. Here is an example of Ad Unit Code:
<script type="text/javascript"><!-google_ad_client = "pub-XXXXXXXXXXXXX"; /* 300x250, RG */ google_ad_slot = "XXXXXXXXX"; google_ad_width = 300; google_ad_height = 250; //--> </script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>

AdSense: adserving platform for publisher made by Google. Invocation code : Criteo tags (called Your Criteo advertising code in the Criteo Direct interface) Passback: a piece of code that Criteo calls when the system does not want to take the impression (called Your current advertising code (without Criteo) in the Criteo Direct interface). Site: the url of your website in Criteo Direct. Zone: an ad placement in Criteo Direct.

10