Table of contents
Gzipping
Criteo can receive compressed bid requests from partners and send them back compressed bid responses.
In order for our engine to properly handle a gzipped request, the HTTP header Content-Encoding: gzip must be present in the bid request.
In order for our engine to properly generate a gzipped response, the HTTP header Accept-Encoding: gzip must be present in the bid request.
For information, by default, all partners receive NON-compressed bid responses from Criteo.
Creatives - Formats for banners
Criteo primarily deals with so-called “dynamic creatives”. These creatives consist of a banner size (height and width) of a layout and of several products deemed interesting for the user. There are currently hundreds of different banner sizes, a dozen layouts, and billions of unique products. As Criteo’s operation grows, these numbers are expected to increase continually. Criteo uses two types of creatives: HTML within a JS tag, and HTML within an iframe.
Creatives - Image handling for native ad
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.
Creatives - Audit
Blocklist API
Criteo provides one API that returns a list of domains and apps for which we don't want to receive traffic. We recommend our partners to import this on a daily basis and filter any traffic matching these criteria.
Easily integrate with a simple HTTP request supporting the GET protocol.
Below, you will find comprehensive instructions for setting up the API.
Blocklist API - Retrieve your token
For the new Blocklist API, you need to use your personal token, which can be retrieved here in the User preference page: User preference page
Each token will be unique per user. Admin users will have the ability to manage users who have access to your account, and their associated tokens. Please note that you can generate a new API token at any time.
Once you have your personal token, you’ll just need to replace it in the API URL that you’ll find below.
Blocklist API - Interpret data
In blocklist puller list, if you see helloworld.com, .helloworld.com or *.helloworld.com, then you must filter domain + all subdomains.
If you see subdomain.helloworld.com, .subdomain.helloworld.com or *.subdomain.helloworld.com then you must filter all subdomains of helloworld but NOT the main domain helloworld.com
Blocklist API - Setting Up the Request
Parameter | Detail |
|---|---|
HTTP Method | GET |
URL | https://pmc.criteo.com/api/public/blocklisting?apitoken=publishertoken |
Blocklist API - Query examples
TO GET FULL LIST OF URLS AND APP BUNDLES
pmc.criteo.com/api/public/blocklisting?apiToken=12345
TO FILTER ON APP BUNDLES
pmc.criteo.com/api/public/blocklisting?apiToken=12345&onlyApps=true
TO FILTER ON URLS
pmc.criteo.com/api/public/blocklisting?apiToken=12345&onlyDomains=true