Unity Ads Data Connector

Follow
Avatar
Vaibhav Gupta
Updated
Setting Up Unity Ads
Cost Aggregation
Set up data connector

Setup Instructions

To add your Unity Ads data connector, you will need login information from your Unity Ads Dashboard.

  1. In Unity, navigate to Growth > Settings.
  2. In the Organization section, copy the Organization field (A).
  3. In the same section, copy the Organization ID field (B).
  4. Navigate to Growth > API Management.
  5. In the Stats API Access section, copy the API Key field (C).

unity_screens.png

  1. In Singular, navigate to Settings > Data Connectors.
  2. Click the Add Data Connector button. In the search field, type and choose "Unity Ads".
  3. In the Unity Ads Configuration dialog, paste the values you copied from Unity:
    1. In the Username field, paste Organization (A).
    2. In the Password field, add your password.
    3. In the Organization ID field, paste the Organization ID (B).
    4. In the API Key field, paste the API Key (C).
  4. Add an optional description and click Submit.

unity_setup.png

Quick Details

Data Connector Technology API (Unity Ads API - see documentation) + Unity Ads dashboard
Data breakdown (segmentation)

The following breakdowns are available:

  • Campaign
  • Country
  • Platform
  • Creative

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