# 集成故障排除

> 常见移动端测量合作伙伴(MMP)集成错误的故障排除。

将移动端衡量合作伙伴 (MMP) 与用户获取广告系列集成时，后台会检查广告系列是否成功接收数据。后台会验证以下数据共享指标：

* 您的广告系列会在投放后两天内收到安装数据。
* 您的广告系列会在投放后的七天内收到安装后事件数据。

如果您的广告系列未能通过上述任何验证检查，后台会以集成报错消息标记您的广告系列。请参阅以下各节以信息如何解决这些错误。

> **Important:**
>
> 本故障排除指南涵盖以下 MMP 的集成问题：
>
> * Adjust
> * Airbridge
> * AppsFlyer
> * 字节混叠
> * Singular
> * Tenjin
>   有关与 AppsFlyer 集成的其他问题，请参阅 [AppsFlyer 集成验证](/grow/acquire/partner-integration/appsflyer/appsflyer-required-integration-fixes.md)文档。

## 两天内没有安装数据##no-install-data-in-two-days

如果您的广告系列在投放后的两天内未收到安装数据，可能会对效果和归因产生负面影响。后台会标记此问题并显示以下报错信息：

```text
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性能。解决此问题可确保准确的跟踪和交付：广告系列必须在发布后 2 天内收到至少一次安装回传。
```

### 原因##cause

如果 MMP 集成配置错误，广告系列可能无法累积安装数据。请参阅 MMP 指定的集成指南以了解分步集成说明。

### 解决方案##resolutions

请考虑以下两种分辨率以确保广告系列收到安装数据。

#### 从所有来源共享安装数据##share-install-data-from-all-sources

