Integrate Tenjin with Unity
Activate the Unity Ads integration in the Tenjin dashboard and enable full data-sharing.
Read time 3 minutesLast updated 16 days 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.
- Copy credentials from the Unity Dashboard.
- Activate Unity Ads in the Tenjin dashboard.
- Configure data-sharing settings.
Prerequisites
Before setup, ensure you meet the following requirements:- Add at least one app in the Unity User Acquisition dashboard.
- Enable Organization Owner or Organization Manager access in the Unity Dashboard. Refer to User types, roles and permissions for more information.
- Download the latest version of the Tenjin SDK.
Integrate Unity Ads with Tenjin
Complete the following steps to integrate Tenjin with your User Acquisition campaign:Copy credentials from the Unity Dashboard
You need the following Unity account credentials to complete your Tenjin integration:Game ID
To retrieve your Game ID from the Apps page of the User Acquisition dashboard, follow these steps:- From the dashboard left navigation menu, go to Apps. The provided table lists each of your organization's apps. Following each app name, the dashboard displays the app platform and Game ID.
- Select the Copy symbol next to the ID to copy it to your clipboard.
- Optionally, hover over the app name to copy the Campaign Set ID and Store ID as well.
Note
Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.
Activate Unity Ads in the Tenjin dashboard
To integrate Unity with Tenjin, follow these steps in the Tenjin dashboard:- Go to the Configure tab and select Channels.
- Search for Unity Ads in the Marketing Channel Name field.
- In the New Marketing Channel setup for Unity Ads, enter the Unity account credentials you copied from the Unity dashboard and give your account a name.
- In the Tenjin navigation menu, go to the Campaigns tab and select Create Campaign.
- Select Unity Ads from the Marketing Account dropdown.
- Choose your app from the App dropdown and give your campaign a descriptive Name.
- When the system prompts you with a Callback to be created message, follow the provided link to continue and generate an attribution link.
Configure data-sharing settings
With Tenjin, configuring the data-sharing settings also maps your in-app events. To configure data-sharing settings and map events with Tenjin, do the following as you finish the activation workflow:- After you follow the link in the Callback to be created message, select Unity Ads from the Channels and Partners dropdown.
- In the Channel callbacks section, activate the following toggles:
- Unity Ads ad revenue
- Unity Ads app open
- Unity Ads IAP
- Unity Ads install
Important
Don't map ad revenue events as In-App Purchase events. If your Tenjin account supports ad revenue data-sharing, send this data as a dedicated Ad Revenue Impression event.If your account doesn't support ad revenue data-sharing, don't send ad revenue as a different event type, as this event mismatching can cause campaign optimization to stop working.
- For each event callback, select all users from the User filter dropdown.
