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 User Acquisition dashboard.
- In Unity, navigate to Settings.
- On the Settings page, you will see two separate Organization fields. Pick the value from the Organization core ID field.
- Navigate to Stats API Access or Growth > API Management
- Click Service account to create a service account which is now required to obtain the Key ID and Secret Key for Singular's Data Connector.
- You must assign the following role to the service account: Advertise Stats API MMP Viewer.
- The assigned Organization role must be the Advertise Stats API with "MMP" in the role name.
- To retrieve creative-level cost data: you also must assign the role Advertiser API Viewer to permission Singular to access this data.
- You must assign the following role to the service account: Advertise Stats API MMP Viewer.
- Retrieve the Key ID and Secret Key:
- Click Create key
- Save the Key ID and Secret Key since they will not be shown again.
- Enter these credentials in Singular's Data Connector for Unity Ads (see below).
- In Singular, navigate to Settings > Data Connectors.
- Click the Add Data Connector button (or edit your existing Unity Ads data connector). In the search field, type and choose "Unity Ads".
- In the Unity Ads Configuration, paste the values you copied from Unity:
- Unity Organization core ID
- Key ID
- Secret Key
- 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 |