> ## 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 Unity Ads data source to Adriel: gather the Unity organization IDs and API credentials, then enter them to import mobile user-acquisition data.

Unity Ads is Unity's user-acquisition platform for mobile games and apps, spanning rewarded video, interstitial, and banner inventory on iOS and Android. Connecting it brings spend, impressions, video engagement, clicks, and installs into Adriel dashboards across the ad account, campaign, ad set, and ad hierarchy, alongside other mobile user-acquisition channels.

## Before you connect

The following are required:

* A Unity Ads account with the **Owner** role in the organization being connected. Check this under **My account settings** > **Organization**.
* Access to the Unity Ads dashboard to retrieve the organization IDs and API credentials described below.
* A Service Account and the Management API enabled for the organization. Unity Support enables these on request.

## Connect Unity Ads

<Steps>
  <Step title="Find the Organization ID and Organization core ID">
    Log in to the Unity Ads dashboard and navigate to **Growth** > **Settings**. Note the **Organization ID** and the **Organization core ID**.
  </Step>

  <Step title="Find the Stats API key">
    In the Unity Ads dashboard, navigate to **Growth** > **API Management** > **Status API Access** and note the **API key**.
  </Step>

  <Step title="Create a Service Account and find the Key ID and Secret Key">
    In the Unity Ads dashboard, navigate to **Growth** > **About & Support** > **Support** and contact Unity Support by email to enable the Service Account and Management API for the organization. When Unity replies, create a Service Account and assign it these organization roles: **Advertise API Apps Editor**, **Advertise API Campaigns Editor**, and **Advertiser API Creative Packs Editor**. Note the **Key ID** and **Secret Key** generated for the account.
  </Step>

  <Step title="Enter the credentials in Adriel">
    On the **Data Sources** page, search for **Unity Ads** and select it. Fill in the five required fields: **Organization ID**, **Organization Core ID**, **API Key**, **Key ID**, and **Secret Key**.
  </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 spend, impressions, video starts and completions, clicks, and installs at daily granularity across the ad account, campaign, ad set, and ad hierarchy. CTR, completion rate, CPI, CPM, and CPC are derived. Breakdowns include source app, country, platform, and ad format (rewarded video, interstitial, banner). Date ranges are capped at 93 days for daily, 1 year for weekly, and 2 years for monthly.

For the complete list of metrics, breakdowns, and limits, see the [Unity Ads data reference](/data-sources/o-z/unity-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Recent metrics look slightly different across refreshes">
    Same-day data is refreshed multiple times throughout the day. Metrics may shift between refreshes until the same-day window stabilizes overnight.
  </Accordion>

  <Accordion title="Long date ranges overstate uniqueness-based metrics">
    Cache-only delivery aggregates daily snapshots, so metrics such as reach can be overvalued across long date ranges. Compare shorter windows for reach-sensitive analysis.
  </Accordion>

  <Accordion title="Date range exceeds the daily cap">
    Daily breakdowns are capped at 93 days, weekly at 1 year, and monthly at 2 years. Use weekly or monthly granularity for longer queries.
  </Accordion>

  <Accordion title="Connection breaks after API key rotation">
    Unity API keys do not refresh automatically. Generate a replacement key in the Unity Dashboard and re-save the connection with the new value.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Unity Ads data reference" href="/data-sources/o-z/unity-ads/data-reference">
    Metrics, breakdowns, and limits for Unity Ads.
  </Card>

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

  <Card title="How to connect Moloco" href="/data-sources/g-n/moloco/how-to-connect">
    Connect another mobile user-acquisition ad network.
  </Card>

  <Card title="How to connect Singular" href="/data-sources/o-z/singular/how-to-connect">
    Connect a mobile measurement partner for cross-channel attribution.
  </Card>
</CardGroup>