Unity Ads

The Unity Ads connector provides automated reporting for Unity Ads monetization analytics.

• Prerequisites
• Scheduling
• Parameters
• Sample Switchboard Script

Prerequisites

Unity Ads API token

available from the Unity Ads Account Manager Select Ads Data Export > API Access from the navigation bar, then copy the API key from the Monetization Stats API Access section, or click Create Api Key if none exists.

Scheduling

The Unity Ads connector can be scheduled to ingest data once per day at a user-defined hour and timezone. By default, the connector will run once at 6am PT. See Daily Scheduling for more information.

Parameters

organization_id

Name of the Unity Ads account. Available in the URL of the Unity dashboard

REQUIRED string

fields

One or more of the following values:

• adrequest_count
• start_count
• view_count
• available_sum
• revenue_sum

REQUIRED string list

api_version

allows choice of the Unity Ads API version. Defaults to v1

string

group_by

can be one or more of the following values:

• placement
• country
• platform
• game

string list

scale

beaks data down by time range. Can be one or more of:

• hour
• day
• week
• month
• year
• all

Defaults to day

Sample Switchboard Script

import unity_ads from {
    type: "unity_ads:monetization";
    key: "unity_ads_token";

    organization_id: "123456";
    
    
    fields: ["adrequest_count", "start_count", "view_count", "available_sum", "revenue_sum"];
    group_by: ["placement", "country", "platform", "game"];
    
   
    scale: ["day"];  
    

} using {
     timestamp: datetime;
     country: string;
     source_game_id: integer;
     placement: string;
     platform: string;
     source_name: string;
     adrequest_count: integer;
     revenue_sum: float;
     start_count: integer;
     available_sum: float;
     view_count: integer;
};