> ## 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 CrossTarget data source to Adriel: obtain an API key, paste it, and name the data source.

CrossTarget is a Korean programmatic advertising platform that runs display, video, and Connected TV (CTV) campaigns. Connecting it brings the campaign hierarchy and performance — impressions, viewable impressions, clicks, spend, the video viewthrough funnel, installs, purchases, and 14 custom event counters — into Adriel dashboards, broken down by date, campaign, ad, inventory, channel, platform, and report type. The CrossTarget connector is currently in beta.

## Before you connect

The following are required:

* A CrossTarget account with API access enabled.
* The CrossTarget **API Key** for that account. The key is issued by CrossTarget and is sent on every report request, so anyone holding it can read the account's reports.
* Campaigns actively running on CrossTarget. Only data the API exposes will appear in dashboards.

## Connect CrossTarget

<Steps>
  <Step title="Obtain the CrossTarget API Key">
    Sign in to the CrossTarget admin portal, locate the API access section, and copy the **API Key** for the account.
  </Step>

  <Step title="Select the data source">
    On the **Data Sources** page, search for **CrossTarget** and select it.
  </Step>

  <Step title="Enter the API key and name">
    Paste the key into the **API Key** field, then enter a display **Name** for the data source. This name is shown in dashboards and connector lists.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync pulls the last **90 days** of historical data and runs in the background; data typically appears within one business day.
  </Step>
</Steps>

## What gets imported

The connector fetches daily CSV reports across three report types — display, video, and CTV — and flattens them into one shared schema. Each row carries date, campaign group, campaign, ad, inventory, ad size, channel, and platform identifiers, plus the full CrossTarget metric set: impressions, viewable impressions, clicks, spend, video viewthrough at start / 25% / 50% / 75% / completion, installs, app opens, purchases, purchase revenue, and 14 custom event counters. Video viewthrough metrics are populated only in video and CTV rows; display rows leave those columns empty by design.

For the complete list of metrics, breakdowns, schema details, and refresh behavior, see the [CrossTarget data reference](/data-sources/a-f/crosstarget/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection fails immediately after submitting the API key">
    Verify the API Key was copied without leading or trailing whitespace and that API access is enabled on the CrossTarget account. The key is sent as the `auth_key` query parameter on every report request, so any mistyped character causes authentication to fail.
  </Accordion>

  <Accordion title="Data is not appearing after connection">
    The initial fetch covers the last 90 days and runs asynchronously. Allow up to one business day for the first sync to complete. Subsequent refreshes run daily at 22:00 UTC and rebuild the most recent 3 days.
  </Accordion>

  <Accordion title="Video metrics are zero for some campaigns">
    Video viewthrough metrics — start, 25%, 50%, 75%, completed views, and viewable impressions — are returned by CrossTarget only for video and CTV campaigns. Display campaigns return empty values for those columns by design.
  </Accordion>
</AccordionGroup>

## Related

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

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

  <Card title="How to connect Targeting Gates" href="/data-sources/o-z/targeting-gates/how-to-connect">
    Connect the Targeting Gates (WiderPlanet) Korean ad platform.
  </Card>

  <Card title="How to connect Naver GFA" href="/data-sources/g-n/naver-gfa/how-to-connect">
    Connect Naver's GFA advertising platform.
  </Card>
</CardGroup>