当您与 Unity 共享安装数据时，请确保包含整个用户群的数据，包括归因、未归因和自然安装。如需了解每种归因类型的定义，请参阅[归因介绍](/grow/acquire/partner-integration/attribution/introduction.md#attribution-types)。

每个 MMP 对此设置都有独特的术语。请参阅以下示例展示了在支持的 MMP 后台中如何从所有来源共享安装数据：

1. **Adjust**

   要共享所有用户底部的安装数据，请在 Adjust（调整）后台中执行以下步骤：

   1.转到 \*\*Campaign Lab（广告系列实验室）\*\*选项卡 > \*\*Partners（合作伙伴）\*\*页面。
   2.在 \*\*What sources of data do you want to share（您希望共享哪些数据来源）\*\*选项中，选择 **Data from all attribution sources（所有归因来源的数据）**。

2. **Airbridge**

   要共享所有用户底部的安装数据，请在 Airbridge Dashboard 中执行以下步骤：

   1.从顶部菜单栏中选择 **Organization**。
   2.在 **组织设置** 页面上，转到 **用户管理** > **机构**。
   3.在 **App** 列表中找到 app，然后选择 **Details**。如果您尚未为 app 授予 app 访问权限，请参阅 Airbridge [组织级用户管理](https://help.airbridge.io/en/guides/organization-level-user-management#granting-app-access-to-agency-users)文档。
   4.从 app Access 设置\*\* 中选择 **编辑 以打开访问设设置话框。
   5.转到对话框的**未归因事件数据\*\*部分。
   6.启用 **Unnattributed 事件 Data** 开关。
   7.选择 **保存**。

3. **AppsFlyer**

   使用以下步骤在 AppsFlyer 后台中共享所有来源的数据：

   1.转到 \*\*Integration（集成）\*\*选项卡 > \*\*Default postbacks（默认回传）\*\*部分。
   2.在 \*\*for users from（用户来源）\*\*下拉选单中，选择 **All media sources, include organic（所有媒体来源，包括自然流量）**。

4. **ByteBrew**

   要共享所有用户底部的安装数据，请在 ByteBrew Dashboard 中执行以下步骤：

   1.在 **ByteBrew** 集成设置的 **Install Settings** 选项卡中，转到 **发送所有安装事件 from** 部分。
   2.选择 **All Partners and Organics**。

5. **Singular**

   要共享所有用户底部的安装数据，请在 Singular Dashboard 中执行以下步骤：

   1.转到 \*\*Attribution Postbacks & Settings（归因回传及设置）\*\*选项卡 > \*\*Attribution Postbacks（归因回传）\*\*表格。
   2.启用 \*\*Send All（发送全部）\*\*复选框。

6. **Tenjin**

   要共享所有用户底部的安装数据，请在 Tenjin Dashboard 中执行以下步骤：

   1.转到应用的 \*\*Callbacks（回调）\*\*选项卡。
   2.在 \*\*User filter（用户筛选器）\*\*下拉菜单中，选择 **all users（所有用户）**。

#### 查看集成设置##review-integration-setup

请查看首选 MMP 的集成指南，确保其配置正确。请查看合作伙伴集成指南中的集成激活、广告主凭据和数据共享设置：

1. **Adjust**

   完成以下步骤，将 Adjust 和共享数据与 User Acquisition 广告系列正确集成：

   1. **Activate Unity Ads in the Adjust dashboard**

      若要启用与 Unity Ads 的集成，请按以下步骤操作：

      1.在 [Adjust dashboard](https://suite.adjust.com) 中，进入 **Campaign Lab** > **Partners**。
      2.选择 **+ New partner**，并搜索 **Unity Ads**。
      3.选择您的 app 并选择 **Next**。
      4.在 **Game ID** 字段中输入您的广告主 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

   2. **Configure data-sharing settings**

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

      1.在 \*\*What sources of data do you want to share（您希望共享哪些数据来源）\*\*选项中，选择 **Data from all attribution sources（所有归因来源的数据）**。
      2.在 **What other data do you want to share?** 选项中，选择 **Sessions** 和 **In-app revenue (from in app purchases)**。

      > **Important:**
      >
      > 必须使用这些数据共享设置才能启用 ROAS 和事件广告系列。

   3. **Map events and parameters**

      若要与您的用户获取广告系列共享应用内事件，请在 **Data sharing** > **Map your events** 中进行如下操作：

      1.选择 **+ Map event**。

      2.从 **Adjust event** 列表中选择要 Adjust 与 Unity 共享的事件。


      **Map Adjust events:**
      ![ Adjust 集成设置中的 Map Events to Share with Unity 对话框。](/api/media?file=/grow/media/images/adjust-map-event-to-share.png)

      3.按下表所示，选择或输入与正确 Adjust 事件对应的 Unity Ads 事件：

      > **Important:**
      >
      > 如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的 `ad_revenue` 事件发送。
      > 否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `purchase`），可能导致广告系列优化失效。

      | `purchase`             | `purchase`       |
      | ---------------------- | ---------------- |
      | `ad_revenue`           | `ad_revenue`     |
      | `{milestone_event}`    | `level_complete` |
      | * `session`
      * `launch` | `session`        |

      4.若要为所有平台映射相同事件，请选择 **Use global mapping**。

2. **Airbridge**

   按照以下步骤，将 Airbridge 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the Airbridge dashboard**

      要激活与 Unity Ads 的集成，请在 [Airbridge 后台](https://app.airbridge.io/app)中执行以下操作：

      1.转到 **Integration** > **Ad Channel Integration**。
      2.选择 **Unity Ads**。
      3.转到 **Postback** 选项卡。
      4.选择 **Postback Keys**，或启用 **发送回传** 开关。
      5.输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

   2. **Map the Airbridge SDK events with Unity Ads**

      要与您的用户获取广告系列共享[安装后](/grow/acquire/partner-integration/app-data/post-install-event-data.md.md)事件，请在 **Postback** 选项卡中执行以下操作：

      1.选择 **Postback event setup**（回传事件设置）。
      2.在 **App event** 列表中，选择您希望 Airbridge 与 Unity 共享的事件。
      3.按照下表，正确地选择或输入与 Airbridge 事件对应的 Unity Ads 事件。

      | 订单完成（App） | `purchase`       |
      | --------- | ---------------- |
      | 广告展示（应用）  | `ad_revenue`     |
      | 达成关卡（应用）  | `level_complete` |
      | 打开（应用）    | `session`        |

   3. **Configure data-sharing settings**

      要配置 Airbridge 数据共享设置，请在 **Postback** 选项卡中执行以下操作：

      1.在 **Attribution** 选项中，选择 **All events**。
      2.在 **Delivery rules** 设置中，选择 **First or All Events**。

3. **AppsFlyer**

   按照以下步骤，将 AppsFlyer 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the AppsFlyer dashboard**

      要在 [AppsFlyer 后台](https://hq1.appsflyer.com/auth/login)中激活 Unity Ads，请按照以下步骤操作：

      1.在 AppsFlyer 后台中，转到 **Collaborate** > **Partner Marketplace**。
      2.搜索 **Unity Ads** 并选择 **Set up integration**，在 **Integration** 选项卡中打开。
      3.激活 **Activate Partner** 开关。
      4.部分广告主在 **Integration** 选项卡中可能会有 **Advanced Privacy** 开关。如果您的后台包含此开关，请确保将其关闭。

      > **Important:**
      >
      > 如果在集成设置中激活了 \*\*Advanced Privacy（高级隐私）\*\*开关，appsFlyer 将无法与您的广告系列共享任何事件数据。


      **Advanced Privacy toggle:**
      ![AppsFlyer 集成设置中的“Advanced Privacy”（高级隐私）开关。](/api/media?file=/grow/media/images/appsflyer-advanced-privacy.png)

   2. **Configure general integration settings**

      在 AppsFlyer 中配置以下集成设置：

      **Configure general settings:**

      在 **Integration** 选项卡 > \*\*General 设置 部分中，执行以下操作：

      1.启用 \*\*Share organic/non-organic indication（共享自然/非自然来源指示）\*\*开关。


      **Share organic and non-organic:**
      !\[AppsFlyer 集成设置中的共享有机/非有机来源开关。]\(/grow/media/images/appsflyer-share- organic-non-organic.png)

      2.输入您的 Unity Ads [游戏 ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

      **Configure install attribution:**

      在 **Integration** 选项卡 > **Install attribution** 部分中，执行以下操作：

      1.将 \*\*Install engaged click-through lookback window（安装点击归因回溯窗口）\*\*的时间间隔设置为 **Days（天）**。
      2.使用滑块将回溯窗口的时长设置为 **2** 天。
      3.启用 \*\*Install view-through attribution（安装查看归因）\*\*开关。
      4.将 \*\*Install engaged view-through lookback window（安装查看归因回溯窗口）\*\*的时间间隔设置为 **Days（天）**。
      5.使用滑块将回溯窗口的时长设置为 **7** 天。


      **Set maximum lookback windows:**
      ![AppsFlyer 集成选项卡中的点击归因回溯窗口滑动条。](/api/media?file=/grow/media/images/appsflyer-install-attribution.png)

   3. **Configure data-sharing settings**

      在 AppsFlyer 中配置以下数据共享设置：

      **Configure default postbacks:**

      在 **Integration** 选项卡 > **Default postbacks** 部分，使用 **for users from** 下拉菜单为 **Install（安装）** 事件选择 **All media sources, including organic**。


      **AppsFlyer Default postbacks settings:**
      ![AppsFlyer Integration（集成）选项卡的“Default postbacks”（默认安装回传）部分。](/api/media?file=/grow/media/images/appsflyer-default-install-postbacks.png)

      **Configure in-app event settings:**

      在 **Integration** 选项卡 > app 事件 设置 部分中，执行以下操作：

      1.1. 在 **game\_id** 字段中输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。
      2.启用 \*\*In-app event postbacks（应用内事件回传）\*\*开关。
      3.将 \*\*In-app event postback window（应用内事件回传窗口）\*\*设置为 **lifetime（生命周期）**。


      **Lifetime postback windows:**
      ![AppsFlyer 集成选项卡中的生命周期应用内事件回传窗口。](/api/media?file=/grow/media/images/appsflyer-lifetime-postback-window.png)

      **Map events:**

      在 \*\*Integration（集成）\*\*选项卡 > \*\*In-app event postbacks（应用内事件回传）\*\*部分，将 mapsFlyer 事件映射到 Unity Ads 事件。

      您可以在 AppsFlyer 后台中映射任何已设置的应用内事件。请参阅 AppsFlyer 的 [应用内事件](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#predefined-event-names) 文档，了解 AppsFlyer 事件名称列表。

      > **Important:**
      >
      > 确保您的 **AppsFlyer 事件** 名称与应用代码中的事件标识符完全一致。如果事件映射错误，您的广告系列将忽略该数据。

      请参阅以下正确的事件映射示例：

      | `af_purchase`          | `purchase`       | 所有媒体来源，包括自然流量 | 数值及收入  |
      | ---------------------- | ---------------- | ------------- | ------ |
      | `milestone_event_name` | `level_complete` | 所有媒体来源，包括自然流量 | 数值及收入  |
      | `af_app_opened`        | `session`        | 所有媒体来源，包括自然流量 | 数值但无收入 |


      **AppsFlyer event mapping:**
      ![AppsFlyer 事件映射表。](/api/media?file=/grow/media/images/appsflyer-event-mapping.png)

      请确保做出如下选择：

      * 对所有事件，在 \*\*for users from（用户来源）\*\*下拉菜单中选择 **All media sources, including organic（所有媒体来源，包括自然流量）**。
      * 对于 \*\*Level Complete（关卡完成）\*\*和 \*\*Purchase（购买）\*\*事件，在 \*\*including（包含）\*\*下拉菜单中选择 **Values & revenue（数值及收入）**。
      * 对于 **Session events（会话事件）**，在 \*\*including（包含）\*\*下拉菜单中选择 **Values & no revenue（数值但无收入）**。

      **Enable ad revenue data:**

      > **Important:**
      >
      > 若要访问 AppsFlyer \*\*Revenue Settings（收入设置）\*\*菜单并与 Unity 分享广告收入数据，您需要订阅 AppsFlyer ROI360。有关详细信息和操作，请参阅 AppsFlyer 帮助中心的[广告收入归因](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 文档。

      若要与您的广告系列共享广告收入事件数据，请按以下步骤操作：

      1.前往 AppsFlyer 集成设置的 \*\*Ad revenue（广告收入）\*\*选项卡。
      2.启用 \*\*Get ad revenue data（获取广告收入数据）\*\*开关。


      **AppsFlyer Ad revenue toggle:**
      ![AppsFlyer 集成设置中的获取广告收入开关。](/api/media?file=/grow/media/images/appsflyer-get-ad-revenue.png)

      3.在 AppsFlyer 后台侧边菜单中，转到 **Settings（设置）** > **Revenue Settings（收入设置）**。
      4.在 \*\*Revenue settings（收入设置）\*\*页面的 \*\*Ad revenue（广告收入）\*\*选项卡中，选择 **New ad revenue integration（新建广告收入集成）**。
      5.在收入合作伙伴列表中选择 **Unity Ads**。
      6.在合作伙伴配置中，选择 \*\*Impression-level (via SDK) with Device-level (via S2S API)（广告展示级别（通过 SDK）与设备级别（通过 S2S API））\*\*作为上报类型。


      **Impression-level and Device-level ad revenue data:**
      ![AppsFlyer 后台中的广告收入设置。](/api/media?file=/grow/media/images/appsflyer-ad-revenue-setup.png)

      7.输入您的 API 凭据。在 **App Key** 字段中输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。如需从 Unity Dashboard（Unity 后台）获取 **Secret key（密钥）**，请参考以下步骤：

      **Retrieve your Secret key:**

      如需从 Unity Dashboard（Unity 后台）获取密钥，请按照以下步骤操作：

      1.在左侧导航菜单中，转到 **API Management（API 管理）**。
      2.选择 **Advertising Management API（广告管理 API）** > **Service account（服务帐户）**。


      **API Management:**
      ![Unity Ads User Acquisition（用户获取）后台的 API 管理页面](/api/media?file=/grow/media/images/api-service-account.png)

      3.如果没有服务帐户，请选择 **+ New（新建）**。如果已有服务帐户，请在表格中选择该帐户。
      4.在服务帐户页面，进入 \*\*Keys（密钥）\*\*部分。
      5.选择 \*\*+ Add key（添加密钥）\*\*以生成新密钥。
      6.选择 \*\*Secret key（密钥）\*\*后面的复制按钮，将 ID 复制到剪贴板。

      8. 返回 AppsFlyer 后台的 \*\*Integration（集成）\*\*选项卡。
         9。在 **In-app event postbacks**（应用内事件回传）部分，将广告收入事件映射到 `ad_revenue`。请参阅以下示例，了解正确的广告收入映射方式：

      | `af_ad_revenue` | `ad_revenue` | 所有媒体来源，包括自然流量 | 数值及收入 |
      | --------------- | ------------ | ------------- | ----- |

   4. **Set partner permissions**

      在 **Permissions** 选项卡中，配置以下权限设置：

      1.激活 **Toggle Ad Network Permissions** 开关，以启用所有其他开关。
      2.启用以下开关：

      * **配置集成**
      * **配置 app 内事件回传**
      * **访问留存率报告**
      * **访问汇总转化和应用内事件数据**
      * **访问聚合收入数据**
      * **查看验证规则**
      * **访问 Protect360 后台和原始数据**
      * **Access ad revenue raw data (UA signals)**（访问广告收入原始数据（UA 信号））

      如需了解每个权限的描述，请参阅 AppsFlyer 帮助中心的 [Permissions 选项卡](https://support.appsflyer.com/hc/en-us/articles/4410395957521-Set-up-an-integrated-partner#permissions-tab)文档。

4. **ByteBrew**

   完成以下步骤，将 ByteBrew 正确集成并与您的用户获取广告系列共享数据：

   1. **Activate Unity Ads in the ByteBrew dashboard**

      在 ByteBrew 后台中执行以下操作以激活 Unity Ads 集成：

      1.从后台导航菜单中选择您的应用。
      2.转到 **Attribution** > **Network Settings**，然后从网络列表中找到 **UnityAds**。
      3.在 **UnityAds** 旁边，选择 **Setup** 以打开 **Add Ad Network** 对话框。
      4.填写 **Network Settings** 字段。请参阅以下说明，了解如何在 User Acquisition（用户获取）后台中找到这些值：

      **API Key:**

      如需从用户获取后台获取 API 密钥，请执行以下操作：

      1.转到 **API Management page（API 管理页面）**。
      2.复制 \*\*Stats API v1.0（统计数据 API v1.0）\*\*部分中的 \*\*API Key（API 密钥）\*\*值。

      **Game ID:**

      如需从 **User Acquisition** 后台的 **Apps** 页面获取您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)，请按照以下步骤操作：

      1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
      2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。

      **Organization ID:**

      如需从用户获取后台获取组织 ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面。
      2.从设置的 \*\*Organization（组织）\*\*部分中复制 \*\*Organization ID（组织 ID）\*\*值。

      **Organization Core ID:**

      如需从用户获取后台的 \*\*Settings（设置）\*\*页面获取 Organization core ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面的 \*\*Organization（组织）\*\*部分。
      2.复制 \*\*Organization core ID（组织核心 ID）\*\*旁边的数字 ID。

   2. **Configure data-sharing settings**

      要使用 ByteBrew 配置数据共享设置，请在集成流程的 **Install 设置** 选项卡中执行以下操作：

      1.要启用查看归因，请选择 \*\* Enable view through tracking\*\* 复选框，并配置查看回溯窗口。ByteBrew 默认会生成点击归因链接。
      2.在以下 **Install Settings** 字段中配置归因回溯期 Windows：

      | **点击归因窗口** | 是 | 使用 **Days** 选择器设置用户点击广告后多少天安装可归因。        | 最大点击归因回溯期为 30 天。建议的最佳做法是将点击归因回溯期设置为七天或更长时间，以便准确归因。 |
      | ---------- | - | ---------------------------------------- | -------------------------------------------------- |
      | **查看归因窗口** | 否 | 使用 \*\*Days（天数）\*\*选择器设置用户观看广告后多少天安装可归因。 | 最大查看归因回溯期为 7 天。建议的最佳做法是将查看归因回溯期设置为一天或更长时间，以便准确归因。  |

      有关归因查找选项的更多信息，请参阅 ByteBrew 数据共享参考的\[归因查找设置]\(/grow/acquire/partner-integration/bytebrew/data-sharing#attribution-lookback- settings)部分。

      3.在 **发送所有安装事件 from** 部分中，选择传递应用所有安装的互动数据（包括未归因的安装数据）还是仅传递归因于 Unity 的互动数据。请从以下选项中进行选择：

      * **仅此合作伙伴**
      * **所有合作伙伴和组织**
      * **该合作伙伴及有机**

      有关安装音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的[归因数据源](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md#attribution-data-sources)部分。

   3. **Map events**

      要使用 ByteBrew 映射安装后事件，请在集成流程的 **Postback 设置** 选项卡中执行以下操作：

      1.要添加需要传递给 Unity 的安装后事件，请选择 **+ 添加回传事件**，然后从以下选项中进行选择：

      * 广告观看事件
      * User app Open Event（用户应用打开事件）
      * 应用内购事件

      有关回传事件选项的更多信息，请参阅 ByteBrew 数据共享参考中的[安装后事件数据共享部分](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md)。

      > **Important:**
      >
      > 不要在应用代码中定义新用户事件。ByteBrew 默认使用 \*\*User App Open Event（用户应用打开事件）\*\*选项来追踪新用户事件。如需了解更多信息，请参阅 [ByteBrew 开发者中心](https://docs.bytebrew.io/attribution-setup/attribution-unityads) 归因文档。

      2.在 **Postback Events Settings** 部分中，选择是通道所有 app 的安装后事件数据（包括[未归因](/grow/acquire/partner-integration/attribution/introduction.md.md)安装数据），还是仅通道归因于 Unity 的数据。请从以下选项中进行选择：

      * 仅从此合作伙伴发送
      * Send from all Networks and Organics（发送所有网络和自然流量的数据）
      * Send only from this Partner and Organics（仅发送此合作伙伴和有机流量的数据）

      有关安装后事件音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的[回传数据源](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md#postback-data-sources)部分。

      3.在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。有关如何在 User Acquisition（用户获取）后台中集成这些 URL 的说明，请参阅[与 Unity 集成归因链接](/grow/acquire/partner-integration/attribution/integrate-links.md.md)。
      4.选择 **Finish** 以完成集成。

5. **Singular**

   完成以下步骤，将 Singular 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the Singular dashboard**

      1.转到 **Attribution Setup** > **Partner Configuration**。
      2.选择 **Add a Partner**。搜索并选择 **Unity Ads**。
      3.在 **Unity Ads 游戏 ID** 字段中输入您的广告主 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

   2. **Configure data-sharing settings**

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

      1.在 **Attribution Postbacks & Settings** 选项卡中，转到 **Attribution Postbacks** 表格。
      2.在 **Attribution Event** 列中，勾选 **Install** 复选框。
      3.在同一行中，选择以下复选框：

      * **发送视图**
      * **发送全部**
      * **发送欺诈回传**


      **Send View Through, All, and Fraud Postbacks:**
      ![The Attribution Postbacks & Settings tab of the Singular dashboard.](/api/media?file=/grow/media/images/singular-integration-attribution-settings.png)

   3. **Map post-install events**

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

      1.在 **In app Events Postback** 选项卡中，从 **Revenue Events Postbacks** 下拉菜单中选择 **发送全部广告变现事件**。

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


      **Send all ad monetization events:**
      ![Singular 集成设置中的 Revenue Events Postbacks 选项。](/api/media?file=/grow/media/images/singular-send-all-monetization-events.png)

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

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

      3.若要共享整个用户群的数据，请为每个事件勾选 **发送全部** 复选框。
      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（包含收入）\*\*复选框。


      **Include revenue:**
      ![Singular 集成工作流程的 In-App Events Postback 选项卡。](/api/media?file=/grow/media/images/singular-in-app-postback-tab.png)

6. **Tenjin**

   完成以下步骤，将 Tenjin 正确集成并与您的用户获取广告系列共享数据：

   1. **Copy credentials from the Unity Dashboard**

      您需要以下 Unity 帐户凭据来完成 Tenjin 集成：

      **Game ID:**

      如需从 **User Acquisition** 后台的 **Apps** 页面获取您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)，请按照以下步骤操作：

      1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
      2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。
      3.您也可以将鼠标悬停在应用名称上，复制 **Campaign Set ID（广告系列集 ID）** 和 **Store ID（商店 ID）**。

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

      **Secret Key and Key ID:**

      > **Note:**
      >
      > 只有**组织所有者**或**组织管理员**可以创建服务帐户和密钥。更多信息请参阅[用户类型、角色和权限](/cloud/organizations/roles-and-permissions.md.md)。

      要在**用户获取**后台获取您的密钥和密钥 ID，请按以下步骤操作：

      1.在左侧导航菜单中，转到 **API Management（API 管理）**。

      2.选择 **Advertising Management API（广告管理 API）** > **Service account（服务帐户）**。


      **API Management:**
      ![用户获取后台的 API 管理页面](/api/media?file=/grow/media/images/api-service-account.png)

      3.如果没有服务帐户，请选择 **+ New（新建）**。如果已有服务帐户，请在表格中选择该帐户。

      4.在服务帐户页面，进入 \*\*Keys（密钥）\*\*部分。

      5.选择 \*\*+ Add key（添加密钥）\*\*以生成两组密钥。

      6.选择 \*\*Key ID（密钥 ID）\*\*和 \*\*Secret key（密钥）\*\*后的复制按钮，复制两组凭据。

      **Organization core ID:**

      如需从用户获取后台的 \*\*Settings（设置）\*\*页面获取 Organization core ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面的 \*\*Organization（组织）\*\*部分。
      2.复制 \*\*Organization core ID（组织核心 ID）\*\*旁边的数字 ID。

      > **Note:**
      >
      > 请确保复制纯数字的**Organization core ID**，而不是字母数字的**组织 ID**。

   2. **Activate Unity Ads in the Tenjin dashboard**

      要集成 Unity 与 Tenjin，请在 [Tenjin 后台](https://dashboard.tenjin.com/)中按以下步骤操作：

      1.进入 **配置** 选项卡，选择 **通道**。
      2.在 **Marketing Channel Name** 字段中搜索 **Unity Ads**。
      3.在 Unity Ads 的 **New Marketing Channel** 设置中，输入从 Unity Dashboard（Unity 后台）复制的 Unity 帐户凭据，并为帐户命名。
      4.在 Tenjin 导航菜单中，转到 **Campaigns** 选项卡，选择 **Create Campaign**。
      5.从 **Marketing Account** 下拉选单中选择 **Unity Ads**。
      6.在 **App** 下拉菜单中选择您的 app，并为广告系列设置一个有描述性的名称\*\*。
      7.当系统显示 **Callback to be created** 消息提示时，请按照提供的链接继续并生成归因链接。

   3. **Configure data-sharing settings**

      为 Tenjin 配置数据共享设置时也需要映射您的应用内事件。要为 Tenjin 配置数据共享设置并映射事件，请在完成激活工作流程后按以下步骤操作：

      1.按照 **Callback to be created** 消息中的链接操作后，从 **Channels and Partners** 下拉菜单中选择 **Unity Ads**。
      2.在 **Channel callbacks** 部分，激活以下开关：

      * **Unity Ads ad revenue**
      * **Unity Ads app程序打开**
      * **Unity Ads IAP**
      * **Unity Ads install**

      > **Important:**
      >
      > 请勿将广告收入事件映射为**应用内购**事件。如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的**广告收入展示**事件发送。
      >
      > 如果您的帐户不支持广告收入数据共享，请勿将广告收入作为其他事件类型发送，否则事件类型不匹配可能导致广告系列优化失效。

      3.对于每个事件回调，从 **User filter** 下拉菜单中选择 **all users**。


      **Channel Callbacks for all users:**
      ![Tenjin 集成设置的 Channel Callbacks 页面。](/api/media?file=/grow/media/images/tenjin-channel-callbacks.png)

## 七天内没有安装后事件数据##no-post-install-event-data-in-seven-days

如果您的广告系列在投放后的七天内未收到安装后事件数据，可能会对效果和优化产生负面影响。后台会标记此问题并显示以下报错信息：

```text
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性能。解决此问题可确保准确的跟踪和交付：广告系列必须在发布后的 7 天内收到至少一个安装后事件回传。
```

### 原因##causes

几种集成设置可能会中断 MMP 向广告系列发送安装后事件数据的过程，例如：

#### 归因配置不正确##attribution-configured-incorrectly

错误配置归因链接时，MMP 无法与 Unity 共享安装后事件数据。

#### 广告收入报告已禁用##ad-revenue-reporting-disabled

如果未启用 MMP 为购买和广告收入事件发送值和收入，后台将没有实现以下优化的广告系列目标所需的数据：

* In-app Purchase (IAP) 广告支出回报率 (ROAS)
* 广告收入 ROAS
* 混合 ROAS
* 付款人事件优化

请参阅[正确配置数据共享](#configure-data-sharing-correctly)部分以了解如何解决此问题的详细信息。

### 解决方案##resolutions

请考虑以下解决方案以确保广告系列收到安装后事件数据。

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

当您将安装后事件数据分享至您的广告系列时，请确保正确映射安装后事件。正确映射意味着您需要将 Unity Ads 事件名称与正确的 MMP 事件名称对应。

> **Warning:**
>
> 如果您使用除 Singular 以外的其他 MMP，请勿将广告收入事件与应用内购 (IAP) 事件合并。

请参考以下示例，它们展示了正确映射的事件名称：

1. **Adjust**

   在 Adjust 集成的 **Map events to share with Unity Ads（映射事件以与 Unity Ads 共享）** 部分中，按如下方式映射您的安装后事件：

   > **Important:**
   >
   > 如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的 `ad_revenue` 事件发送。否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `purchase`），可能导致广告系列优化失效。

   | 事件类型                  | Unity Ads 事件名称   | 调整事件名称                   |
   | --------------------- | ---------------- | ------------------------ |
   | In-app Purchase (IAP) | `purchase`       | `purchase`               |
   | Ad Revenue            | `ad_revenue`     | `ad_revenue`             |
   | 完成重要步骤                | `level_complete` | `{milestone_event_name}` |
   | 会话                    | `session`        | `session`                |

2. **Airbridge**

   在 Airbridge 集成设置的 **Postback** 选项卡 > **Postback 事件设置** 页面中映射安装后事件，如下所示：

   | 事件类型                  | Unity Ads 事件名称 | Airbridge 事件名称       |
   | --------------------- | -------------- | -------------------- |
   | In-app Purchase (IAP) | `purchase`     | Order complete (app) |
   | 广告收入                  | `ad_revenue`   | 广告展示 (app)           |
   | 会话                    | `session`      | 打开 (app)             |

3. **AppsFlyer**

   在 AppsFlyer 集成设置的 \*\*In-app event postbacks（应用内事件回传）\*\*表中，按如下方式映射您的安装后事件：

   > **Important:**
   >
   > 如果您的 AppsFlyer 帐户支持广告收入数据共享，请在 \*\*Ad revenue（广告收入）\*\*选项卡中启用 \*\*Get ad revenue data（获取广告收入数据）\*\*开关。
   >
   > 否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `af_purchase`），可能导致广告系列优化失效。

   | 应用内购 (IAP) | `purchase`       | `af_purchase`            |
   | ---------- | ---------------- | ------------------------ |
   | 完成重要步骤     | `level_complete` | `{milestone_event_name}` |
   | 会话         | `session`        | `af_app_opened`          |

4. **ByteBrew**

   在 ByteBrew 集成设置的 **Postback Settings** 选项卡中映射安装后事件，如下所示：

   | 事件类型                  | Unity Ads 事件名称 | ByteBrew 事件名称                 |
   | --------------------- | -------------- | ----------------------------- |
   | In-app Purchase (IAP) | `purchase`     | In-app Purchase 事件            |
   | 广告收入                  | `ad_revenue`   | 广告观看事件                        |
   | Session               | `session`      | User app Open Event（用户应用打开事件） |

5. **Singular**

   在 Singular 集成设置的 \*\*Revenue Events Postbacks（收入事件回传）\*\*和 \*\*Events Postbacks（事件回传）\*\*表中按如下方式映射您的安装后事件：

   > **Important:**
   >
   > Singular 是唯一支持同时发送广告收入事件和应用内购事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 **Revenue Events Postbacks** 下拉菜单中选择 **Send all ad Monetization events**，并在 **SDK Event Name** 下拉菜单中选择 \*\*\_\_REVENUE\_\_。

   | 事件类型       | Unity Ads 事件名称   | 奇异事件名称                                       |
   | ---------- | ---------------- | -------------------------------------------- |
   | 应用内购 (IAP) | `purchase`       | * `__iap__`
   * `{custom_purchase_event_name}` |
   | 广告收入       | `ad_revenue`     | `__REVENUE__*`                               |
   | 完成重要步骤     | `level_complete` | {`{milestone_event_name}`}                   |
   | 会话         | `session`        | `__SESSION__`                                |

6. **Tenjin**

   在 Tenjin 集成设置的 \*\*Channel Callbacks（通道回调）\*\*页面中，按如下方式激活您的安装后事件：

   > **Important:**
   >
   > 如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的**广告收入展示**事件发送。
   > 否则，请勿发送广告收入事件。将广告收入映射为其他事件类型，例如**应用内购**，可能会导致广告系列优化功能失效。

   | 事件类型                  | Unity Ads 事件名称 | Tenjin 事件名称        |
   | --------------------- | -------------- | ------------------ |
   | In-app Purchase (IAP) | `purchase`     | In-app Purchase    |
   | 广告收入                  | `ad_revenue`   | 广告收入展示             |
   | 会话                    | `session`      | Unity Ads app open |

#### 正确配置数据共享##configure-data-sharing-correctly

与广告系列共享[安装后事件数据](/grow/acquire/partner-integration/post-install-event-data.md)时，请确保正确配置数据共享设置。

要将安装和安装后事件数据发送到 Unity，请参阅以下合作伙伴指定说明的**配置数据共享设置**部分：

1. **Adjust**

   完成以下步骤，将 Adjust 和共享数据与 User Acquisition 广告系列正确集成：

   1. **Activate Unity Ads in the Adjust dashboard**

      若要启用与 Unity Ads 的集成，请按以下步骤操作：

      1.在 [Adjust dashboard](https://suite.adjust.com) 中，进入 **Campaign Lab** > **Partners**。
      2.选择 **+ New partner**，并搜索 **Unity Ads**。
      3.选择您的 app 并选择 **Next**。
      4.在 **Game ID** 字段中输入您的广告主 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

   2. **Configure data-sharing settings**

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

      1.在 \*\*What sources of data do you want to share（您希望共享哪些数据来源）\*\*选项中，选择 **Data from all attribution sources（所有归因来源的数据）**。
      2.在 **What other data do you want to share?** 选项中，选择 **Sessions** 和 **In-app revenue (from in app purchases)**。

      > **Important:**
      >
      > 必须使用这些数据共享设置才能启用 ROAS 和事件广告系列。

   3. **Map events and parameters**

      若要与您的用户获取广告系列共享应用内事件，请在 **Data sharing** > **Map your events** 中进行如下操作：

      1.选择 **+ Map event**。

      2.从 **Adjust event** 列表中选择要 Adjust 与 Unity 共享的事件。


      **Map Adjust events:**
      ![ Adjust 集成设置中的 Map Events to Share with Unity 对话框。](/api/media?file=/grow/media/images/adjust-map-event-to-share.png)

      3.按下表所示，选择或输入与正确 Adjust 事件对应的 Unity Ads 事件：

      > **Important:**
      >
      > 如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的 `ad_revenue` 事件发送。
      > 否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如 `purchase`），可能导致广告系列优化失效。

      | `purchase`             | `purchase`       |
      | ---------------------- | ---------------- |
      | `ad_revenue`           | `ad_revenue`     |
      | `{milestone_event}`    | `level_complete` |
      | * `session`
      * `launch` | `session`        |

      4.若要为所有平台映射相同事件，请选择 **Use global mapping**。

2. **Airbridge**

   按照以下步骤，将 Airbridge 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the Airbridge dashboard**

      要激活与 Unity Ads 的集成，请在 [Airbridge 后台](https://app.airbridge.io/app)中执行以下操作：

      1.转到 **Integration** > **Ad Channel Integration**。
      2.选择 **Unity Ads**。
      3.转到 **Postback** 选项卡。
      4.选择 **Postback Keys**，或启用 **发送回传** 开关。
      5.输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

   2. **Map the Airbridge SDK events with Unity Ads**

      要与您的用户获取广告系列共享[安装后](/grow/acquire/partner-integration/app-data/post-install-event-data.md.md)事件，请在 **Postback** 选项卡中执行以下操作：

      1.选择 **Postback event setup**（回传事件设置）。
      2.在 **App event** 列表中，选择您希望 Airbridge 与 Unity 共享的事件。
      3.按照下表，正确地选择或输入与 Airbridge 事件对应的 Unity Ads 事件。

      | 订单完成（App） | `purchase`       |
      | --------- | ---------------- |
      | 广告展示（应用）  | `ad_revenue`     |
      | 达成关卡（应用）  | `level_complete` |
      | 打开（应用）    | `session`        |

   3. **Configure data-sharing settings**

      要配置 Airbridge 数据共享设置，请在 **Postback** 选项卡中执行以下操作：

      1.在 **Attribution** 选项中，选择 **All events**。
      2.在 **Delivery rules** 设置中，选择 **First or All Events**。

3. **AppsFlyer**

   按照以下步骤，将 AppsFlyer 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the AppsFlyer dashboard**

      要在 [AppsFlyer 后台](https://hq1.appsflyer.com/auth/login)中激活 Unity Ads，请按照以下步骤操作：

      1.在 AppsFlyer 后台中，转到 **Collaborate** > **Partner Marketplace**。
      2.搜索 **Unity Ads** 并选择 **Set up integration**，在 **Integration** 选项卡中打开。
      3.激活 **Activate Partner** 开关。
      4.部分广告主在 **Integration** 选项卡中可能会有 **Advanced Privacy** 开关。如果您的后台包含此开关，请确保将其关闭。

      > **Important:**
      >
      > 如果在集成设置中激活了 \*\*Advanced Privacy（高级隐私）\*\*开关，appsFlyer 将无法与您的广告系列共享任何事件数据。


      **Advanced Privacy toggle:**
      ![AppsFlyer 集成设置中的“Advanced Privacy”（高级隐私）开关。](/api/media?file=/grow/media/images/appsflyer-advanced-privacy.png)

   2. **Configure general integration settings**

      在 AppsFlyer 中配置以下集成设置：

      **Configure general settings:**

      在 **Integration** 选项卡 > \*\*General 设置 部分中，执行以下操作：

      1.启用 \*\*Share organic/non-organic indication（共享自然/非自然来源指示）\*\*开关。


      **Share organic and non-organic:**
      !\[AppsFlyer 集成设置中的共享有机/非有机来源开关。]\(/grow/media/images/appsflyer-share- organic-non-organic.png)

      2.输入您的 Unity Ads [游戏 ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

      **Configure install attribution:**

      在 **Integration** 选项卡 > **Install attribution** 部分中，执行以下操作：

      1.将 \*\*Install engaged click-through lookback window（安装点击归因回溯窗口）\*\*的时间间隔设置为 **Days（天）**。
      2.使用滑块将回溯窗口的时长设置为 **2** 天。
      3.启用 \*\*Install view-through attribution（安装查看归因）\*\*开关。
      4.将 \*\*Install engaged view-through lookback window（安装查看归因回溯窗口）\*\*的时间间隔设置为 **Days（天）**。
      5.使用滑块将回溯窗口的时长设置为 **7** 天。


      **Set maximum lookback windows:**
      ![AppsFlyer 集成选项卡中的点击归因回溯窗口滑动条。](/api/media?file=/grow/media/images/appsflyer-install-attribution.png)

   3. **Configure data-sharing settings**

      在 AppsFlyer 中配置以下数据共享设置：

      **Configure default postbacks:**

      在 **Integration** 选项卡 > **Default postbacks** 部分，使用 **for users from** 下拉菜单为 **Install（安装）** 事件选择 **All media sources, including organic**。


      **AppsFlyer Default postbacks settings:**
      ![AppsFlyer Integration（集成）选项卡的“Default postbacks”（默认安装回传）部分。](/api/media?file=/grow/media/images/appsflyer-default-install-postbacks.png)

      **Configure in-app event settings:**

      在 **Integration** 选项卡 > app 事件 设置 部分中，执行以下操作：

      1.1. 在 **game\_id** 字段中输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。
      2.启用 \*\*In-app event postbacks（应用内事件回传）\*\*开关。
      3.将 \*\*In-app event postback window（应用内事件回传窗口）\*\*设置为 **lifetime（生命周期）**。


      **Lifetime postback windows:**
      ![AppsFlyer 集成选项卡中的生命周期应用内事件回传窗口。](/api/media?file=/grow/media/images/appsflyer-lifetime-postback-window.png)

      **Map events:**

      在 \*\*Integration（集成）\*\*选项卡 > \*\*In-app event postbacks（应用内事件回传）\*\*部分，将 mapsFlyer 事件映射到 Unity Ads 事件。

      您可以在 AppsFlyer 后台中映射任何已设置的应用内事件。请参阅 AppsFlyer 的 [应用内事件](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#predefined-event-names) 文档，了解 AppsFlyer 事件名称列表。

      > **Important:**
      >
      > 确保您的 **AppsFlyer 事件** 名称与应用代码中的事件标识符完全一致。如果事件映射错误，您的广告系列将忽略该数据。

      请参阅以下正确的事件映射示例：

      | `af_purchase`          | `purchase`       | 所有媒体来源，包括自然流量 | 数值及收入  |
      | ---------------------- | ---------------- | ------------- | ------ |
      | `milestone_event_name` | `level_complete` | 所有媒体来源，包括自然流量 | 数值及收入  |
      | `af_app_opened`        | `session`        | 所有媒体来源，包括自然流量 | 数值但无收入 |


      **AppsFlyer event mapping:**
      ![AppsFlyer 事件映射表。](/api/media?file=/grow/media/images/appsflyer-event-mapping.png)

      请确保做出如下选择：

      * 对所有事件，在 \*\*for users from（用户来源）\*\*下拉菜单中选择 **All media sources, including organic（所有媒体来源，包括自然流量）**。
      * 对于 \*\*Level Complete（关卡完成）\*\*和 \*\*Purchase（购买）\*\*事件，在 \*\*including（包含）\*\*下拉菜单中选择 **Values & revenue（数值及收入）**。
      * 对于 **Session events（会话事件）**，在 \*\*including（包含）\*\*下拉菜单中选择 **Values & no revenue（数值但无收入）**。

      **Enable ad revenue data:**

      > **Important:**
      >
      > 若要访问 AppsFlyer \*\*Revenue Settings（收入设置）\*\*菜单并与 Unity 分享广告收入数据，您需要订阅 AppsFlyer ROI360。有关详细信息和操作，请参阅 AppsFlyer 帮助中心的[广告收入归因](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 文档。

      若要与您的广告系列共享广告收入事件数据，请按以下步骤操作：

      1.前往 AppsFlyer 集成设置的 \*\*Ad revenue（广告收入）\*\*选项卡。
      2.启用 \*\*Get ad revenue data（获取广告收入数据）\*\*开关。


      **AppsFlyer Ad revenue toggle:**
      ![AppsFlyer 集成设置中的获取广告收入开关。](/api/media?file=/grow/media/images/appsflyer-get-ad-revenue.png)

      3.在 AppsFlyer 后台侧边菜单中，转到 **Settings（设置）** > **Revenue Settings（收入设置）**。
      4.在 \*\*Revenue settings（收入设置）\*\*页面的 \*\*Ad revenue（广告收入）\*\*选项卡中，选择 **New ad revenue integration（新建广告收入集成）**。
      5.在收入合作伙伴列表中选择 **Unity Ads**。
      6.在合作伙伴配置中，选择 \*\*Impression-level (via SDK) with Device-level (via S2S API)（广告展示级别（通过 SDK）与设备级别（通过 S2S API））\*\*作为上报类型。


      **Impression-level and Device-level ad revenue data:**
      ![AppsFlyer 后台中的广告收入设置。](/api/media?file=/grow/media/images/appsflyer-ad-revenue-setup.png)

      7.输入您的 API 凭据。在 **App Key** 字段中输入您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。如需从 Unity Dashboard（Unity 后台）获取 **Secret key（密钥）**，请参考以下步骤：

      **Retrieve your Secret key:**

      如需从 Unity Dashboard（Unity 后台）获取密钥，请按照以下步骤操作：

      1.在左侧导航菜单中，转到 **API Management（API 管理）**。
      2.选择 **Advertising Management API（广告管理 API）** > **Service account（服务帐户）**。


      **API Management:**
      ![Unity Ads User Acquisition（用户获取）后台的 API 管理页面](/api/media?file=/grow/media/images/api-service-account.png)

      3.如果没有服务帐户，请选择 **+ New（新建）**。如果已有服务帐户，请在表格中选择该帐户。
      4.在服务帐户页面，进入 \*\*Keys（密钥）\*\*部分。
      5.选择 \*\*+ Add key（添加密钥）\*\*以生成新密钥。
      6.选择 \*\*Secret key（密钥）\*\*后面的复制按钮，将 ID 复制到剪贴板。

      8. 返回 AppsFlyer 后台的 \*\*Integration（集成）\*\*选项卡。
         9。在 **In-app event postbacks**（应用内事件回传）部分，将广告收入事件映射到 `ad_revenue`。请参阅以下示例，了解正确的广告收入映射方式：

      | `af_ad_revenue` | `ad_revenue` | 所有媒体来源，包括自然流量 | 数值及收入 |
      | --------------- | ------------ | ------------- | ----- |

   4. **Set partner permissions**

      在 **Permissions** 选项卡中，配置以下权限设置：

      1.激活 **Toggle Ad Network Permissions** 开关，以启用所有其他开关。
      2.启用以下开关：

      * **配置集成**
      * **配置 app 内事件回传**
      * **访问留存率报告**
      * **访问汇总转化和应用内事件数据**
      * **访问聚合收入数据**
      * **查看验证规则**
      * **访问 Protect360 后台和原始数据**
      * **Access ad revenue raw data (UA signals)**（访问广告收入原始数据（UA 信号））

      如需了解每个权限的描述，请参阅 AppsFlyer 帮助中心的 [Permissions 选项卡](https://support.appsflyer.com/hc/en-us/articles/4410395957521-Set-up-an-integrated-partner#permissions-tab)文档。

4. **ByteBrew**

   完成以下步骤，将 ByteBrew 正确集成并与您的用户获取广告系列共享数据：

   1. **Activate Unity Ads in the ByteBrew dashboard**

      在 ByteBrew 后台中执行以下操作以激活 Unity Ads 集成：

      1.从后台导航菜单中选择您的应用。
      2.转到 **Attribution** > **Network Settings**，然后从网络列表中找到 **UnityAds**。
      3.在 **UnityAds** 旁边，选择 **Setup** 以打开 **Add Ad Network** 对话框。
      4.填写 **Network Settings** 字段。请参阅以下说明，了解如何在 User Acquisition（用户获取）后台中找到这些值：

      **API Key:**

      如需从用户获取后台获取 API 密钥，请执行以下操作：

      1.转到 **API Management page（API 管理页面）**。
      2.复制 \*\*Stats API v1.0（统计数据 API v1.0）\*\*部分中的 \*\*API Key（API 密钥）\*\*值。

      **Game ID:**

      如需从 **User Acquisition** 后台的 **Apps** 页面获取您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)，请按照以下步骤操作：

      1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
      2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。

      **Organization ID:**

      如需从用户获取后台获取组织 ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面。
      2.从设置的 \*\*Organization（组织）\*\*部分中复制 \*\*Organization ID（组织 ID）\*\*值。

      **Organization Core ID:**

      如需从用户获取后台的 \*\*Settings（设置）\*\*页面获取 Organization core ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面的 \*\*Organization（组织）\*\*部分。
      2.复制 \*\*Organization core ID（组织核心 ID）\*\*旁边的数字 ID。

   2. **Configure data-sharing settings**

      要使用 ByteBrew 配置数据共享设置，请在集成流程的 **Install 设置** 选项卡中执行以下操作：

      1.要启用查看归因，请选择 \*\* Enable view through tracking\*\* 复选框，并配置查看回溯窗口。ByteBrew 默认会生成点击归因链接。
      2.在以下 **Install Settings** 字段中配置归因回溯期 Windows：

      | **点击归因窗口** | 是 | 使用 **Days** 选择器设置用户点击广告后多少天安装可归因。        | 最大点击归因回溯期为 30 天。建议的最佳做法是将点击归因回溯期设置为七天或更长时间，以便准确归因。 |
      | ---------- | - | ---------------------------------------- | -------------------------------------------------- |
      | **查看归因窗口** | 否 | 使用 \*\*Days（天数）\*\*选择器设置用户观看广告后多少天安装可归因。 | 最大查看归因回溯期为 7 天。建议的最佳做法是将查看归因回溯期设置为一天或更长时间，以便准确归因。  |

      有关归因查找选项的更多信息，请参阅 ByteBrew 数据共享参考的\[归因查找设置]\(/grow/acquire/partner-integration/bytebrew/data-sharing#attribution-lookback- settings)部分。

      3.在 **发送所有安装事件 from** 部分中，选择传递应用所有安装的互动数据（包括未归因的安装数据）还是仅传递归因于 Unity 的互动数据。请从以下选项中进行选择：

      * **仅此合作伙伴**
      * **所有合作伙伴和组织**
      * **该合作伙伴及有机**

      有关安装音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的[归因数据源](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md#attribution-data-sources)部分。

   3. **Map events**

      要使用 ByteBrew 映射安装后事件，请在集成流程的 **Postback 设置** 选项卡中执行以下操作：

      1.要添加需要传递给 Unity 的安装后事件，请选择 **+ 添加回传事件**，然后从以下选项中进行选择：

      * 广告观看事件
      * User app Open Event（用户应用打开事件）
      * 应用内购事件

      有关回传事件选项的更多信息，请参阅 ByteBrew 数据共享参考中的[安装后事件数据共享部分](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md)。

      > **Important:**
      >
      > 不要在应用代码中定义新用户事件。ByteBrew 默认使用 \*\*User App Open Event（用户应用打开事件）\*\*选项来追踪新用户事件。如需了解更多信息，请参阅 [ByteBrew 开发者中心](https://docs.bytebrew.io/attribution-setup/attribution-unityads) 归因文档。

      2.在 **Postback Events Settings** 部分中，选择是通道所有 app 的安装后事件数据（包括[未归因](/grow/acquire/partner-integration/attribution/introduction.md.md)安装数据），还是仅通道归因于 Unity 的数据。请从以下选项中进行选择：

      * 仅从此合作伙伴发送
      * Send from all Networks and Organics（发送所有网络和自然流量的数据）
      * Send only from this Partner and Organics（仅发送此合作伙伴和有机流量的数据）

      有关安装后事件音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的[回传数据源](/grow/acquire/partner-integration/bytebrew/data-sharing.md.md#postback-data-sources)部分。

      3.在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。有关如何在 User Acquisition（用户获取）后台中集成这些 URL 的说明，请参阅[与 Unity 集成归因链接](/grow/acquire/partner-integration/attribution/integrate-links.md.md)。
      4.选择 **Finish** 以完成集成。

5. **Singular**

   完成以下步骤，将 Singular 正确集成到您的用户获取广告系列中并共享数据：

   1. **Activate Unity Ads in the Singular dashboard**

      1.转到 **Attribution Setup** > **Partner Configuration**。
      2.选择 **Add a Partner**。搜索并选择 **Unity Ads**。
      3.在 **Unity Ads 游戏 ID** 字段中输入您的广告主 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)。

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

   2. **Configure data-sharing settings**

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

      1.在 **Attribution Postbacks & Settings** 选项卡中，转到 **Attribution Postbacks** 表格。
      2.在 **Attribution Event** 列中，勾选 **Install** 复选框。
      3.在同一行中，选择以下复选框：

      * **发送视图**
      * **发送全部**
      * **发送欺诈回传**


      **Send View Through, All, and Fraud Postbacks:**
      ![The Attribution Postbacks & Settings tab of the Singular dashboard.](/api/media?file=/grow/media/images/singular-integration-attribution-settings.png)

   3. **Map post-install events**

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

      1.在 **In app Events Postback** 选项卡中，从 **Revenue Events Postbacks** 下拉菜单中选择 **发送全部广告变现事件**。

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


      **Send all ad monetization events:**
      ![Singular 集成设置中的 Revenue Events Postbacks 选项。](/api/media?file=/grow/media/images/singular-send-all-monetization-events.png)

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

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

      3.若要共享整个用户群的数据，请为每个事件勾选 **发送全部** 复选框。
      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（包含收入）\*\*复选框。


      **Include revenue:**
      ![Singular 集成工作流程的 In-App Events Postback 选项卡。](/api/media?file=/grow/media/images/singular-in-app-postback-tab.png)

6. **Tenjin**

   完成以下步骤，将 Tenjin 正确集成并与您的用户获取广告系列共享数据：

   1. **Copy credentials from the Unity Dashboard**

      您需要以下 Unity 帐户凭据来完成 Tenjin 集成：

      **Game ID:**

      如需从 **User Acquisition** 后台的 **Apps** 页面获取您的 [Game ID](/grow/acquire/get-started/retrieve-your-advertiser-game-id.md.md)，请按照以下步骤操作：

      1.在后台左侧导航菜单中，转到 **Apps（应用）**。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
      2.选择 ID 旁边的 \*\*Copy（复制）\*\*符号，将其复制到剪贴板。
      3.您也可以将鼠标悬停在应用名称上，复制 **Campaign Set ID（广告系列集 ID）** 和 **Store ID（商店 ID）**。

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

      **Secret Key and Key ID:**

      > **Note:**
      >
      > 只有**组织所有者**或**组织管理员**可以创建服务帐户和密钥。更多信息请参阅[用户类型、角色和权限](/cloud/organizations/roles-and-permissions.md.md)。

      要在**用户获取**后台获取您的密钥和密钥 ID，请按以下步骤操作：

      1.在左侧导航菜单中，转到 **API Management（API 管理）**。

      2.选择 **Advertising Management API（广告管理 API）** > **Service account（服务帐户）**。


      **API Management:**
      ![用户获取后台的 API 管理页面](/api/media?file=/grow/media/images/api-service-account.png)

      3.如果没有服务帐户，请选择 **+ New（新建）**。如果已有服务帐户，请在表格中选择该帐户。

      4.在服务帐户页面，进入 \*\*Keys（密钥）\*\*部分。

      5.选择 \*\*+ Add key（添加密钥）\*\*以生成两组密钥。

      6.选择 \*\*Key ID（密钥 ID）\*\*和 \*\*Secret key（密钥）\*\*后的复制按钮，复制两组凭据。

      **Organization core ID:**

      如需从用户获取后台的 \*\*Settings（设置）\*\*页面获取 Organization core ID，请按照以下步骤操作：

      1.转到 \*\*Settings（设置）\*\*页面的 \*\*Organization（组织）\*\*部分。
      2.复制 \*\*Organization core ID（组织核心 ID）\*\*旁边的数字 ID。

      > **Note:**
      >
      > 请确保复制纯数字的**Organization core ID**，而不是字母数字的**组织 ID**。

   2. **Activate Unity Ads in the Tenjin dashboard**

      要集成 Unity 与 Tenjin，请在 [Tenjin 后台](https://dashboard.tenjin.com/)中按以下步骤操作：

      1.进入 **配置** 选项卡，选择 **通道**。
      2.在 **Marketing Channel Name** 字段中搜索 **Unity Ads**。
      3.在 Unity Ads 的 **New Marketing Channel** 设置中，输入从 Unity Dashboard（Unity 后台）复制的 Unity 帐户凭据，并为帐户命名。
      4.在 Tenjin 导航菜单中，转到 **Campaigns** 选项卡，选择 **Create Campaign**。
      5.从 **Marketing Account** 下拉选单中选择 **Unity Ads**。
      6.在 **App** 下拉菜单中选择您的 app，并为广告系列设置一个有描述性的名称\*\*。
      7.当系统显示 **Callback to be created** 消息提示时，请按照提供的链接继续并生成归因链接。

   3. **Configure data-sharing settings**

      为 Tenjin 配置数据共享设置时也需要映射您的应用内事件。要为 Tenjin 配置数据共享设置并映射事件，请在完成激活工作流程后按以下步骤操作：

      1.按照 **Callback to be created** 消息中的链接操作后，从 **Channels and Partners** 下拉菜单中选择 **Unity Ads**。
      2.在 **Channel callbacks** 部分，激活以下开关：

      * **Unity Ads ad revenue**
      * **Unity Ads app程序打开**
      * **Unity Ads IAP**
      * **Unity Ads install**

      > **Important:**
      >
      > 请勿将广告收入事件映射为**应用内购**事件。如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的**广告收入展示**事件发送。
      >
      > 如果您的帐户不支持广告收入数据共享，请勿将广告收入作为其他事件类型发送，否则事件类型不匹配可能导致广告系列优化失效。

      3.对于每个事件回调，从 **User filter** 下拉菜单中选择 **all users**。


      **Channel Callbacks for all users:**
      ![Tenjin 集成设置的 Channel Callbacks 页面。](/api/media?file=/grow/media/images/tenjin-channel-callbacks.png)