Skip to main content
VersionsThe current version of the documentation is 2026.01 and has been released in January 2026.

​
Version 2026.01

​
New Onsite Display Formats

Five new formats have been released, replacing the Legacy Onsite Display ones. We strongly recommend using the new formats for any new integration, as the legacy ones will be progressively phased out. You can find the documentation for the new formats here.

​
Version 1.3. (Q3-Q4 2025)

​
New Video Player Implementation (App: iOS)

We have published a new, enhanced guide that introduces a ready-to-integrate video ad wrapper that handles VAST parsing, video playback, and Open Measurement SDK compatibility for viewability and verification. This guide helps retailers to easily render, track, and measure in-app Onsite Video ad placements with minimal code. You can view it here.

​
New Server-Side Beacons Guide

In most cases, client-side beacons (from the browser or app) are the preferred and recommended method for tracking ad events. However, in cases where this is not possible, such as on the server side, inside a mobile app, or within privacy-constrained environments, a server-side beacon can be used as a fallback. You can view our dedicated guide here.

​
Beacon SDK update

As the new BeaconSDK v5 launched, we updated our dedicated page with new features, a quick start section and best practices. You can find the updated guide here.

​
New Landing Page

We have revamped our developer portal landing page to better showcase the Retailer Integration Documentation along with our APIs documentations for Retail Media and Performance Marketing. That’s the page you see when going to developers.criteo.com.

​
Version 1.2. (Q2-Q3 2025)

​
New video format

A new format is now available: the Branding Video Standout. This format combines a branded video with a branded image and a CTA. Learn more about it on the dedicated page.

​
Commerce Video is now in general availability

Commerce Video is not in beta anymore. You can find the dedicated documentation here.

​
Update of the Feed Parameter Page

We have adjusted the formatting of the feed parameter page for better readability. The Product Importer API documentation will now be located in the Retail Media API documentation here to avoid duplicates.

​
New Implemented Examples

You can now find embedded examples of implemented ads for Flagship, Butterfly, Branded Header, Interactive Header, Digital Shelf Talker at the end of each guide in the Ad rendering section.

​
Version 1.1. (Q1 2025)

​
New Product Importer API guides

The Product Importer API enables users to upload, update, and manage product datasets on the Criteo platform. We have added an entire new section dedicated to the Product Importer API in our “Feed & Product Data” section, where you can now find:

​
New Google Ad Manager section

The GAM or Google Ad Manager is a comprehensive ad management platform that enables publishers to manage, sell, and optimize both direct and programmatic ad inventory across web, mobile and app environments. Retailers already using GAM can now also integrate with Retail Media by adding custom creatives to their Line items. Learn how by visiting the new GAM guide available here.

​
Legacy vs. Universal Beacons

We have worked on clarifying the distinction between “legacy” and “universal/standard” beacons in the Ad Tracking section. We strongly encourage all new integrations to be done using universal beacons. We also provide in this section a guide to migrate from legacy to universal beacons.

​
Integration Best Practices

We have incorporated integration best practices guides into each of the main sections of the documentation (Product feed, Requesting Ads, Ad rendering, and Ad Tracking) to better accommodate different Retailer technical teams working on separate sections of the integration.

​
OneTag Offsite for Hybrid Apps

We have added a complementary page to the main OneTag for Retail Media Offsite page, for hybrid apps. You will find on this page the information to be able to (1) retrieve the advertising ID from the OS (Android or iOS), to then (2) pass the advertising ID to OneTag for both Android and iOS. We have also added a page about Hybrid apps.

​
OneTag Integration Flow Diagram

We have added a new diagram giving a more detailed overview of the integration flow for OneTag - Retail Media Offsite on this page., for a more comprehensive understanding of the process.

​
New Implementation Examples for Flagship & Butterfly

We are now providing a couple of new implementation examples for the Flagship and Butterly formats, so users can get a better sense of what a real implementation of those formats look like and access the code samples (HTML, CSS, Javascript) for each.

​
What’s next