> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Unity Ads
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.
## Collecting Data with Tracking Links
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](/en/guides/creating-a-new-tracking-link)
* [Tracking Link Management](/en/guides/tracking-link-management)
**Attention**
Set up postback before using tracking links. Postback must be set up before data collection to ensure all collected data is sent to the ad channel. If not, data collected through tracking links will not be sent to the ad channel.
## Attribution Rules
In the **\[Attribution Rules]** tab, you can configure the lookback window and attribution window for Unity Ads. Click **Go to edit page** to move to the **\[Management]>\[Attribution Rules]** page, where you can edit attribution rules.
For detailed instructions on configuring the lookback window and attribution window, refer to this [article](/en/guides/setting-attribution-window).
## Cost Integration Setup
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.
### Get credentials from Unity Ads
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](https://docs.unity3d.com/2022.3/Documentation/Manual/OrgsManagingyourOrganization.html).
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.
If you already have a service account, move on to the next step.
4. 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**.
5. Get your Key ID and Secret Key. Save the Secret Key as you won’t be able to access it again.
### Assign an organization role in Unity Ads
**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 credentials to Airbridge
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.
### Manage cost integration
Turn off the toggle to pause the integration. Airbridge stops collecting cost data once the integration is paused.
Any data collected before the pause remains available in Airbridge reports.
Airbridge retains the credentials of the integrated account, so you can resume the integration at any time by turning the toggle on. However, deleting the integrated account removes these credentials.
Select the account from the integrated account list and click **Delete** to remove the account. To re-integrate the account after deletion, set up the integration from the beginning.
### Integration status
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.
| Status | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Waiting | Integration set up successfully. Pending data import. This may take up to 4 hours. |
| Success | Import complete. New data received from the ad channel. The **\[Last Updated]** timestamp reflects the latest import. |
| No new data | Import complete, but no new data was available from the ad channel. Check again at the next import. |
| Failed | Import failed. Possible causes: - The ad channel API is not responding. - The ad account details are incorrect. - The ad channel permissions are not configured correctly. |
* Frequency: Every 4 hours, 6 times a day, starting at 3:00 PM UTC
* Import times: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM UTC
* Data range: Current day (D-0) to 6 days ago (D-6)
**\[Last Updated]** shows the last time Airbridge actually received the data.
### **View cost data in Airbridge**
The data pulled from Unity Ads can be viewed in the Airbridge reports using the following metrics and GroupBy options.
| Metrics | Description |
| --------------------- | ---------------------------------------------------- |
| Clicks (Channel) | The number of clicks provided by the ad channel |
| Impressions (Channel) | The number of impressions provided by the ad channel |
| Cost (Channel) | The ad spend provided by the ad channel |
**Difference between Clicks and Clicks (Channel)**
Both **Clicks** and **Clicks (Channel)** show click count, but the data source differs:
* **Clicks**: Collected through Airbridge tracking links
* **Clicks (Channel)**: Provided by the ad channel
Any metric with **(Channel)** in its name represents data provided by the integrated ad channel. The same applies to **Impressions** and **Impressions (Channel)**.
**Note**
Use the groupBys below to break down cost data in Airbridge reports. Available groupBys vary by ad channel.
###### Touchpoint
| GroupBy | Description |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| Channel | The media source of the winning touchpoint |
| Campaign | The name of the campaign of the winning touchpoint |
| Ad Group | The name of the ad group of the winning touchpoint |
| Ad Creative | The name of the ad creative of the winning touchpoint |
| Term | The term, or the search keyword, of the winning touchpoint (Only available for search ads or keyword ads) |
| Campaign ID | The unique ID assigned to the campaign of the winning touchpoint |
| Ad Group ID | The unique ID assigned to the ad group of the winning touchpoint |
| Term ID | The unique ID assigned to the term, or the search keyword, of the winning touchpoint |
| Ad Account ID | The unique ID assigned to the ad account of the winning touchpoint |
| Sub Publisher | The second-tier media source of the winning touchpoint |
###### Device
| GroupBy | Description |
| ------- | --------------------------------------------------- |
| Country | The country code for the mobile device |
| OS Name | The operating system installed on the mobile device |
###### Event Datetime
| GroupBy | Description |
| ---------------------- | -------------------------------------------------------------------- |
| Event Hour | The hour the event occurred in a 24-hour format |
| Event Date | The day the event occurred (YYYY-MM-DD) |
| Event Year | The year the event occurred (YYYY) |
| Event Month | The month the event occurred (MM) |
| Event Week | The week the event occurred (WW) |
| Event Day of the month | The day of the month the event occurred (DD) |
| Event Day of the week | The day of the week the event occurred in three-letter abbreviations |
## Agency Settings
Manage the access permission of the agencies and have control over which agency has access to your Unity Ads campaign data.
* [Agency Settings](/en/guides/meta-business-agency-settings)
## Postback Settings
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](/en/guides/postback-settings).
## Attention
Airbridge pulls the cost data from the past 7 days, every 4 hours, 6 times a day starting at 3:00 PM (UTC). As the updates are not real-time, there may be data discrepancies between Airbridge and the ad channel, depending on the time of reporting.
The **Cost (Channel)** metric, which shows your ad spend reported by the ad channel, displays value only when used with specific GroupBys.
Below are the GroupBys that can be used in the Actuals Report to view data with the metric:
* Channel
* Campaign
* Ad Group
* Ad Creative
Depending on the data reported, the metric may not display any value even if you use the GroupBys above.
The data pulled via cost integration is provided by the app time zone and app standard currency set within Airbridge.
To minimize data discrepancy, align your app’s currency and time zone settings in your Airbridge dashboard and your ad channel’s dashboard.
* [App Time Zone Setup](/en/guides/set-app-timezone)
* [App Standard Currency Setup](/en/guides/set-app-standard-currency)
Once the cost integration is enabled, the following campaign details are advised not to be edited to avoid any error in pulling data into Airbridge.
* Campaign name
* Ad group name
* Ad creative name
4. 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**.
5. Get your Key ID and Secret Key. Save the Secret Key as you won’t be able to access it again.
### Assign an organization role in Unity Ads
### Submit credentials to Airbridge
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.
### Manage cost integration
## Attention