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 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
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
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
Engagement & conversions
Efficiency
Breakdowns
Account structure
Time
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
See also
- How to connect Unity Ads to Adriel (paired how-to)