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

# How to connect

> How to connect the Criteo data source to Adriel: authorize via OAuth, select an ad account, and pull campaign performance.

Criteo is a global commerce-media platform best known for retargeting and performance display advertising across the open web. Connecting it pulls campaign- and ad-set-level performance from Criteo's Stats API into Adriel dashboards, with architecture data merged from live endpoints and report-derived fallback so deleted entities still appear in historical reporting.

<Info>
  The Criteo Retail Media product (sponsored products on retailer sites) uses a different API and metric set. For that product, use the separate [Criteo Retail Media](/data-sources/a-f/criteo-retail-media/how-to-connect) connector instead.
</Info>

## Before you connect

The following are required:

* A Criteo account with **admin access**.
* The ability to complete the OAuth consent screen in a browser.

No manual API keys are required — OAuth handles credentials end to end.

## Connect Criteo

<Steps>
  <Step title="Grant Adriel Criteo API access">
    On the **Data Sources** page, search for **Criteo** and select it. Sign in to the Criteo account in the OAuth pop-up, then on the **Portfolio access** page select the accounts to connect and click **Ok**. If the **Already granted** message does not appear after clicking **Ok**, redo the authorization.
  </Step>

  <Step title="Select the ad account">
    On the data source settings, choose the **Ad Account** to connect from the list.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

Performance data is imported at the ad account, campaign, ad set, and ad levels, with breakdowns across device, country, and day. Standard metrics include spend, impressions, clicks, conversions, and revenue, plus derived rates such as CTR, CPC, and ROAS. Spend and revenue are reported in the currency configured on the Criteo advertiser account.

For the complete list of metrics, breakdowns, refresh cadence, and date range limits, see the [Criteo data reference](/data-sources/a-f/criteo/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Refresh token missing from the response">
    Criteo issues a new refresh token on every token refresh. When a refresh response omits the new value, the connection becomes unrecoverable. Open the Criteo data source in Connections and click **Reconnect** to redo the OAuth flow.
  </Accordion>

  <Accordion title="Connection breaks after several weeks of stable operation">
    The most common cause is the rotating refresh token failing to return on a refresh attempt. Reconnect the data source with a fresh OAuth flow to restore it.
  </Accordion>

  <Accordion title="Creative-level data is missing">
    The Stats API exposes performance at the campaign, ad set, and ad levels. Deeper creative-level analysis must be performed in the Criteo dashboard directly.
  </Accordion>

  <Accordion title="Spend or revenue does not match the workspace display currency">
    Values are reported in the currency configured on the Criteo advertiser account. Workspaces using a different display currency receive auto-converted values.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Criteo data reference" href="/data-sources/a-f/criteo/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for Criteo.
  </Card>

  <Card title="Criteo FAQs" href="/data-sources/a-f/criteo/faqs">
    Common questions and expected behaviors for the Criteo data source.
  </Card>

  <Card title="How to connect Criteo Retail Media" href="/data-sources/a-f/criteo-retail-media/how-to-connect">
    Connect Criteo's sponsored-products retail media product.
  </Card>

  <Card title="How to connect The Trade Desk" href="/data-sources/o-z/the-trade-desk/how-to-connect">
    Connect another programmatic display and retargeting platform.
  </Card>
</CardGroup>