Table of contents
Introduction
Welcome! This document will explain integrating with Commerce Grid's Prebid solution.
If you are starting a Prebid implementation from scratch, please refer to Prebid's How-to documentation here.
Use the Table of Contents feature on the left navigation to navigate select areas within this integration guide.
Requirements
You will receive from Criteo
A list of identifiers for each ad placement and/or format you have available on the page
You will need to
Download prebid.js from Prebid.org or manually build from Github, including the Criteo adapter and the required modules.
Map the placements available on each page with the Criteo networkId
Criteo complies with the IAB Consent Framework. Please refer to their documentation for more information and examples of certified CMPs.
Allow the Criteo bid adapter to have access to the storage (CF next section)
Google Ad Manager Setup
If this is the first time you are setting up a Prebid campaign in Google Ad Manager, please contact your Criteo Account Manager for help. Please check the official Prebid documentation here for a detailed step-by-step description.
You can integrate Prebid in two modes:
Google Ad Manager Setup - Standard / Mediation mode on
Not recommended
Prebid will provide keywords only for the winning bids:
Keyname | Example | Description |
|---|---|---|
| | The winner |
| | The ad Id used by the ad server creative to render the correct ad |
| | The bid price bucket used to target the respective line item. |
| | The ad format |
The keyword hb_pb is used to define the line item targeting criteria (image below), and hb_adid at the creatives (code to the left).
Google Ad Manager Setup - Send all bids / Mediation off
Recommended
This makes use of the function pbjs.enableSendAllBids() in order to provide keywords for all bidders. More details on http://prebid.org/dev-docs/examples/send-all-bids.html and http://prebid.org/adops/send-all-bids-adops.html
For Criteo especifically:
Keyname | Example | Description |
|---|---|---|
| | The ad Id used by the ad server creative to render the correct ad |
hb_format_criteo | hb_format_criteo=banner | This will ensure that the appropriate ad server line item is activated for banner / outstream bids hb_pb_criteo | hb_pb_criteo=2.50 | The bid price bucket used to target the respective line item. hb_size_criteo | hb_size_criteo=300x250 | The ad format
You will also require to implement one dedicated set of line items for Criteo using the keyword hb_pb_criteo for the line item targeting criteria (image below), and hb_adid_criteo at the creatives (code to the left).
Google Ad Manager Setup - Line item Creation tool
Criteo offers a tool to help doing the initial Prebid setup. You will need to enable API access and share Google Ad Manager access with Criteo. Please contact your Criteo Account Manager for more details.
AMP
Criteo's solution is compatible with AMP RTC. Please refer to this dedicated AMP guide for more details.
Native ads
We recommend to use Prebid.js native implementation. Please refer to this official Prebid guide for more details.
Ad requirements
Criteo Native guidelines:
Display the adchoices icon and implement the link to the opt-out page
Display at least one advertiser information (domain, name)
Display at least one product recommendation
Use Criteo click URLs
Every impression pixel must be called once the ad is delivered
Product images
Criteo images for native inventory will be sized to fit within a 400x400 html element. They will not be padded to fit the dimensions or ratio, they should therefore be centered in the layout by the partner.
Native ads (deprecated) - Native Placement
The original native implementation described below is still valid but we discourage its use.
In order to activate Native demand, first you need to declare a callback function that will be used to render the Native ad. This section provides instructions on how to build a native ad.
Native ads (deprecated) - Native Object
When a native demand is available, Criteo will return the following native object:
NATIVE OBJECT
Field | Type | Description |
|---|---|---|
product | Product object Array | List of product assets. |
advertiser | Includes the adv name and logo | |
privacy | Includes adchoices and opt-out url | |
impression_pixels | Impression pixels object Array | List of impression pixels |
PRODUCT OBJECT
Field | Type | Description |
|---|---|---|
title | String | Product title. |
description | String | Product description. |
price | String | Product formatted price. It comes formatted by default with the currency symbol. |
click_url | String | Product landing page |
call_to_action | String | Product CTA |
image | Product image (400x400 px) |
IMAGE OBJECT
Field | Type | Description |
|---|---|---|
url | String | Image URL. |
height | Integer | Image height |
width | Integer | Image width |
ADVERTISER OBJECT
Field | Type | Description |
|---|---|---|
description | String | Advertiser name |
domain | String | Advertiser domain |
logo | Advertiser logo (200x200 px) |
PRIVACY OBJECT
Field | Type | Description |
|---|---|---|
optout_click_url | String | Opt-out landing page URL |
optout_image_url | String | Adchoices icon URL |
IMPRESSION PIXEL OBJECT
Field | Type | Description |
|---|---|---|
url | String | Impression pixel beacon |
Native ads (deprecated) - Adserver integration
The campaigns are configured as the normal campaign and you can reuse the same Creative codes for the standard ads. Prebid will automatically identify the native ad context and execute whatever has been defined at the nativeCallback parameter.
Native ads (deprecated) - Ad requirements
Criteo Native guidelines:
Display the adchoices icon and implement the link to the opt-out page
Display at least one advertiser information (domain, name)
Display at least one product recommendation
Use Criteo click URLs
Every impression pixel must be called once the ad is delivered
You will find to the right one sample code that uses the most relevant assets.
Native ads (deprecated) - Product images
Criteo images for native inventory will be sized to fit within a 400x400 html element. They will not be padded to fit the dimensions or ratio, they should therefore be centered in the layout by the partner.