> ## 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 StackAdapt data source to Adriel: request a GraphQL API key, add it, and select an advertiser to import.

StackAdapt is a multi-channel programmatic advertising platform spanning native, display, video, audio, and connected TV across the open web. Connecting it brings campaign architecture and performance from StackAdapt's GraphQL API into Adriel dashboards for the advertisers selected during setup.

## Before you connect

The following are required:

* A StackAdapt account with API access enabled.
* A StackAdapt **GraphQL API key**. GraphQL credentials are separate from the older REST API key; the REST key retrievable from the StackAdapt UI will not authenticate against the GraphQL endpoint. If a GraphQL API key is not yet available, contact StackAdapt support to request one.
* Permission on the advertisers whose data should be imported.

## Connect StackAdapt

<Steps>
  <Step title="Request the GraphQL API key">
    Request a GraphQL API key from the StackAdapt team. The key is a unique alphanumeric string, issued separately from any REST API credentials.
  </Step>

  <Step title="Add the API key in Adriel">
    On the **Data Sources** page, search for **StackAdapt** and select it. Enter the **GraphQL API Key** from the previous step, then click **Submit**.
  </Step>

  <Step title="Select the advertiser">
    Choose the **Name** to connect from the drop-down list. One name corresponds to one data source. To import multiple advertisers, repeat the process for each name.
  </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, ad group, and creative levels, with breakdowns across channel (native, display, video, audio, CTV), country, device, and day. Standard metrics include impressions, clicks, spend, conversions, engagements, and video completions, plus derived rates such as CTR, CPC, CPM, and VTR. Architecture refreshes twice daily, and report data is available in real time with scheduled syncs over rolling 3-, 9-, and 30-day windows.

For the complete list of metrics, breakdowns, refresh cadence, and date range limits, see the [StackAdapt data reference](/data-sources/o-z/stackadapt/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication fails with a known-good StackAdapt API key">
    StackAdapt issues GraphQL API credentials independently of REST API credentials. A REST key will not authenticate against the GraphQL endpoint. Request a GraphQL-specific key from StackAdapt support and reconnect.
  </Accordion>

  <Accordion title="Connection fails after working previously">
    The API key is not rotated automatically. When StackAdapt revokes the key on their side, the connection must be re-established with a freshly issued key.
  </Accordion>

  <Accordion title="Spend totals default to USD on non-USD advertisers">
    When advertiser currency metadata is unavailable at data source creation, USD is used as the default. Review spend totals and ask StackAdapt to set the advertiser currency explicitly when working with non-USD accounts.
  </Accordion>

  <Accordion title="Cross-advertiser totals do not aggregate inside one data source">
    One data source is created per selected advertiser. Roll-ups across advertisers happen at the dashboard layer.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="StackAdapt data reference" href="/data-sources/o-z/stackadapt/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for StackAdapt.
  </Card>

  <Card title="StackAdapt FAQs" href="/data-sources/o-z/stackadapt/faqs">
    Common questions and expected behaviors for the StackAdapt data source.
  </Card>

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

  <Card title="How to connect Adform" href="/data-sources/a-f/adform/how-to-connect">
    Connect the Adform display and programmatic platform.
  </Card>
</CardGroup>