> ## 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. # Data reference > Metrics, breakdowns, refresh cadence, and limits for the Unity Ads data source in Adriel. ## Introduction Unity Ads is Unity's user-acquisition platform for mobile games and apps, delivering rewarded video, interstitial, and banner ads across iOS and Android inventory. The connector pulls spend, impression, video-engagement, and install data across the ad account, campaign, ad set, and ad hierarchy. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see [How to connect Unity Ads to Adriel](/data-sources/o-z/unity-ads/how-to-connect). ## Data refresh strategy ### Architecture data Architecture covers ad accounts, campaigns, ad sets, and ads. It refreshes twice daily at **4:00 PM UTC** and **5:00 AM UTC**. ### Reports data Reports include daily performance for ad accounts, campaigns, ad sets, and ads. **Cache-only.** Report data comes from cached daily performance snapshots. Dashboard data is composed from the last snapshot, so metrics based on uniqueness may be overvalued across date ranges longer than one day. **Initial fill.** On data source creation, the cache fills with **365 days** of historical data at the ad account, campaign, ad set, and ad levels. **Refresh schedule.** Reports refresh on several overlapping schedules: * **5:00 PM UTC** — syncs the last **9 days** for ad account, campaign, ad set, and ad * **9:00 PM and 6:00 AM UTC** — syncs the last **3 days** for ad account, campaign, ad set, and ad * **3:00 AM and 8:00 AM UTC** — syncs the last **1 day** for ad account, campaign, ad set, and ad * **11:00 AM UTC** — syncs the last **3 days** for ad account, campaign, ad set, and ad * **3:00 PM UTC on day 3 of the month** — syncs the last **35 days** for ad account, campaign, ad set, and ad Data is considered reliable within the cache sync window. Older data may be incomplete or inaccurate due to legacy caching behavior. ## Architecture levels Ad account → Campaign → Ad set → Ad The ad account maps to a Unity app, and the ad maps to a Unity creative pack. Unity has no ad set entity, so the ad set level mirrors the campaign. ## Date range limits | Breakdown | Max range | | --------- | --------- | | Daily | 93 days | | Weekly | 1 year | | Monthly | 2 years | ## Metrics **How to read the columns** **Data type** uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. **API Key** in code style like `spend` is the literal Unity Ads reporting field. *Italic text* describes how a value is produced when it doesn't map cleanly to a single field. ### Delivery & spend | Metric | Description | Data type | API Key | | ----------- | ------------------------------------------------------------------------------------------ | --------- | -------- | | Spend | Reported spend, normalized to USD. | Currency | `spend` | | Impressions | Ad impressions. Unity reports this from its video-start count, so it matches Video starts. | Number | `starts` | | Clicks | Ad clicks. | Number | `clicks` | ### Engagement & conversions | Metric | Description | Data type | API Key | | ------------ | ---------------------------------- | --------- | ---------- | | Video starts | Video plays initiated. | Number | `starts` | | Installs | App installs attributed to the ad. | Number | `installs` | ### Efficiency | Metric | Description | Data type | API Key | | ------ | -------------------------------------------------- | ---------- | ---------------------------- | | CTR | Click-through rate: clicks divided by impressions. | Percentage | *clicks / impressions* | | CPM | Cost per thousand impressions. | Currency | *spend / impressions × 1000* | | CPC | Cost per click. | Currency | *spend / clicks* | | CPI | Cost per install. | Currency | *spend / installs* | ## Breakdowns ### Account structure | Breakdown | Description | API Key | | ---------- | -------------------------------------------------------------------------- | ----------- | | Ad account | Group by ad account (Unity app). | `adAccount` | | Campaign | Group by campaign. | `campaign` | | Ad set | Group by ad set. Unity has no ad set entity, so this mirrors the campaign. | `adSet` | | Ad | Group by ad (creative pack). | `ad` | ### Time | Breakdown | Description | API Key | | --------- | -------------------------------------------------- | ------- | | Daily | Split reports by day. Limited to a 93-day range. | `day` | | Weekly | Split reports by week. Limited to a 1-year range. | `week` | | Monthly | Split reports by month. Limited to a 2-year range. | `month` | ## Limitations * **Cache-only delivery** — dashboard data is composed from the last daily snapshot; data outside the cache sync window may be incomplete or inaccurate. * **Uniqueness metrics** — metrics based on uniqueness may be overvalued across date ranges longer than one day. * **Currency normalized to USD** — every ad account is reported in USD, regardless of its native Unity currency. * **No ad set level** — Unity has no ad set entity, so the ad set breakdown mirrors the campaign. * **No audience or delivery breakdowns** — reporting supports only the account hierarchy and date grouping. There are no country, platform, source-app, or ad-format splits. * **Video completions not surfaced** — Unity reports video completions, but the connector does not currently expose them as a metric. * **API key dependency** — if the API key is revoked in Unity, the connection breaks and must be re-established with a new key. ## API references * Management API base: `https://services.api.unity.com/advertise/v1` * Stats API base: `https://services.api.unity.com/advertise/stats/v2` * [Unity Ads reporting API documentation](https://docs.unity.com/) ## See also * [How to connect Unity Ads to Adriel](/data-sources/o-z/unity-ads/how-to-connect) (paired how-to)