Setting Up Unity Ads
Cost Aggregation
Set up data connector
Set up data connector
Setup Instructions
To add your Unity Ads data connector, you will need login information from your Unity Ads Dashboard.
- In Unity, navigate to Growth > Settings.
- In the Organization section, copy the Organization field (A).
- In the same section, copy the Organization ID field (B).
- Navigate to Growth > API Management.
- In the Stats API Access section, copy the API Key field (C).
- In Singular, navigate to Settings > Data Connectors.
- Click the Add Data Connector button. In the search field, type and choose "Unity Ads".
- In the Unity Ads Configuration dialog, paste the values you copied from Unity:
- In the Username field, paste Organization (A).
- In the Password field, add your password.
- In the Organization ID field, paste the Organization ID (B).
- In the API Key field, paste the API Key (C).
- Add an optional description and click Submit.
Quick Details
Data Connector Technology | API (Unity Ads API - see documentation) + Unity Ads dashboard |
Data breakdown (segmentation) |
The following breakdowns are available:
In addition, Publisher granularity may be available - if you need it, contact us to discuss your options. |
Is data available on the creative (ad) level? | Yes |
Does Singular show your creative assets? | No |
Data Mapping
Singular's Publisher corresponds to Unity Ads' Source App (the app in which the ad was published).
Tip: For more information about any field in Singular reporting, see the Metrics and Dimensions Glossary.
Field in Singular UI | Field in Singular API | Field in Unity Ads |
Dimensions | ||
App ID |
site_public_id |
target name |
Country | country_field | country |
Creative Format | creative_format | at type |
Date | date_field | timestamp |
Network Campaign ID | adn_campaign_id | "campaign id", or if it's unavailable, "legacy campaign id" |
Network Campaign Name | adn_campaign_name | "campaign name", or if it's unavailable, "legacy campaign name" |
Platform | platform | platform |
Publisher ID | publisher_id | "source id" or "source app id" |
Network Creative ID | adn_creative_id | creative pack id |
Network Creative Name | adn_creative_name | creative pack name |
Metrics | ||
Cost | adn_cost | spend |
Network Clicks | adn_clicks | clicks |
Network Impressions | adn_impressions | by default, we pull impressions from the "starts" field. We can change this if you need to see a different metric. |
Network Installs | adn_installs | installs |