> ## 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 Adform data source to Adriel: authorize an Adform account via OAuth, choose an advertiser, and select breakdowns and metrics.

Adform is a global independent advertising technology platform providing DSP, ad serving, and audience tools for display, video, and rich media campaigns. Connecting it pulls campaign performance from the Adform Buyer Stats API, with breakdowns and metrics discovered dynamically from Adform's metadata endpoints so the available field set reflects the current API surface.

## Before you connect

The following are required:

* An Adform account with API access enabled. API access is typically provisioned by the Adform account manager; contact Adform support if it is not yet enabled.
* Sign-in credentials for the Adform account that will authorize the connection.
* Permission on the Adform advertiser whose data should be imported.

The connector supports up to **8 breakdowns** and **10 metrics** per data source. The available metrics depend on the breakdowns selected.

## Connect Adform

<Steps>
  <Step title="Authorize access to the Adform account">
    On the Data Sources page, search for **Adform** and select it. Sign in to the Adform account in the pop-up window, review the **Application Access** permissions, and click **Allow** to grant access.
  </Step>

  <Step title="Configure the data source">
    On the data source settings, enter a **Name** to identify the data source, then choose the **Advertiser** to connect. Create one data source per advertiser.
  </Step>

  <Step title="Select breakdowns and metrics">
    Choose **Breakdowns** from the list (up to 8), then choose **Metrics** (up to 10). The available metrics correspond to the breakdowns selected.
  </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

The connector imports performance data at advertiser, campaign, line item / order, and creative (banner / adgroup) levels, with breakdowns available for device, browser, banner size and type, DMP segment, RTB domain, and day. Standard metrics include impressions, clicks, cost, conversions, sales, delivered conversions, video completions, RTB media cost, and visits, plus derived rates such as CTR, CPC, and CPM.

For the complete metric list, breakdowns, refresh cadence, and date range limits, see the [Adform data reference](/data-sources/a-f/adform/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="'Too many breakdowns or metrics' error on save">
    The Adform Stats API enforces a hard cap of 8 breakdowns and 10 metrics per report. Reduce the selection to fit within those limits and save again.
  </Accordion>

  <Accordion title="'Breakdown not available' or 'Metrics not available' error">
    Certain breakdown and metric combinations are not supported by the Adform Stats API. Remove the flagged field and reselect from the filtered picker, which excludes incompatible options.
  </Accordion>

  <Accordion title="No data appears outside a recent window">
    Each refresh pulls a fixed 397-day historical window. Queries that span dates outside this window return no data for the missing range, regardless of the dashboard date selector.
  </Accordion>

  <Accordion title="Currency does not match the workspace display currency">
    Spend and revenue are reported in the currency configured on the connected Adform account. Workspaces using a different display currency receive auto-converted values.
  </Accordion>

  <Accordion title="Report did not return in time">
    Report polling caps at 200 seconds before surfacing a `REPORT_NOT_READY_YET` state. The next scheduled refresh, which runs daily at 1:00 AM UTC, typically completes the report.
  </Accordion>
</AccordionGroup>

## Related

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

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

  <Card title="How to connect The Trade Desk" href="/data-sources/o-z/the-trade-desk/how-to-connect">
    Connect another DSP for display and video campaigns.
  </Card>

  <Card title="How to connect StackAdapt" href="/data-sources/o-z/stackadapt/how-to-connect">
    Connect a programmatic advertising data source.
  </Card>
</CardGroup>