Criteo Sync

What is Criteo?

Criteo is a technology company specializing in digital advertising. Their platform utilizes machine learning algorithms to analyze online user behavior and deliver targeted ads across various devices and channels. By helping advertisers reach potential customers who have shown interest in their products or services, Criteo aims to improve ad performance and drive conversions.


Product Type: Advertising

Integration Type: ID Sync


Capabilities

  • Triggers a match pixel using anonymousId and a partner ID to sync with Criteo’s match table.
  • Fires a beacon marker (beaconFired) to prevent redundant syncs during the cookie’s lifespan.
  • Enables Criteo to match MetaRouter’s first-party IDs to its internal identity graph.
  • Supports personalized ad targeting and campaign optimization based on identity resolution.

Considerations

  • The sync uses a pixel request that includes a partner ID and optional domain/name values.
  • Syncs are rate-limited using a storage marker and only re-fired based on UI-configured rules.

Sync Details

  • IDs:
    • beaconFired – A boolean marker indicating that the sync has occurred, used to suppress duplicate pixel calls for a set duration.
  • Description:
    • The sync triggers a pixel request using the anonymousId, partner ID, and optional domain/name values.
    • A beaconFired marker is stored in first-party storage with a configurable TTL.
    • The sync is only triggered again if the TTL expires or if re-sync is explicitly enabled.
    • The sync enables identity resolution for advertising and retargeting use cases.
  • Server-side Event Payload:
    Upon completion of all vendor's sync, the server-side events will incorporate all resolved identifiers as described above. The following object will be appended to the context.providers property within the event's JSON payload.
    {
      "criteo": {
        "beaconFired": true}
    }
    
  • Cookie Name:
    • Cookie: _meta_criteo_beaconFired
    • IndexedDB: [your storage prefix]_criteo_beaconFired
    • For a general guide on ID Sync validation, see here.

Sync Setup Guide

1. Gather Credentials

To complete the sync setup, you must obtain your Criteo Partner ID. Contact your Criteo account representative or support team to receive this value.


2. Add a Criteo Sync in MetaRouter

To trigger the match pixel, you must add a Criteo sync.

  1. From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
  2. In the Identity Syncs section, select the Criteo sync.
  3. Fill out the following fields:
    1. Cookie Lifetime (in days) – Defines how long to suppress the sync. Example: 30
    2. Partner ID – Criteo Partner ID for pixel match. Example: "3615"
    3. Fire On ReSync – Choose whether to re-fire the sync on identity update. Example: false
    4. First Party Name (optional) – Display name sent in pixel URL. Example: "metarouter"
    5. First Party Domain (optional) – Domain used in the pixel URL. Defaults to current hostname. Example: "metarouter.io"
  4. Scroll down and click the Save and Build File button.
  5. Deploy your AJS file to propagate changes to your web property.

What’s Next

If applicable, proceed with setting up your Criteo Starter Kit.