What's new?
Welcome to the changelog for the Retailer Integration Documentation.
Version 1.3. - Q4 2025The current version of the documentation has been released in October 2025.
The 1.4. version is planned to be released in Q1 2026.
Version 1.3. (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 v4 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:
- The list of product dataset parameters (for both onsite and offsite),
- Product dataset examples.
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.
Updated 1 day ago
