Integrate Adjust with Unity
Activate the Unity Ads integration in the Adjust dashboard, enable full data-sharing, map events, and create attribution links.
Read time 2 minutesLast updated a month ago
Important
The following documentation discusses products or services (“Third-party Products”) not developed, owned, or operated by Unity.
This information might be outdated or incomplete and is provided for your convenience.
Your use of any Third-party Product is subject to its own terms.
Unity makes no warranties regarding these products and isn't liable for any damages or losses arising from their use, including issues related to content, advertising, or materials from Third-party providers.
Set up Adjust as your Mobile Measurement Partner (MMP) for Unity User Acquisition campaigns. Integration includes the following setup tasks:
- Activate Unity Ads in the Adjust dashboard.
- Choose data to share with Unity.
- Map post-install events.
- Create an attribution link.
For the most up-to-date Adjust integration information, consult the Adjust Help Center.
Prerequisites
Before setup, ensure you meet the following requirements:
- Add at least one app in the Unity User Acquisition Dashboard.
- Retrieve your Game ID from the User Acquisition Dashboard.
- Download the latest version of the Adjust SDK (v4.0.0. or later).
- Enable Adjust account permissions: Admin, Editor, or Custom Editor. Refer to Adjust's Manage users documentation for instructions.
Integrate Unity with Adjust
Complete the following steps to integrate Adjust with your User Acquisition campaign:
Activate Unity Ads in the Adjust dashboard
To activate the integration with Unity Ads, follow these steps:
- In the Adjust dashboard, go to Campaign Lab > Partners.
- Select + New partner and search for Unity Ads.
- Choose your app and select Next.
- Enter your advertiser Game ID in the GAME ID field. To copy your Game ID from the Unity Dashboard, refer to the following steps:
To copy your Game ID from the User Acquisition Dashboard, follow these steps:
- Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
- Scroll or search to locate the desired app.
- Select Settings (
) at the end of the app row to open the app details page. - Go to the MMP settings section.
- Select copy (
) next to Game ID to copy the ID to your clipboard.
Note
Enter your Game ID exactly as shown in the User Acquisition Dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.
Choose data to share with Unity
To select which data Adjust can share with your campaign, follow these steps in the Adjust integration:
- From the What sources of data do you want to share options, select Data from all attribution sources.
- From the What other data do you want to share? section, select all options:
- Sessions
- Uninstalls and reinstalls
- In-app revenue
- Parameters
- In the Parameters data options, select Send all parameters.
Select all Adjust data-sharing options
Important
You must share all data types to enable Return on Ad Spend (ROAS) and Event optimization campaigns.
Map events and parameters
To share in-app events with your User Acquisition campaign, do the following in the Adjust integration:
-
Go to Data sharing > Map your events and select + Map event.
-
Choose the event you want Adjust to share with Unity from the Adjust event list.
Adjust event
-
To map the same events for all platforms, select Use global mapping.
-
Select or enter the Unity event that corresponds with the correct Adjust event in the Partner event > Name field.
Partner event
Refer to the following table for correct Adjust event mapping:
Event type | Adjust App event | Unity Partner event | Mapping notes |
|---|---|---|---|
| In-app purchase (IAP) | | | - |
| Ad revenue | | | If your Adjust account supports ad revenue data-sharing, send this data as a dedicated Otherwise, don't send ad revenue events. Mapping ad revenue events as other event types can cause campaign optimization to stop working. |
| Milestone completion | | | You can use any custom defined event name for the Adjust App event. Ensure that you use the provided formatting for the partner event Name. The |
| Session |
| | Session events for Retention campaigns don't require event mapping. |
Create an attribution link
To create an attribution link, do the following in the integration setup:
- On the Setup review page, select Create link.
- Copy the attribution link for integration in the Unity dashboard.