Criteo

This connector captures data from Criteo's API.

Supported data resources

The following data resources are supported through the Criteo APIs:

• Ad Sets
• Advertisers
• Audiences
• Audiences (Legacy)
• Campaigns (Legacy)
• Campaigns (Preview)
• Categories (Legacy)

You may also configure multiple Report resources based on desired dimensions and metrics.

By default, each resource is mapped to an Estuary collection through a separate binding.

Prerequisites

To set up a Criteo source connector in Estuary, you will need:

• A Criteo Client ID
• A Criteo Client Secret
• One or more Advertiser IDs

See Criteo's documentation for information on authentication and where to find your IDs.

Configuration

You configure connectors either in the Estuary web app, or by directly editing the catalog specification file. See connectors to learn more about using connectors. The values and specification sample below provide configuration details specific to the Criteo source connector.

Properties

Endpoint

Property	Title	Description	Type	Required/Default
/client_id	Client ID	The Criteo client ID used for authentication.	string	Required
/client_secret	Client Secret	The Criteo client secret used for authentication.	string	Required
/advertiser_ids	Advertiser IDs	One or more Criteo advertiser IDs.	string[]	Required
/start_date	Start Date	Earliest date to read data from. Uses UTC date-time format, ex. YYYY-MM-DDT00:00:00.000Z.	string	Required
/reports	Reports	Optional configuration for additional report streams.	object[]
/reports/-/name	Report Name	The report's name.	string
/reports/-/dimensions	Report Dimensions	An array of dimensions. See Criteo's documentation for possible options.	string
/reports/-/metrics	Report Metrics	An array of metrics. See Criteo's documentation for possible options.	string
/reports/-/currency	Report Currency	The report's currency.	string	USD

Bindings

Property	Title	Description	Type	Required/Default
/stream	Stream	Criteo resource from which collections are captured.	string	Required
/syncMode	Sync Mode	Connection method.	string	Required

Sample

captures:
  ${PREFIX}/${CAPTURE_NAME}:
    endpoint:
      connector:
        image: ghcr.io/estuary/source-criteo:v1
        config:
          client_id: {secret}
          client_secret: {secret}
          advertiser_ids:
            - "12345"
            - "67890"
          start_date: 2025-01-01T00:00:00.000Z
    bindings:
      - resource:
          stream: advertisers
          syncMode: full_refresh
        target: ${PREFIX}/advertisers
      {...}