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.
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)
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 | Advertiser object | Includes the adv name and logo |
privacy | Privacy Object | 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 | Image object | 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 | Image object | 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.