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
1
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.
2
Find the Stats API key
In the Unity Ads dashboard, navigate to Growth > API Management > Status API Access and note the API key.
3
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.
4
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.
5
Submit
Click Submit to complete the connection. Initial data availability can take up to one business day.
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.Troubleshooting
Recent metrics look slightly different across refreshes
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.
Long date ranges overstate uniqueness-based metrics
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.
Date range exceeds the daily cap
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.
Connection breaks after API key rotation
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.
Related
Unity Ads data reference
Metrics, breakdowns, and limits for Unity Ads.
Unity Ads FAQs
Common questions and expected behaviors for the Unity Ads data source.
How to connect Moloco
Connect another mobile user-acquisition ad network.
How to connect Singular
Connect a mobile measurement partner for cross-channel attribution.
