实现游戏增长 Unity Ads 用户获取 合作伙伴集成 集成故障排除 常见移动端测量合作伙伴(MMP)集成错误的故障排除。
将移动端衡量合作伙伴 (MMP) 与用户获取广告系列集成时，后台会检查广告系列是否成功接收数据。后台会验证以下数据共享指标：
您的广告系列会在投放后两天内收到安装数据。
您的广告系列会在投放后的七天内收到安装后事件数据。
如果您的广告系列未能通过上述任何验证检查，后台会以集成报错消息标记您的广告系列。请参阅以下各节以信息如何解决这些错误。
重要
本故障排除指南涵盖以下 MMP 的集成问题：
Adjust
Airbridge
AppsFlyer
字节混叠
Singular
Tenjin
有关与 AppsFlyer 集成的其他问题，请参阅 AppsFlyer 集成验证 文档。
两天内没有安装数据
如果您的广告系列在投放后的两天内未收到安装数据，可能会对效果和归因产生负面影响。后台会标记此问题并显示以下报错信息：
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性能。解决此问题可确保准确的跟踪和交付：广告系列必须在发布后 2 天内收到至少一次安装回传。
原因
如果 MMP 集成配置错误，广告系列可能无法累积安装数据。请参阅 MMP 指定的集成指南以了解分步集成说明。
解决方案
请考虑以下两种分辨率以确保广告系列收到安装数据。
从所有来源共享安装数据
当您与 Unity 共享安装数据时，请确保包含整个用户群的数据，包括归因、未归因和自然安装。如需了解每种归因类型的定义，请参阅
归因介绍 。
每个 MMP 对此设置都有独特的术语。请参阅以下示例展示了在支持的 MMP 后台中如何从所有来源共享安装数据：
要共享所有用户底部的安装数据，请在 Adjust（调整）后台中执行以下步骤：
1.转到 **Campaign Lab（广告系列实验室）**选项卡 > **Partners（合作伙伴）**页面。
2.在 **What sources of data do you want to share（您希望共享哪些数据来源）**选项中，选择 Data from all attribution sources（所有归因来源的数据） 。
要共享所有用户底部的安装数据，请在 Airbridge Dashboard 中执行以下步骤：
1.从顶部菜单栏中选择
Organization 。
2.在
组织设置 页面上，转到
用户管理 >
机构 。
3.在
App 列表中找到 app，然后选择
Details 。如果您尚未为 app 授予 app 访问权限，请参阅 Airbridge
组织级用户管理 文档。
4.从 app Access 设置** 中选择
编辑 以打开访问设设置话框。
5.转到对话框的 未归因事件数据**部分。
6.启用
Unnattributed 事件 Data 开关。
7.选择
保存 。
使用以下步骤在 AppsFlyer 后台中共享所有来源的数据：
1.转到 **Integration（集成）**选项卡 > **Default postbacks（默认回传）**部分。
2.在 **for users from（用户来源）**下拉选单中，选择 All media sources, include organic（所有媒体来源，包括自然流量） 。
要共享所有用户底部的安装数据，请在 ByteBrew Dashboard 中执行以下步骤：
1.在 ByteBrew 集成设置的 Install Settings 选项卡中，转到 发送所有安装事件 from 部分。
2.选择 All Partners and Organics 。
要共享所有用户底部的安装数据，请在 Singular Dashboard 中执行以下步骤：
1.转到 **Attribution Postbacks & Settings（归因回传及设置）**选项卡 > **Attribution Postbacks（归因回传）**表格。
2.启用 **Send All（发送全部）**复选框。
要共享所有用户底部的安装数据，请在 Tenjin Dashboard 中执行以下步骤：
1.转到应用的 **Callbacks（回调）**选项卡。
2.在 **User filter（用户筛选器）**下拉菜单中，选择 all users（所有用户） 。
查看集成设置
请查看首选 MMP 的集成指南，确保其配置正确。请查看合作伙伴集成指南中的集成激活、广告主凭据和数据共享设置：
完成以下步骤，将 Adjust 和共享数据与 User Acquisition 广告系列正确集成：
1 Activate Unity Ads in the Adjust dashboard 若要启用与 Unity Ads 的集成，请按以下步骤操作：
1.在
Adjust dashboard 中，进入
Campaign Lab >
Partners 。
2.选择
+ New partner ，并搜索
Unity Ads 。
3.选择您的 app 并选择
Next 。
4.在
Game ID 字段中输入您的广告主
Game ID 。
注意
请严格按照用户获取后台中显示的 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) 。
重要
必须使用这些数据共享设置才能启用 ROAS 和事件广告系列。
3 Map events and parameters 若要与您的用户获取广告系列共享应用内事件，请在 Data sharing > Map your events 中进行如下操作：
1.选择 + Map event 。
2.从 Adjust event 列表中选择要 Adjust 与 Unity 共享的事件。
Map Adjust events
3.按下表所示，选择或输入与正确 Adjust 事件对应的 Unity Ads 事件：
重要
如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的
事件发送。
否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如
），可能导致广告系列优化失效。
调整 App 事件 Unity Ads 合作伙伴事件
4.若要为所有平台映射相同事件，请选择 Use global mapping 。
按照以下步骤，将 Airbridge 正确集成到您的用户获取广告系列中并共享数据：
1 Activate Unity Ads in the Airbridge dashboard 1.转到
Integration >
Ad Channel Integration 。
2.选择
Unity Ads 。
3.转到
Postback 选项卡。
4.选择
Postback Keys ，或启用
发送回传 开关。
5.输入您的
Game ID 。
2 Map the Airbridge SDK events with Unity Ads 要与您的用户获取广告系列共享
安装后 事件，请在
Postback 选项卡中执行以下操作：
1.选择 Postback event setup （回传事件设置）。
2.在 App event 列表中，选择您希望 Airbridge 与 Unity 共享的事件。
3.按照下表，正确地选择或输入与 Airbridge 事件对应的 Unity Ads 事件。
Airbridge App 事件 Unity Ads 合作伙伴事件 订单完成（App） 广告展示（应用） 达成关卡（应用） 打开（应用）
3 Configure data-sharing settings 要配置 Airbridge 数据共享设置，请在 Postback 选项卡中执行以下操作：
1.在 Attribution 选项中，选择 All events 。
2.在 Delivery rules 设置中，选择 First or All Events 。
按照以下步骤，将 AppsFlyer 正确集成到您的用户获取广告系列中并共享数据：
1 Activate Unity Ads in the AppsFlyer dashboard 1.在 AppsFlyer 后台中，转到 Collaborate > Partner Marketplace 。
2.搜索 Unity Ads 并选择 Set up integration ，在 Integration 选项卡中打开。
3.激活 Activate Partner 开关。
4.部分广告主在 Integration 选项卡中可能会有 Advanced Privacy 开关。如果您的后台包含此开关，请确保将其关闭。
重要
如果在集成设置中激活了 **Advanced Privacy（高级隐私）**开关，appsFlyer 将无法与您的广告系列共享任何事件数据。
Advanced Privacy toggle
2 Configure general integration settings 在 AppsFlyer 中配置以下集成设置：
Configure general settings
在 Integration 选项卡 > **General 设置 部分中，执行以下操作：
1.启用 **Share organic/non-organic indication（共享自然/非自然来源指示）**开关。
Share organic and non-organic
注意
请严格按照用户获取后台中显示的 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
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
Configure in-app event settings
在 Integration 选项卡 > app 事件 设置 部分中，执行以下操作：
1.1. 在
game_id 字段中输入您的
Game ID 。
2.启用 **In-app event postbacks（应用内事件回传）**开关。
3.将 **In-app event postback window（应用内事件回传窗口）**设置为
lifetime（生命周期） 。
Lifetime postback windows
Map events
在 **Integration（集成）**选项卡 > **In-app event postbacks（应用内事件回传）**部分，将 mapsFlyer 事件映射到 Unity Ads 事件。
您可以在 AppsFlyer 后台中映射任何已设置的应用内事件。请参阅 AppsFlyer 的
应用内事件 文档，了解 AppsFlyer 事件名称列表。
重要
确保您的 AppsFlyer 事件 名称与应用代码中的事件标识符完全一致。如果事件映射错误，您的广告系列将忽略该数据。
请参阅以下正确的事件映射示例：
AppsFlyer 事件 映射到合作伙伴事件 适合的用户来源 包括 所有媒体来源，包括自然流量 数值及收入 所有媒体来源，包括自然流量 数值及收入 所有媒体来源，包括自然流量 数值但无收入
AppsFlyer event mapping
请确保做出如下选择：
对所有事件，在 **for users from（用户来源）**下拉菜单中选择 All media sources, including organic（所有媒体来源，包括自然流量） 。
对于 **Level Complete（关卡完成）**和 **Purchase（购买）**事件，在 **including（包含）**下拉菜单中选择 Values & revenue（数值及收入） 。
对于 Session events（会话事件） ，在 **including（包含）**下拉菜单中选择 Values & no revenue（数值但无收入） 。
Enable ad revenue data
重要
若要访问 AppsFlyer **Revenue Settings（收入设置）**菜单并与 Unity 分享广告收入数据，您需要订阅 AppsFlyer ROI360。有关详细信息和操作，请参阅 AppsFlyer 帮助中心的
广告收入归因 文档。
若要与您的广告系列共享广告收入事件数据，请按以下步骤操作：
1.前往 AppsFlyer 集成设置的 **Ad revenue（广告收入）**选项卡。
2.启用 **Get ad revenue data（获取广告收入数据）**开关。
AppsFlyer Ad revenue toggle
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
7.输入您的 API 凭据。在
App Key 字段中输入您的
Game ID 。如需从 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
3.如果没有服务帐户，请选择 + New（新建） 。如果已有服务帐户，请在表格中选择该帐户。
4.在服务帐户页面，进入 **Keys（密钥）**部分。
5.选择 **+ Add key（添加密钥）**以生成新密钥。
6.选择 **Secret key（密钥）**后面的复制按钮，将 ID 复制到剪贴板。
返回 AppsFlyer 后台的 **Integration（集成）**选项卡。
9。在 In-app event postbacks （应用内事件回传）部分，将广告收入事件映射到 。请参阅以下示例，了解正确的广告收入映射方式：
AppsFlyer 事件 映射到合作伙伴事件 适合的用户来源 包括 所有媒体来源，包括自然流量 数值及收入
4 Set partner permissions 在 Permissions 选项卡中，配置以下权限设置：
1.激活 Toggle Ad Network Permissions 开关，以启用所有其他开关。
2.启用以下开关：
配置集成 配置 app 内事件回传 访问留存率报告 访问汇总转化和应用内事件数据 访问聚合收入数据 查看验证规则 访问 Protect360 后台和原始数据 Access ad revenue raw data (UA signals) （访问广告收入原始数据（UA 信号）） 完成以下步骤，将 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 ，请按照以下步骤操作：
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 数据共享参考的
归因数据源 部分。
3 Map events 要使用 ByteBrew 映射安装后事件，请在集成流程的 Postback 设置 选项卡中执行以下操作：
1.要添加需要传递给 Unity 的安装后事件，请选择 + 添加回传事件 ，然后从以下选项中进行选择：
广告观看事件
User app Open Event（用户应用打开事件）
应用内购事件
重要
不要在应用代码中定义新用户事件。ByteBrew 默认使用 **User App Open Event（用户应用打开事件）**选项来追踪新用户事件。如需了解更多信息，请参阅
ByteBrew 开发者中心 归因文档。
2.在
Postback Events Settings 部分中，选择是通道所有 app 的安装后事件数据（包括
未归因 安装数据），还是仅通道归因于 Unity 的数据。请从以下选项中进行选择：
仅从此合作伙伴发送
Send from all Networks and Organics（发送所有网络和自然流量的数据）
Send only from this Partner and Organics（仅发送此合作伙伴和有机流量的数据）
有关安装后事件音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的
回传数据源 部分。
3.在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。有关如何在 User Acquisition（用户获取）后台中集成这些 URL 的说明，请参阅
与 Unity 集成归因链接 。
4.选择
Finish 以完成集成。
完成以下步骤，将 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 。
注意
请严格按照用户获取后台中显示的 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
3 Map post-install events 要映射事件，请按以下步骤操作：
1.在 In app Events Postback 选项卡中，从 Revenue Events Postbacks 下拉菜单中选择 发送全部广告变现事件 。
重要
Singular 是唯一支持同时发送全部变现事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 **Revenue Events Postbacks（收入事件回传）**下拉菜单中选择
Send all ad monetization events（发送全部广告变现事件） ，并在 **SDK Event Name（SDK 事件名称）**下拉菜单中选择
。
Send all ad monetization events
2.要映射事件，请在 SDK Event Name 列中选择您的 Singular 事件，并将其映射到 Event Name 列的 Unity Ads 事件，如下所示：
Singular SDK 事件名称 Unity Ads Event Name（事件名称） 注意
custom_purchase_event_name 重要
要通过 Singular 发送广告收入事件，请确保在事件表上方的 **Revenue Events Postbacks（收入事件回传）**下拉菜单中选择 Send all ad monetization events（发送全部广告变现事件） 。
3.若要共享整个用户群的数据，请为每个事件勾选
发送全部 复选框。
4.在 **Postback Window Starting Point（回传窗口起始点）**列，为每个事件选择
Unlimited（无限） 。
5.如果您拥有 Singular
Enterprise 帐户，请将
Postback Window (days)（回传窗口（天）） 设置为
Unlimited（无限） 。否则，将窗口设置为
天。
6.为每一行勾选 **Include Revenue（包含收入）**复选框。
Include revenue
完成以下步骤，将 Tenjin 正确集成并与您的用户获取广告系列共享数据：
1 Copy credentials from the Unity Dashboard 您需要以下 Unity 帐户凭据来完成 Tenjin 集成：
Game ID
如需从
User Acquisition 后台的
Apps 页面获取您的
Game ID ，请按照以下步骤操作：
1.在后台左侧导航菜单中，转到 Apps（应用） 。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
2.选择 ID 旁边的 **Copy（复制）**符号，将其复制到剪贴板。
3.您也可以将鼠标悬停在应用名称上，复制 Campaign Set ID（广告系列集 ID） 和 Store ID（商店 ID） 。
注意
请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。
Secret Key and Key ID
要在用户获取 后台获取您的密钥和密钥 ID，请按以下步骤操作：
1.在左侧导航菜单中，转到 API Management（API 管理） 。
2.选择 Advertising Management API（广告管理 API） > Service account（服务帐户） 。
API Management
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。
注意
请确保复制纯数字的Organization core ID ，而不是字母数字的组织 ID 。
2 Activate Unity Ads in the Tenjin dashboard 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 重要
请勿将广告收入事件映射为应用内购 事件。如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的广告收入展示 事件发送。
如果您的帐户不支持广告收入数据共享，请勿将广告收入作为其他事件类型发送，否则事件类型不匹配可能导致广告系列优化失效。
3.对于每个事件回调，从 User filter 下拉菜单中选择 all users 。
Channel Callbacks for all users
七天内没有安装后事件数据
如果您的广告系列在投放后的七天内未收到安装后事件数据，可能会对效果和优化产生负面影响。后台会标记此问题并显示以下报错信息：
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性能。解决此问题可确保准确的跟踪和交付：广告系列必须在发布后的 7 天内收到至少一个安装后事件回传。
原因
几种集成设置可能会中断 MMP 向广告系列发送安装后事件数据的过程，例如：
错误配置归因链接时，MMP 无法与 Unity 共享安装后事件数据。
广告收入报告已禁用
如果未启用 MMP 为购买和广告收入事件发送值和收入，后台将没有实现以下优化的广告系列目标所需的数据：
In-app Purchase (IAP) 广告支出回报率 (ROAS)
广告收入 ROAS
混合 ROAS
付款人事件优化
解决方案
请考虑以下解决方案以确保广告系列收到安装后事件数据。
正确映射安装后事件
当您将安装后事件数据分享至您的广告系列时，请确保正确映射安装后事件。正确映射意味着您需要将 Unity Ads 事件名称与正确的 MMP 事件名称对应。
警告
如果您使用除 Singular 以外的其他 MMP，请勿将广告收入事件与应用内购 (IAP) 事件合并。
请参考以下示例，它们展示了正确映射的事件名称：
在 Adjust 集成的 Map events to share with Unity Ads（映射事件以与 Unity Ads 共享） 部分中，按如下方式映射您的安装后事件：
重要
如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的
事件发送。否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如
），可能导致广告系列优化失效。
事件类型 Unity Ads 事件名称 调整事件名称 In-app Purchase (IAP) Ad Revenue 完成重要步骤 会话
在 Airbridge 集成设置的 Postback 选项卡 > Postback 事件设置 页面中映射安装后事件，如下所示：
事件类型 Unity Ads 事件名称 Airbridge 事件名称 In-app Purchase (IAP) Order complete (app) 广告收入 广告展示 (app) 会话 打开 (app)
在 AppsFlyer 集成设置的 **In-app event postbacks（应用内事件回传）**表中，按如下方式映射您的安装后事件：
重要
如果您的 AppsFlyer 帐户支持广告收入数据共享，请在 **Ad revenue（广告收入）**选项卡中启用 **Get ad revenue data（获取广告收入数据）**开关。
否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如
），可能导致广告系列优化失效。
事件类型 Unity 广告 AppsFlyer 应用内购 (IAP) 完成重要步骤 会话
在 ByteBrew 集成设置的 Postback Settings 选项卡中映射安装后事件，如下所示：
事件类型 Unity Ads 事件名称 ByteBrew 事件名称 In-app Purchase (IAP) In-app Purchase 事件 广告收入 广告观看事件 Session User app Open Event（用户应用打开事件）
在 Singular 集成设置的 **Revenue Events Postbacks（收入事件回传）**和 **Events Postbacks（事件回传）**表中按如下方式映射您的安装后事件：
重要
Singular 是唯一支持同时发送广告收入事件和应用内购事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 Revenue Events Postbacks 下拉菜单中选择 Send all ad Monetization events ，并在 SDK Event Name 下拉菜单中选择 **__REVENUE__。
事件类型 Unity Ads 事件名称 奇异事件名称 应用内购 (IAP)
{custom_purchase_event_name} 广告收入 完成重要步骤 会话
在 Tenjin 集成设置的 **Channel Callbacks（通道回调）**页面中，按如下方式激活您的安装后事件：
重要
如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的广告收入展示 事件发送。
否则，请勿发送广告收入事件。将广告收入映射为其他事件类型，例如应用内购 ，可能会导致广告系列优化功能失效。
事件类型 Unity Ads 事件名称 Tenjin 事件名称 In-app Purchase (IAP) In-app Purchase 广告收入 广告收入展示 会话 Unity Ads app open
要将安装和安装后事件数据发送到 Unity，请参阅以下合作伙伴指定说明的配置数据共享设置 部分：
完成以下步骤，将 Adjust 和共享数据与 User Acquisition 广告系列正确集成：
1 Activate Unity Ads in the Adjust dashboard 若要启用与 Unity Ads 的集成，请按以下步骤操作：
1.在
Adjust dashboard 中，进入
Campaign Lab >
Partners 。
2.选择
+ New partner ，并搜索
Unity Ads 。
3.选择您的 app 并选择
Next 。
4.在
Game ID 字段中输入您的广告主
Game ID 。
注意
请严格按照用户获取后台中显示的 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) 。
重要
必须使用这些数据共享设置才能启用 ROAS 和事件广告系列。
3 Map events and parameters 若要与您的用户获取广告系列共享应用内事件，请在 Data sharing > Map your events 中进行如下操作：
1.选择 + Map event 。
2.从 Adjust event 列表中选择要 Adjust 与 Unity 共享的事件。
Map Adjust events
3.按下表所示，选择或输入与正确 Adjust 事件对应的 Unity Ads 事件：
重要
如果您的 Adjust 帐户支持广告收入数据共享，请将该数据作为专门的
事件发送。
否则，请勿发送广告收入事件。将广告收入事件映射为其他事件类型（如
），可能导致广告系列优化失效。
调整 App 事件 Unity Ads 合作伙伴事件
4.若要为所有平台映射相同事件，请选择 Use global mapping 。
按照以下步骤，将 Airbridge 正确集成到您的用户获取广告系列中并共享数据：
1 Activate Unity Ads in the Airbridge dashboard 1.转到
Integration >
Ad Channel Integration 。
2.选择
Unity Ads 。
3.转到
Postback 选项卡。
4.选择
Postback Keys ，或启用
发送回传 开关。
5.输入您的
Game ID 。
2 Map the Airbridge SDK events with Unity Ads 要与您的用户获取广告系列共享
安装后 事件，请在
Postback 选项卡中执行以下操作：
1.选择 Postback event setup （回传事件设置）。
2.在 App event 列表中，选择您希望 Airbridge 与 Unity 共享的事件。
3.按照下表，正确地选择或输入与 Airbridge 事件对应的 Unity Ads 事件。
Airbridge App 事件 Unity Ads 合作伙伴事件 订单完成（App） 广告展示（应用） 达成关卡（应用） 打开（应用）
3 Configure data-sharing settings 要配置 Airbridge 数据共享设置，请在 Postback 选项卡中执行以下操作：
1.在 Attribution 选项中，选择 All events 。
2.在 Delivery rules 设置中，选择 First or All Events 。
按照以下步骤，将 AppsFlyer 正确集成到您的用户获取广告系列中并共享数据：
1 Activate Unity Ads in the AppsFlyer dashboard 1.在 AppsFlyer 后台中，转到 Collaborate > Partner Marketplace 。
2.搜索 Unity Ads 并选择 Set up integration ，在 Integration 选项卡中打开。
3.激活 Activate Partner 开关。
4.部分广告主在 Integration 选项卡中可能会有 Advanced Privacy 开关。如果您的后台包含此开关，请确保将其关闭。
重要
如果在集成设置中激活了 **Advanced Privacy（高级隐私）**开关，appsFlyer 将无法与您的广告系列共享任何事件数据。
Advanced Privacy toggle
2 Configure general integration settings 在 AppsFlyer 中配置以下集成设置：
Configure general settings
在 Integration 选项卡 > **General 设置 部分中，执行以下操作：
1.启用 **Share organic/non-organic indication（共享自然/非自然来源指示）**开关。
Share organic and non-organic
注意
请严格按照用户获取后台中显示的 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
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
Configure in-app event settings
在 Integration 选项卡 > app 事件 设置 部分中，执行以下操作：
1.1. 在
game_id 字段中输入您的
Game ID 。
2.启用 **In-app event postbacks（应用内事件回传）**开关。
3.将 **In-app event postback window（应用内事件回传窗口）**设置为
lifetime（生命周期） 。
Lifetime postback windows
Map events
在 **Integration（集成）**选项卡 > **In-app event postbacks（应用内事件回传）**部分，将 mapsFlyer 事件映射到 Unity Ads 事件。
您可以在 AppsFlyer 后台中映射任何已设置的应用内事件。请参阅 AppsFlyer 的
应用内事件 文档，了解 AppsFlyer 事件名称列表。
重要
确保您的 AppsFlyer 事件 名称与应用代码中的事件标识符完全一致。如果事件映射错误，您的广告系列将忽略该数据。
请参阅以下正确的事件映射示例：
AppsFlyer 事件 映射到合作伙伴事件 适合的用户来源 包括 所有媒体来源，包括自然流量 数值及收入 所有媒体来源，包括自然流量 数值及收入 所有媒体来源，包括自然流量 数值但无收入
AppsFlyer event mapping
请确保做出如下选择：
对所有事件，在 **for users from（用户来源）**下拉菜单中选择 All media sources, including organic（所有媒体来源，包括自然流量） 。
对于 **Level Complete（关卡完成）**和 **Purchase（购买）**事件，在 **including（包含）**下拉菜单中选择 Values & revenue（数值及收入） 。
对于 Session events（会话事件） ，在 **including（包含）**下拉菜单中选择 Values & no revenue（数值但无收入） 。
Enable ad revenue data
重要
若要访问 AppsFlyer **Revenue Settings（收入设置）**菜单并与 Unity 分享广告收入数据，您需要订阅 AppsFlyer ROI360。有关详细信息和操作，请参阅 AppsFlyer 帮助中心的
广告收入归因 文档。
若要与您的广告系列共享广告收入事件数据，请按以下步骤操作：
1.前往 AppsFlyer 集成设置的 **Ad revenue（广告收入）**选项卡。
2.启用 **Get ad revenue data（获取广告收入数据）**开关。
AppsFlyer Ad revenue toggle
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
7.输入您的 API 凭据。在
App Key 字段中输入您的
Game ID 。如需从 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
3.如果没有服务帐户，请选择 + New（新建） 。如果已有服务帐户，请在表格中选择该帐户。
4.在服务帐户页面，进入 **Keys（密钥）**部分。
5.选择 **+ Add key（添加密钥）**以生成新密钥。
6.选择 **Secret key（密钥）**后面的复制按钮，将 ID 复制到剪贴板。
返回 AppsFlyer 后台的 **Integration（集成）**选项卡。
9。在 In-app event postbacks （应用内事件回传）部分，将广告收入事件映射到 。请参阅以下示例，了解正确的广告收入映射方式：
AppsFlyer 事件 映射到合作伙伴事件 适合的用户来源 包括 所有媒体来源，包括自然流量 数值及收入
4 Set partner permissions 在 Permissions 选项卡中，配置以下权限设置：
1.激活 Toggle Ad Network Permissions 开关，以启用所有其他开关。
2.启用以下开关：
配置集成 配置 app 内事件回传 访问留存率报告 访问汇总转化和应用内事件数据 访问聚合收入数据 查看验证规则 访问 Protect360 后台和原始数据 Access ad revenue raw data (UA signals) （访问广告收入原始数据（UA 信号）） 完成以下步骤，将 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 ，请按照以下步骤操作：
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 数据共享参考的
归因数据源 部分。
3 Map events 要使用 ByteBrew 映射安装后事件，请在集成流程的 Postback 设置 选项卡中执行以下操作：
1.要添加需要传递给 Unity 的安装后事件，请选择 + 添加回传事件 ，然后从以下选项中进行选择：
广告观看事件
User app Open Event（用户应用打开事件）
应用内购事件
重要
不要在应用代码中定义新用户事件。ByteBrew 默认使用 **User App Open Event（用户应用打开事件）**选项来追踪新用户事件。如需了解更多信息，请参阅
ByteBrew 开发者中心 归因文档。
2.在
Postback Events Settings 部分中，选择是通道所有 app 的安装后事件数据（包括
未归因 安装数据），还是仅通道归因于 Unity 的数据。请从以下选项中进行选择：
仅从此合作伙伴发送
Send from all Networks and Organics（发送所有网络和自然流量的数据）
Send only from this Partner and Organics（仅发送此合作伙伴和有机流量的数据）
有关安装后事件音频源选项的更多信息，请参阅 ByteBrew 数据共享参考的
回传数据源 部分。
3.在广告网络设置对话框的最后一个选项卡上，可以复制归因链接。有关如何在 User Acquisition（用户获取）后台中集成这些 URL 的说明，请参阅
与 Unity 集成归因链接 。
4.选择
Finish 以完成集成。
完成以下步骤，将 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 。
注意
请严格按照用户获取后台中显示的 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
3 Map post-install events 要映射事件，请按以下步骤操作：
1.在 In app Events Postback 选项卡中，从 Revenue Events Postbacks 下拉菜单中选择 发送全部广告变现事件 。
重要
Singular 是唯一支持同时发送全部变现事件的 MMP。若要通过 Singular 发送广告收入事件，请确保在 **Revenue Events Postbacks（收入事件回传）**下拉菜单中选择
Send all ad monetization events（发送全部广告变现事件） ，并在 **SDK Event Name（SDK 事件名称）**下拉菜单中选择
。
Send all ad monetization events
2.要映射事件，请在 SDK Event Name 列中选择您的 Singular 事件，并将其映射到 Event Name 列的 Unity Ads 事件，如下所示：
Singular SDK 事件名称 Unity Ads Event Name（事件名称） 注意
custom_purchase_event_name 重要
要通过 Singular 发送广告收入事件，请确保在事件表上方的 **Revenue Events Postbacks（收入事件回传）**下拉菜单中选择 Send all ad monetization events（发送全部广告变现事件） 。
3.若要共享整个用户群的数据，请为每个事件勾选
发送全部 复选框。
4.在 **Postback Window Starting Point（回传窗口起始点）**列，为每个事件选择
Unlimited（无限） 。
5.如果您拥有 Singular
Enterprise 帐户，请将
Postback Window (days)（回传窗口（天）） 设置为
Unlimited（无限） 。否则，将窗口设置为
天。
6.为每一行勾选 **Include Revenue（包含收入）**复选框。
Include revenue
完成以下步骤，将 Tenjin 正确集成并与您的用户获取广告系列共享数据：
1 Copy credentials from the Unity Dashboard 您需要以下 Unity 帐户凭据来完成 Tenjin 集成：
Game ID
如需从
User Acquisition 后台的
Apps 页面获取您的
Game ID ，请按照以下步骤操作：
1.在后台左侧导航菜单中，转到 Apps（应用） 。表格列出了您组织的每个应用。每个应用名称后，后台会显示应用平台和 Game ID。
2.选择 ID 旁边的 **Copy（复制）**符号，将其复制到剪贴板。
3.您也可以将鼠标悬停在应用名称上，复制 Campaign Set ID（广告系列集 ID） 和 Store ID（商店 ID） 。
注意
请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。
Secret Key and Key ID
要在用户获取 后台获取您的密钥和密钥 ID，请按以下步骤操作：
1.在左侧导航菜单中，转到 API Management（API 管理） 。
2.选择 Advertising Management API（广告管理 API） > Service account（服务帐户） 。
API Management
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。
注意
请确保复制纯数字的Organization core ID ，而不是字母数字的组织 ID 。
2 Activate Unity Ads in the Tenjin dashboard 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 重要
请勿将广告收入事件映射为应用内购 事件。如果您的 Tenjin 帐户支持广告收入数据共享，请将此数据作为专门的广告收入展示 事件发送。
如果您的帐户不支持广告收入数据共享，请勿将广告收入作为其他事件类型发送，否则事件类型不匹配可能导致广告系列优化失效。
3.对于每个事件回调，从 User filter 下拉菜单中选择 all users 。
Channel Callbacks for all users
