# Integrate Singular with Unity

> Activate the Unity Ads integration in the Singular dashboard, enable full data-sharing, and map events.

> **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 Singular as your Mobile Measurement Partner (MMP) for Unity User Acquisition campaigns. Integration includes the following setup tasks:

* Activate Unity Ads in the Singular dashboard.
* Configure data-sharing settings.
* Map post-install events.

For the most up-to-date Singular integration information, consult the [Singular Help Center](https://support.singular.net/hc/en-us/articles/360028964651-Unity-Ads-Attribution-Integration).

## Prerequisites

Before setup, ensure you meet the following requirements:

* [Add](../../getting-started/add-an-app#add-an-app-to-the-dashboard) at least one app in the [Unity User Acquisition dashboard](https://cloud.unity.com/acquire).
* Retrieve your [Game ID](../../getting-started/locate-advertiser-credentials#game-id) from the User Acquisition dashboard.
* Download the latest version of the [Singular SDK](https://github.com/singular-labs/Singular-Unity-SDK).

## Integrate Unity with Singular

Complete the following steps to integrate Unity Ads in the [Singular dashboard](https://app.singular.live/dashboard):

### Activate Unity Ads in the Singular dashboard

1. Go to **Attribution Setup** > **Partner Configuration**.
2. Select **Add a Partner**. Search for and select **Unity Ads**.
3. Enter your advertiser [Game ID](../../getting-started/locate-advertiser-credentials#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:

1. In the **Attribution Postbacks & Settings** tab, go to the **Attribution Postbacks** table.
2. Select the **Install** checkbox in the **Attribution Event** column.
3. In the same row, select the following checkboxes:

* **Send View Through**
* **Send All**
* **Send Fraud Postbacks**

![The Attribution Postbacks & Settings tab of the Singular dashboard](/api/media?file=/user-acquisition/media/images/singular-integration-attribution-settings.png)

### Map post-install events

To map events, follow these steps:

1. 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 **`__REVENUE__*`** from the **SDK Event Name** dropdown.

![The Revenue Events Postbacks options in the Singular integration setup](/api/media?file=/user-acquisition/media/images/singular-send-all-monetization-events.png)

2. 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:

| * `__iap__`
* `custom_purchase_event_name` | `purchase`   |                                                                                                                                                                   |
| ------------------------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `__REVENUE__*`                             | `ad_revenue` | 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. |
| `__SESSION__`                              | `session`    |                                                                                                                                                                   |

3. To share data from your entire user base,  select the **Send all** checkbox for each event.
4. In the **Postback Window Starting Point** column, select **Unlimited** for each event.
5. If you have a Singular [Enterprise](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting#in_app_event_postbacks) account, set the **Postback Window (days)** to **Unlimited** . Otherwise, set the window to `30` days.
6. Select the **Include Revenue** checkbox for each row.

![The In app Events Postback tab of the Singular integration workflow](/api/media?file=/user-acquisition/media/images/singular-in-app-postback-tab.png)