Unity Ads Data Connector

Setup Instructions

To add your Unity Ads data connector, you will need login information from your Unity Ads User Acquisition dashboard.

  1. In Unity, navigate to Settings.
  2. On the Settings page, you will see two separate Organization fields. Pick the value from the Organization core ID field.
  3. Navigate to Stats API Access or Growth > API Management
  4. 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.
    1. 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.
  5. Retrieve the Key ID and Secret Key:
    1. Click Create key
    2. Save the Key ID and Secret Key since they will not be shown again.
  6. Enter these credentials in Singular's Data Connector for Unity Ads (see below).

Снимок экрана 2024-05-27 в 16.10.27.png

  1. In Singular, navigate to Settings > Data Connectors.
  2. Click the Add Data Connector button (or edit your existing Unity Ads data connector). In the search field, type and choose "Unity Ads".
  3. In the Unity Ads Configuration, paste the values you copied from Unity:
    1. Unity Organization core ID
    2. Key ID
    3. Secret Key
  4. Add an optional description and click Submit.

Unity Ads - new DC config instructions.jpg

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