• User Guide
• Integration
• Ad Channel Integration

Unity Ads

Written by Yeji Jeon,

Last updated 7 days ago

Airbridge supports integration with Unity Ads, including cost integration and agency settings. Owner and In-house Marketer users and authorized Agency and Media Partner users can access Unity Ads campaign data in the Airbridge dashboard.

Navigate to [Integrations]>[Ad Channel Integration] in your Airbridge dashboard and select “Unity Ads.” In the [Tracking Link] tab, you can create and manage tracking links to measure the performance of your Unity Ads campaigns.

For detailed instructions on creating and managing tracking links in Airbridge, refer to the articles below.

• Creating Tracking Links

• Tracking Link Management

Postback configuration required

To share in-app events and attribution results with ad channels, postback configuration must be completed before you embed tracking links to your ads.

If the postback configuration is not completed before data collection begins, the data will not be shared with the respective ad channels.

In the [Attribution Rule] tab, you can configure the lookback window and attribution window for Unity Ads. Click Go to edit page to move to the [Management]>[Attribution Rule] page, where you can edit attribution rules.

For detailed instructions on configuring the lookback window and attribution window, refer to this article.

Follow the steps below to enable cost integration with Unity Ads. Make sure to go through the entire process.

Note

The cost integration method will be updated due to changes in the Unity Ads API. Delete all existing ad accounts and reconnect the ad accounts with new credentials by May 8, 2024.

To enable cost integration with Unity Ads, submit the following Unity Ads credentials to Airbridge:

• Organization core ID

• Service account information

Only Owners and Managers of a Unity Organization have access to the credentials. For more information about organization roles, refer to this Unity documentation.

1. Sign in to your Unity Dashboard.

2. Under [Products], search for “Unity Ads User Acquisition” and click it. Then, navigate to [Unity Ads User Acquisition]>[Settings]>[Organization] to get the organization core ID.

   

   Attention

   Organization core ID is different from organization and organization ID. Make sure to get the organization core ID.

3. Navigate to [Products]>[Unity Ads User Acquisition]>[API Management]>[Advertising Management API]. Click “Service Account” to create a service account.

4. If you already have a service account, move on to the next step.

   

5. Click the service account created. Or navigate to [Administration]>[Service accounts] and click the service account to integrate with Airbridge. Under [Keys], click + Add key.

   

6. Get your key ID and secret key. Save the secret key as you won’t be able to access it again.

   

Attention

Make sure to select the correct organization role. If you select an incorrect organization role, the cost integration with Unity Ads won’t be enabled.

Navigate to [Administration]>[Service accounts] and click the service account to integrate with Airbridge. Under [Organization roles], click + Manage organization roles.

From the Growth drop-down list, select “Advertise Stats API MMP Viewer.” Click Save to finish assigning an organization role.

Submit the Unity Ads credentials to Airbridge to complete the cost integration setup.

1. Navigate to [Integrations]>[Ad Channel Integration] in the Airbridge dashboard. Select “Unity Ads.”

2. Select the [Cost Integration] tab. Switch on the Unity Ads Cost Integration toggle and click + Add an account.

3. Submit the following credentials. Service account information includes the key ID and the secret key.

   • Organization core ID

   • Service account information

     

4. After assigning the “Advertise Stats API MMP Viewer” organization role in Unity Ads, click Done in the Airbridge dashboard.

5. The Unity Ads account is added to the integrated account list. The status will show “Waiting” for up to 4 hours from the time the account is added and will change to “Active” when data is pulled for the first time.

Upon submitting your ad account information to Airbridge, you can check if the integration is running. The status may show “Waiting” even when the account is successfully added if no data has been pulled yet.

For more details on the integration status and data import schedule, refer to the below.

The data pulled from Unity Ads can be viewed in the Actuals Report and Trend Report using the following metrics and GroupBy options.

1. Navigate to [Integrations]>[Ad Channel integration] in your Airbridge dashboard. Select “Unity Ads.”

2. Select the [Agency Settings] tab and click the + Add an agency.

3. Select the agency you want to add from the agency list. Agencies already added are not displayed in the list.

4. Configure the campaign name rule. The agency role account users can view the campaign data given access based on the campaign name rules.

The campaign name rule can be configured by selecting “starts with” or “ends with” and selecting an agency tag. You can also enter the agency tag using less than 50 characters, which can be a combination of letters in mixed case, numbers, and hyphens. More than one campaign name rule can be configured. When you are done, click Save.

5. From the agency list, you can see which agency is given access to which campaign data from Unity Ads.

Agency role account users who belong to the agencies added to the agency list are granted permission to the following.

• Access to the campaign data based on the campaign name rules

• Access to the cost data pulled from the account added by the Agency role account user from the same Agency

• Manage the accounts added by the Agency role account user from the same Agency for cost integration

Note

The cost integration toggle and account name in the activity history logs are available to Owner role accounts, and In-house Marketer accounts only. If you are using an Agency role account and need to have access to these features, contact the Owner or In-house Marketer account user.

To edit the campaign name rule for an agency or delete an agency from the list, click the […] icon. If you have deleted an agency and want to add that agency again, repeat the steps to add an agency from the start.

In the [Postback] tab, you can configure postbacks and determine which in-app events and attribution results to send as postbacks. The data collected with the Airbridge SDK and tracking links enables you to optimize campaigns and make strategic decisions about budget allocation.

For more details on postback settings, refer to this article.

Take note of the items below before proceeding with Unity Ads integration.