> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Criteo

> Learn how to set up Criteo integration with Rockerbox for display and OTT tracking

## Setup Process

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to enable the integration. Let the team know the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied
2. Append click-through URL parameters to your landing page URLs and apply the impression pixel to all active ads using the instructions below. Parameters use macros and do not need to be manually replaced
3. Authenticate your Criteo account in Rockerbox to enable API spend ingestion (see API Spend section below)
4. Allow at least one full day of data collection after launch, then confirm tracking is applied to all your ads using the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page

## Display

### URL Tracking Parameters

Append the parameters below to your landing page URLs for all display campaigns.

**Example Parameter String:**

```text wrap theme={null}
cr_campaignid={{campaignid}}&cr_bannerid={{bannerid}}&cr_type=display
```

<Accordion title="Parameter Details">
  | Parameter       | Macro            | Description               |
  | --------------- | ---------------- | ------------------------- |
  | `cr_campaignid` | `{{campaignid}}` | Campaign ID (required)    |
  | `cr_bannerid`   | `{{bannerid}}`   | Banner/Creative ID        |
  | `cr_type`       | `display`        | Campaign type (hardcoded) |
</Accordion>

### Impression Pixel

Apply the pixel below to all active display ads.

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=criteo&tier_two={{campaignid}}&tier_three={{bannerid}}&tier_four={{width}}x{{height}}&auction_id={{random}}
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox. It's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

<Accordion title="Parameter Details">
  | Parameter    | Macro                  | Description                     |
  | ------------ | ---------------------- | ------------------------------- |
  | `tier_one`   | `criteo`               | Platform identifier (hardcoded) |
  | `tier_two`   | `{{campaignid}}`       | Campaign ID (required)          |
  | `tier_three` | `{{bannerid}}`         | Banner/Creative ID              |
  | `tier_four`  | `{{width}}x{{height}}` | Creative dimensions             |
  | `auction_id` | `{{random}}`           | Random number for deduplication |
</Accordion>

## OTT/CTV

### URL Tracking Parameters

Append the parameters below to your landing page URLs for all OTT/CTV campaigns.

**Example Parameter String:**

```text wrap theme={null}
cr_campaignid={{campaignid}}&cr_bannerid={{bannerid}}&cr_type=ott
```

<Accordion title="Parameter Details">
  | Parameter       | Macro            | Description               |
  | --------------- | ---------------- | ------------------------- |
  | `cr_campaignid` | `{{campaignid}}` | Campaign ID (required)    |
  | `cr_bannerid`   | `{{bannerid}}`   | Banner/Creative ID        |
  | `cr_type`       | `ott`            | Campaign type (hardcoded) |
</Accordion>

### Impression Pixel

Apply the pixel below to all active OTT/CTV ads.

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=criteo-ott&tier_two={{campaignid}}&tier_three={{bannerid}}&tier_four={{width}}x{{height}}&auction_id={{random}}
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox. It's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

<Accordion title="Parameter Details">
  | Parameter    | Macro                  | Description                     |
  | ------------ | ---------------------- | ------------------------------- |
  | `tier_one`   | `criteo-ott`           | Platform identifier (hardcoded) |
  | `tier_two`   | `{{campaignid}}`       | Campaign ID (required)          |
  | `tier_three` | `{{bannerid}}`         | Banner/Creative ID              |
  | `tier_four`  | `{{width}}x{{height}}` | Creative dimensions             |
  | `auction_id` | `{{random}}`           | Random number for deduplication |
</Accordion>

## API Spend

Rockerbox pulls spend data directly from Criteo via API.

1. In Rockerbox, navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page
2. Select Criteo from the list and click "Connect"
3. Complete the Criteo authentication process to enable daily spend ingestion

If you manage multiple Criteo accounts, repeat the authentication process for each account.

### Troubleshooting Authentication

If your Criteo account shows as unable to connect and the account is already granted:

1. Go to the [Criteo Consent](https://consent.criteo.com/) page
2. Click "Revoke access" for the impacted accounts
3. Return to Rockerbox and reauthenticate your Criteo account on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page

## Verification

After setup:

1. Verify impression pixels are firing correctly on both display and OTT ads
2. Validate click tracking parameters are populating
3. Confirm spend data appears in Rockerbox within 24-48 hours
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance