# 与 Singular 集成

> 通过集成 Singular 作为移动端成效衡量合作伙伴，与 Tapjoy Offerwall 共享用户参与度和广告系列数据。

本指南将说明如何在 Singular 后台中设置新的 Offerwall 广告系列。

如需其他相关指导，请参阅 Singular 文档中的 [Tapjoy 设置指南](https://support.singular.net/hc/en-us/articles/360028797152-Tapjoy-Attribution-Integration)和[有关如何设置合作伙伴的一般说明](https://support.singular.net/hc/en-us/articles/360053018851)。

## Tapjoy 广告系列配置##tapjoy-campaign-configuration

1. 登录 Singular 后台。
2. 选择左侧菜单中的 **Attribution** > **Partner Configuration**。
3. 在过滤框中搜索“Tapjoy”。
4. 选择 **Add app Site**（添加应用）。
5. 在下拉选单中，选择要配置的应用。**注意：每个应用需单独配置。**
6. 在 `Tapjoy App ID` 字段下输入 Tapjoy 生成的 ID。
7. 在 `Attribution Postback`（归因回传）下，选中“Install（安装）”归因事件。
8. 在右侧，选中 `Send All`（全部发送）。
9. 单击 **（下一**步）继续添加收入事件，如下文的“IAP 和广告收入配置”部分中所述。

![Singular 后台显示应用内购追踪。](/api/media?file=/grow/media/images/singular_iap_screenshot.png)

## 用于计算 ROAS 的 IAP 和广告收入配置##iap-and-ad-revenue-configuration-for-roas

### Singular IAP 设置##singular-iap-setup

> **Note:**
>
> * 如果要将 IAP 和广告收入数据都发送给 Tapjoy，建议**不要**使用常规 `__ REVENUE__` 事件名称来同时捕获 IAP 和广告收入数据。
> * 这是因为 `__ REVENUE__` 事件同时包含购买和广告收入事件，所以将这两种类型的收入映射到同一个 Tapjoy Engagement ID 可能会导致问题。
> * 相反，建议单独映射 IAP 和广告收入。例如，使用 `__ IAP__` 映射 IAP 事件，使用 `__ ADMON_USER_LEVEL_REVENUE__` 映射广告收入事件。

1. 在 `In app Event Postback`（应用内事件回传）部分下，添加 IAP 事件。建议使用事件名称 `__ IAP__`。
2. 在 `Tapjoy App ID or Engagement ID`（Tapjoy App ID 或 Engagement ID）列中添加相应的 Tapjoy Engagement ID。
3. 选中 `Send All`（发送全部）。
4. 选中 `Include Revenue`（包括收入）复选框。
5. 添加所有事件并映射 ID 后，选择 **保存**。

如需了解更多信息，请参阅 Singular 文档中的[应用内事件](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting?navigation_side_bar=true#revenue_event)。

![Singular 后台中的回传配置。](/api/media?file=/grow/media/images/singular_postbacks_screenshot.png)

### Singular 广告收入设置##singular-ad-revenue-setup

1. 在 `In app Event Postback`（应用内事件回传）部分下，使用事件名称 `__ ADMON_USER_LEVEL_REVENUE__` 添加广告收入事件。
2. 在 `Tapjoy App ID or Engagement ID`（Tapjoy App ID 或 Engagement ID）列中添加相应的 Tapjoy Engagement ID。
3. 选中 `Send All`（发送全部）。
4. 选中 `Include Revenue`（包括收入）复选框。
5. 添加所有事件并映射 ID 后，选择 **保存**。

如需了解更多信息，请参阅 Singular 文档中的 [Onboarding Guide for Ad Revenue Attribution（广告收入归因入门指南）](https://support.singular.net/hc/en-us/articles/4418187811611-Onboarding-Guide-for-Ad-Revenue-Attribution)。
