Search specific term/phrase surrounded by double quotes. e.g. “deep linking”
Exclude records that contain a specific term prefixed with a minus. e.g. Android -Firebase

Unity Ads

Enable Unity Ads with Branch to power your mobile attribution.

1328

Overview

Unity Ads Inc. gives you the tools and analytics to help you achieve your app's goals. Whether you want to start creating in-app ads, IAPs (in-app purchases), or market your app to a potential audience, Unity Ads has the tools and expertise you need to succeed.

Partner Capabilities

Capability

Details

Company Type

Contact support at Unity Ads for more information

Deep Linking

Supported

Attribution

  • Click-Through Attribution
  • View-Through Attribution

Ad Campaign Types

  • Retargeting campaigns

Ad Formats

  • Banner
  • Video

Click Types

  • Server-side click

Supported Platforms

  • iOS
  • Android
  • Windows
  • Mac OS
  • Unix

Link Wrapping

Supported

Cost Ingestion Support

Supported

Cost Ingestion Types

via API (Beta)

Cost Time ZoneGMT
Cost Data Scheduling
  • 4 times/day for Days 0-1
  • 1 time/day for Days 3-5
  • 1 time/week for Days 8-14

Pricing Models

  • CPC
  • CPM
  • CPA

Prerequisites

In order to enable Unity Ads, you need to have completed the following:

  1. Created a Branch Dashboard.
  2. Enabled Universal Ads for your Branch account.
  3. Implemented the Branch SDK into your mobile app (iOS | Android)
  4. Created a Unity Cloud account, core organization ID, and a service account.
  5. Running campaigns through Unity Ads.

Enable Unity Ads

1. Enable Unity Ads in Branch

In the Branch Dashboard under Ads > Partner Management, find/search for Unity Ads. If you're already logged into the Branch Dashboard, you can also click here to go there directly.

You'll need to input the following ad account information:

  • Game ID: iOS
  • Game ID: Android

Click the Save & Enable button.

2. Configure Postbacks

Enabling Unity Ads will automatically enable the following postbacks:

  • INSTALL
  • OPEN
  • PURCHASE

You can configure these postbacks or add more under the Postback Config tab.

Send All Events

Optionally, you can check the checkbox for a given postback for sending all events. When checked, all events will be sent regardless of attribution. Otherwise, the postback will only fire for events attributed to Unity Ads.

Adding Postbacks

Click the Add New Postback button at the bottom of the screen. A modal will appear that will allow you to select an event that you are tracking with the Branch SDKs (including Custom Events).

For more in-depth postback configurations, view our guides:

3. Configure Attribution Windows

After configuring your events, navigate to the Attribution Windows tab to set windows by attribution type.

Recommended Attribution Windows

Attribution TypeWindow
click to session start90 days
click to install30 days
click to conversion event90 days
impression to session start1 day
impression to install1 day
impression to conversion event.1 day

4. Set up Cost Data

🚧

Beta for Non-SANs

Cost Data for Non-Self-Attributing Networks (Non-SANs) is a feature currently in Beta; be aware that there may be unexpected bugs/behaviors until the full release.

To set up cost ingestion for Unity Ads, you will need to authenticate using your Client Secret, Client ID, and Organization ID.

Client Secret and Client ID

Under Unity Cloud Grow, there is an "API Management" section, which has a link to your service accounts.

From here, you can create a new service account, and you can also create a key for the service account to get your Client ID and Client Secret.

Organization ID

Add the "Advertise Stats API MMP Viewer'' role to the service account. The role can be
found under the "Grow" list.

From here, you can get your Organization ID.

Please reach out to your Unity Ads account manager if you have trouble finding these values.

Enter your Client Secret, Client ID, and Organization ID, and click Save Authentication

Note: If you'd like data to be as accurate as possible, be sure to match timezones between your Branch account and Unity Ads.

5. Create Branch Ad Link

Next, you'll need to create a Branch Ad Link for your Unity Ads campaigns in order for Branch to properly attribute conversions.

The Branch Ad Link you create will be placed in your Unity Ads campaign.

6. Verify Data in Branch

After launching your Unity Ads campaigns, and conversions begin to happen, you'll want to verify data is being sent from Branch to Unity Ads. You can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter:

FilterOperatorValue
ad partner (3p)equalsa_unity

Once applied, data should flow through the Liveview, and you can see the data being sent to Unity Ads from Branch.

Verifying Cost Data

To verify that cost data is flowing into Branch, you need to have the following:

  • Completed all implementation steps above
  • You need to already be live with campaigns running for the ad network
  • Wait 24 hours for data to be pulled in