# 将 Singular 与 Unity 集成

> 在 Singular 后台中激活 Unity Ads 集成，启用完整数据共享，并映射事件。

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

设置 Singular 作为 Unity 用户获取广告系列的移动端成效衡量合作伙伴 (MMP)。集成包括以下设置任务：

* 在 Singular 后台中激活 Unity Ads。
* 配置数据共享设置。
* 映射安装后事件。

如需了解最新的 Singular 集成信息，请查阅 [Singular 帮助中心](https://support.singular.net/hc/en-us/articles/360028964651-Unity-Ads-Attribution-Integration)。

## 先决条件##prerequisites

在设置前，请确保满足以下要求：

* 在 [Unity User Acquisition（用户获取）后台](https://cloud.unity.com/acquire)中至少[添加](../../getting-started/add-an-app#add-an-app-to-the-dashboard)一个 app。
* 从用户获取后台中获取您的 [Game ID](../../getting-started/locate-advertiser-credentials#game-id)。
* 下载最新版本的 [Singular SDK](https://github.com/singular-labs/Singular-Unity-SDK)。

## 将 Unity 与 Singular 集成##integrate-unity-with-singular

按以下步骤在 [Singular 后台](https://app.singular.live/dashboard)中集成 Unity Ads：

### 在 Singular 后台中激活 Unity Ads##activate-unity-ads-in-the-singular-dashboard

1. 转到 **Attribution Setup（归因设置）** > **Partner Configuration（合作伙伴配置）**。
2. 选择 **Add a Partner（添加合作伙伴）**。搜索并选择 **Unity Ads**。
3. 在 [Unity Ads Game ID](../../getting-started/locate-advertiser-credentials#game-id) 字段中输入您的广告主 **Game ID**。

> **Note:**
>
> 请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。

### 配置数据共享设置##configure-data-sharing-settings

若要配置数据共享设置，请按以下步骤操作：

1. 在 \*\*Attribution Postbacks & Settings（归因回传及设置）\*\*选项卡中，转到 \*\*Attribution Postbacks（归因回传）\*\*表格。
2. 在 \*\*Attribution Event（归因事件）\*\*列中，勾选 \*\*Install（安装）\*\*复选框。
3. 在同一行中，选择以下复选框：

* **Send View Through（发送查看归因）**
* **Send All（发送全部）**
* **Send Fraud Postbacks（发送欺诈回传）**

![Singular 后台中的 ＂Attribution Postbacks & Settings＂（归因回传及设置）选项卡。](/api/media?file=/user-acquisition/media/images/singular-integration-attribution-settings.png)

### 映射安装后事件##map-post-install-events

要映射事件，请按以下步骤操作：

1. 在 \*\*In app Events Postback（应用内事件回传）\*\*选项卡中，从 \*\*Revenue Events Postbacks（收入事件回传）\*\*下拉菜单中选择 **Send all ad monetization events（发送全部广告变现事件）**。

> **Important:**
>
> Singular 是唯一支持同时发送全部变现事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 \*\*Revenue Events Postbacks（收入事件回传）\*\*下拉菜单中选择 **Send all ad monetization events（发送全部广告变现事件）**，并在 \*\*SDK Event Name（SDK 事件名称）\*\*下拉菜单中选择 **`__REVENUE__*`**。

![Singular 集成设置中的“Revenue Events Postbacks”（收入事件回传）选项。](/api/media?file=/user-acquisition/media/images/singular-send-all-monetization-events.png)

2. 要映射事件，请在 **SDK Event Name（SDK 事件名称**）列中选择您的 Singular 事件，并将其映射到 **Event Name（事件名称**）列的 Unity 事件，如下所示：

| * `__iap__`
* `custom_purchase_event_name` | `purchase`   |                                                                                                                               |
| ------------------------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `__REVENUE__*`                             | `ad_revenue` | 要通过 Singular 发送广告收入事件，请确保在事件表上方的 \*\*Revenue Events Postbacks（收入事件回传）\*\*下拉菜单中选择 Send all ad monetization events（发送全部广告变现事件）。 |
| `__SESSION__`                              | `session`    |                                                                                                                               |

3. 若要共享整个用户群的数据，请为每个事件勾选 \*\*Send all（发送全部）\*\*复选框。
4. 在 \*\*Postback Window Starting Point（回传窗口起始点）\*\*列，为每个事件选择 **Unlimited（无限）**。
5. 如果您拥有 Singular [Enterprise（企业）](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting#in_app_event_postbacks)帐户，请将 \*\*Postback Window (days)（回传窗口（天））\*\*设置为 **Unlimited（无限）**。否则，将窗口设置为 `30` 天。
6. 为每一行勾选 \*\*Include Revenue（包含收入）\*\*复选框。

![Singular 集成工作流程的“In app Events Postback”（应用内事件回传）选项卡。](/api/media?file=/user-acquisition/media/images/singular-in-app-postback-tab.png)