Integrate Singular with Unity
Activate the Unity Ads integration in the Singular dashboard, enable full data-sharing, and map events.
Read time 2 minutesLast updated 15 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.
- Activate Unity Ads in the Singular dashboard.
- Configure data-sharing settings.
- Map post-install events.
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 Singular SDK.
Integrate Unity with Singular
Complete the following steps to integrate Unity Ads in the Singular dashboard:Activate Unity Ads in the Singular dashboard
- Go to Attribution Setup > Partner Configuration.
- Select Add a Partner. Search for and select Unity Ads.
- Enter your advertiser Game ID in the Unity Ads Game ID field.
Note
Enter your Game ID exactly as shown in the User Acquisition dashboard. Mismatched Game IDs prevent Unity from receiving events correctly.
Configure data-sharing settings
To configure data-sharing settings, follow these steps:- In the Attribution Postbacks & Settings tab, go to the Attribution Postbacks table.
- Select the Install checkbox in the Attribution Event column.
- In the same row, select the following checkboxes:
- Send View Through
- Send All
- Send Fraud Postbacks
Map post-install events
To map events, follow these steps:- In the In app Events Postback tab, select Send all ad monetization events from the Revenue Events Postbacks dropdown.
Important
Singular is the only MMP that supports sending all monetization events together. To send ad revenue events with Singular, ensure that you select Send all ad monetization events from the Revenue Events Postbacks dropdown and select from the SDK Event Name dropdown.
__REVENUE__*
- To map events, select your Singular events in the SDK Event Name column and map them to Unity events in the Event Name column as follows:
Singular SDK Event name | Unity Event Name | Notes |
|---|---|---|
| | |
| | Important To send ad revenue events with Singular, ensure that you select Send all ad monetization events from the Revenue Events Postbacks dropdown above the event table. |
| |
- To share data from your entire user base, select the Send all checkbox for each event.
- In the Postback Window Starting Point column, select Unlimited for each event.
- If you have a Singular Enterprise account, set the Postback Window (days) to Unlimited . Otherwise, set the window to days.
30 - Select the Include Revenue checkbox for each row.
