> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innkeepr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Criteo

> [card] Connection Info
>
> The Criteo Connection is an **Advertising** and **Signals** connection.
>
> * **Advertising:** Innkeepr reads campaigns and spend data.
> * **Signals:** Innkeepr sends Signals to this platform.

[Criteo](https://www.criteo.com) is a commerce media platform for retargeting and prospecting across the open web. Add Criteo as a Connection to Innkeepr to send Audience Signals to Criteo and to measure which ad sets create incremental results.

## Getting Started

1. From your workspace's **Connections** page, click **Add connection**.
2. Choose **Criteo**.
3. Click **Connect** and log in to Criteo.
4. On the Criteo consent page, select the advertiser accounts you want to sync and click **Approve**.
5. Enter the name of your URL parameter in **Ad set ID parameter**, for example `adset_id`. The connection can only be validated with this field. See [URL parameter](#url-parameter).
6. Optional: enter your GUM caller ID in `gumCallerId`. See [Matching](#matching).
7. Click **Save**.

## How Innkeepr syncs audiences

For every Audience Signal, Innkeepr creates an **audience segment** in your Criteo advertiser account and keeps it updated. You never upload a file.

Criteo needs 24–48 hours to match the users of a new segment. Audiences created by Innkeepr appear in **Criteo** > **Audiences** with the name of the Audience Signal.

### Matching

Criteo matches users with these identifiers:

| Identifier | Source |
| :- | :- |
| Email address | Shop integration, such as [Shopify](https://docs.innkeepr.ai/connections/sources/shopify.md), or [Identify](https://docs.innkeepr.ai/connections/spec-identify.md) |
| GUM ID | Criteo’s own user ID. Request your GUM caller ID from your Criteo account team and enter it in the Criteo connection in `gumCallerId`. |

If few users match, send more email addresses to Innkeepr and add your GUM caller ID to the connection.

## URL parameter

Innkeepr needs the Criteo ad set ID as a URL parameter, so it can assign website visits to the ad sets they came from. In Criteo, the ad sets are your Treatments. You choose the parameter name yourself; it must match what you entered as **Ad set ID parameter** in the connection.

Add the parameter as a suffix to every ad set in **Criteo** > **Ad sets** > **Ads tracking**, replacing `your_parameter` with the name from the connection:

`&your_parameter={{adsetid}}`

For example, with `adset_id` in the connection: `&adset_id={{adsetid}}`. Criteo replaces `{{adsetid}}` with the numeric ad set ID on every click.

## Permissions

To connect Criteo, the Criteo user who logs in needs the **Administrator** role on the advertiser account. Criteo only lets Administrators grant an app access to an account. Users with the **Business**, **Technical**, **Billing**, or **Read-only** role cannot connect Criteo.

With this access, Innkeepr can:

* Read campaigns, ad sets, and their spend
* Create and update audience segments


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.