AppsFlyer 集成验证
请查看 AppsFlyer 集Rules以及如何在 用户获取(用户获取)后台中解决集成设置警告。
阅读时间38 分钟最后更新于 2 天前
当您将用户获取广告系列与 AppsFlyer 集成时,Unity Dashboard 会验证您的集成设置以确保其配置正确。如果不解决这些集成错误,则无法启动新建的或暂停的广告系列,并且实时广告系列可能会遇到严重的性能和归因问题。
集成验Rules
请参阅以下选项卡以查看所需和建议的集成Rules及其关联广告系列目标的列表:
必需的集成Rules
您必须遵守以下Rules才能设置广告系列:
|
|
|
|---|---|---|
[Game id | AppsFlyer 集成设置中的 Game ID 必须与 Unity Dashboard 中的 Game ID Match。 | All广告系列目标 |
必须已启用View归因。 | All广告系列目标 | |
View lookback Windows必须至少七天。 | All广告系列目标 | |
点击式回顾Windows必须至少两天。 | All广告系列目标 | |
[AppsFlyer 事件映射](#appsflyer-事件- Mapping) | AppsFlyer POST 安装后事件必须映射到正确的 Unity Event name。 | All 优化的广告系列目标,包括以下内容:
|
必须正确映射 In-app Purchase 事件。 | ||
[In-app Purchase 事件值和 Revenue](#in-app-purchase-event-values-and- Revenue) | In-app Purchase 事件回传必须包含值和 Revenue。 | |
In-app Purchase传](#in-app-purchase-postbacks) | 广告系列必须在发布后的七天内具有一个或多个 In-app Purchase 事件回传。 | |
[Ad Revenue 事件值和 Revenue](#ad- Revenue-事件-values-and- Revenue) | Ad Revenue事件回传必须包含值和Revenue。 |
|
广告系列必须在投放后的七天内具有一个或多个 Ad Revenue 事件回传。 |
| |
关卡完成事件回传不得包含值或 Revenue。 |
| |
会话事件回传不得包含值或 Revenue。 |
| |
[安装回传]安装postbacks) | 在发布后的两天内,应用程序必须在过去 90 天内至少有一次安装回传。 | All广告系列目标 |
所需的Rule解析
要满足所需的集成Rules,请参阅以下Resolution率信息。
游戏 ID
要满足此验证Rule,请确保在 AppsFlyer Dashboard(AppsFlyer 后台)中进入的Game ID 与 Unity 用户获取(用户获取)后台中的Game ID 完全匹配。
要在 AppsFlyer 集成设置中进入 Unity Game ID,请执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Integration 选项卡中,转到 **General Settings 部分。
3.在 Unity Ads Game ID Field 字段中输入您的 Game ID。要从 Unity Dashboard 复制 Game ID,请参阅以下步骤:
Unity Ads要从用户获取后台复制 Game ID,请执行以下步骤:
- 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
- 滚动或搜索以找到所需的应用。
- 选择应用行末尾的 Settings (
) 以打开应用细节 Page。
- 转到 MMP Settings 部分。
- 选择 Game ID Next 旁边的复制 (
) 以将该 ID 复制到剪贴板。

Unity Ads Game ID
View-through attribution(查看归因)
要满足此验证Rule,请确保在 AppsFlyer 集成设置中启用视图归因。
要启用视图归因,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Integration 选项卡中,转到 安装 attribution** 部分。
3.启用 **Install view-through attribution(安装查看归因)**开关。
Unity Ads
View-through attribution enabled
View lookback Window
要满足此验证规则,请将 View-through lookback Window 设置为 7 Days。
要将 视图 lookback Window设置为 7 天,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Integration 选项卡中,转到 安装 attribution** 部分。
3.启用 **Install view-through attribution(安装查看归因)**开关。
4.将 Install engaged view-through lookback window 设置为 Days。
5.使用滑动条条将Window设置为 7 Days。
Unity Ads
7-day view-through lookback window
Click-through lookback Window
要满足此验证规则,请将 Click-through lookback Window 设置为 2 Days。
要将 Click-through lookback Window 设置为 2 Days,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Integration 选项卡中,转到 安装 attribution** 部分。
3.将 Install engaged click-through lookback window 设置为 Days。
4.使用滑动条条将Window设置为 2 Days。
Unity Ads
2-day click-through lookback window
AppsFlyer 事件映射
要满足此验证Rule,请确保将All AppsFlyer 事件映射到正确的 Unity Event name。
要将 AppsFlyer 事件映射到 Unity 事件,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.将 POST 事件映射到 mapped to partner event 柱状图中的 Unity 事件,如下所示:
Unity Ads- 要的会话事件
session - 关卡完成事件
level_complete - 广告收入事件
ad_revenue - 应用内购事件
purchase
请参阅表以了解建议的 AppsFlyer 事件名称和所需的 Unity 事件名称:
|
|
|
|
|---|---|---|---|
会话 | | | - |
广告收入 | | | 如果您的 AppsFlyer 帐户支持 Ad Revenue 数据共享,请在 Ad Revenue 选项卡中启用 Get Ad Revenue data 切换。 否则,请勿发送广告收入事件。将 Mapping Ad Revenue 事件映射为其他事件类型(如 ),可能导致广告系列优化失效。有关详细信息和说明,请参阅 AppsFlyer Ad Revenue 归因 文档。 |
In-app Purchase | | | 不要将 Revenue 事件映射到购买事件。 |
完成重要步骤 |
| | 必须在映射到合作伙伴事件 Field 中进入 |
必须在 mapped to partner event Field 中输入所需的 Unity Event name。您可以在 AppsFlyer 事件 Field 中进入自定义 SDK 事件名称。但是,建议的最佳做法是使用此处提供的建议 AppsFlyer 事件名称。
In-app Purchase事件Mapping
要满足此验证Rule,请确保在 AppsFlyer 集成设置中正确ConfigureIn-app Purchase事件。
要映射 In-app Purchase 事件回传,请在 AppsFlyer 后台中执行以下步骤:
- 转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
Unity Ads - 转到 **Integration(集成)**选项卡 > **In-app event postbacks(应用内事件回传)**部分。
- 激活 **In-app event postbacks(应用内事件回传)**切换。
- 按如下方式映射购买事件行:
AppsFlyer 事件 | 映射到合作伙伴事件 | 适合的用户来源 | 包括 |
|---|---|---|---|
| | 所有媒体源,包括自然流量 | 值与收入 |

Purchase event mapping for In-app Purchase campaigns
In-app Purchase事件值和Revenue
要满足此验证规则,请确保在 AppsFlyer 集成设置中映射 In-app Purchase 事件时包含 Values & Revenue。
要在In-app Purchase事件回传中Configure包含的数据,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.在映表 include 柱状图,选择 Values & Revenue:
Unity Ads
Share Purchase event values and revenue
In-app Purchase传
要在投放广告系列的七天内满足此 Rule,您的应用必须在过去 90 天内收到一次 In-app Purchase 回传。
确保正确映映射买回传,并包含价值和Revenue。
要映射 In-app Purchase 事件回传,请在 AppsFlyer 后台中执行以下步骤:
- 转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
Unity Ads - 转到 **Integration(集成)**选项卡 > **In-app event postbacks(应用内事件回传)**部分。
- 激活 **In-app event postbacks(应用内事件回传)**切换。
- 按如下方式映射购买事件行:
AppsFlyer 事件 | 映射到合作伙伴事件 | 适合的用户来源 | 包括 |
|---|---|---|---|
| | 所有媒体源,包括自然流量 | 值与收入 |

Purchase event mapping for In-app Purchase campaigns
Ad Revenue事件值和Revenue
要满足此验证规则,请确保在 AppsFlyer 集成设置中映射 Ad Revenue 事件时包含 Values & Revenue。
要配置此数据共享设置,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.在映表 include 柱状图,选择 *Values & Revenue。
Unity Ads请参阅以下正确的 Mapping 示例:
AppsFlyer 事件 | 映射到合作伙伴事件 | 适合的用户来源 | 包括 |
|---|---|---|---|
| | 所有媒体来源,包括自然流量 | 数值及收入 |

Share Ad Revenue event values and revenue
广告收入回传
要在投放广告系列后的七天内满足此 Rule,您的应用必须在过去 90 天内收到过一次 Ad Revenue 回传。
确保在 AppsFlyer 集成设置中启用 Ad Revenue 数据。
若要与您的广告系列共享 Ad Revenue 事件数据,请在 AppsFlyer 后台中执行以下步骤:
Activate ad revenue sharing
要激活 Ad Revenue 数据共享,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Ad Revenue 选项卡中,激活 **Get Ad Revenue 数据 切换。
Unity Ads
Get ad revenue toggle
Configure ad revenue data-sharing
要配置 Ad Revenue 数据共享 Settings,请在 AppsFlyer 后台中执行以下步骤:
1.在 AppsFlyer 后台侧边菜单中,转到 Settings(设置) > Revenue Settings(收入设置)。
2.在 RevenueSettings > Ad Revenue 选项卡中,选择 新建Ad Revenue集成**。
3.在收入合作伙伴列表中选择 Unity Ads。
4.在合作伙伴配置中,选择 **Impression-level (via SDK) with Device-level (via S2S API)(广告展示级别(通过 SDK)与设备级别(通过 S2S API))**作为上报类型。

AppsFlyer Revenue settings configuration
Enter your API credentials
要完成 Ad Revenue 数据共享设置,请在 AppsFlyer Dashboard ** Revenue Settings** 中执行以下步骤:
1.在 App Key Field 字段中输入您的 Unity Game ID。如需从 Unity Dashboard(Unity 后台)获取 Game ID,请参考以下步骤:
要从用户获取后台复制 Game ID,请执行以下步骤:
- 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
- 滚动或搜索以找到所需的应用。
- 选择应用行末尾的 Settings (
) 以打开应用细节 Page。
- 转到 MMP Settings 部分。
- 选择 Game ID Next 旁边的复制 (
) 以将该 ID 复制到剪贴板。
2.在 Secret Key Field 中输入您的 Unity API 服务帐户 secret Key。如需从 Unity Dashboard(Unity 后台)获取 secret Key,请参考以下步骤:
要从用户获取后台获取您的 Secret Key 和 Key ID,请按以下步骤操作:
Create or open your service account
要Generate API 密钥,您需要一个服务帐户。要访问服务帐户,请执行以下步骤:
1.转到 Settings > API management。

API management
2.在 Stats API v2.0 部分,选择 Service account。
3.ON **Service Accounts Page上,从表选择您的帐户。如果没有服务帐户,请选择 + New(新建) 以创建一个帐户。
Generate keys
要GenerateKey和Key id,请执行以下步骤:
1.从服务帐户Page面中,转到 **密钥 部分。
2.选择 **+ Add key 可Generate *Key id 和 Secret Key。无法查视图以前生成的密钥。
3.选择 **Key ID(密钥 ID)**和 **Secret key(密钥)**后的复制按钮,复制两组凭据。
Assign the organization role
未分配角色的服务帐户仍可进行身份验证,但其发出的每个请求都会失败,并显示错误和无效凭据 message。在使用服务帐户的凭据之前,必须将 Advertise Stats API MMP Viewer** 角色分配给该帐户。
403要分配此角色,请从服务帐户执行以下步骤:
1.在 组织角色 部分中,选择 + 管理组织角色。
2.Open 用户获取 Category并选择 Advertise Stats API MMP Viewer**。
3.选择 Save。
关卡完成事件
要满足此验证规则,确保在 AppsFlyer 集成设置中映射关卡完成事件时选择 No values & no Revenue。
要在关卡完成回传中Configure包含的数据,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.在映表 include 柱状图中,选择 No values & no Revenue:
Unity Ads请参阅以下正确的 Mapping 示例:
AppsFlyer 事件 | 映射到合作伙伴事件 | 适合的用户来源 | 包括 |
|---|---|---|---|
| | 所有媒体来源,包括自然流量 | 没有值且没有 Revenue |

No values or revenue in level complete event postbacks
会话事件
要满足此验证规则,确保在 AppsFlyer 集成设置中映射会话事件时选择 No values & no Revenue。
要在会话事件回传中Configure包含的数据,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.在 事件行中,使用 include Dropdown 选择 No values & no Revenue:
Unity Adssession请参阅以下正确的 Mapping 示例:
AppsFlyer 事件 | 映射到合作伙伴事件 | 适合的用户来源 | 包括 |
|---|---|---|---|
| | 所有媒体来源,包括自然流量 | 没有值且没有 Revenue |

No values or revenue in session event postbacks
安装回传
要在投放广告系列后的两天内满足此 Rule,您的应用必须在过去 90 天内收到过一次安装回传。
确保正确配置安装归因和默认回传 Settings,以便广告系列可以接收安装回传:
- 启用 Share organic/non- organic indication(共享自然/非自然来源指示)切换。
- 将 click-through lookback Window 设置为 2 天。
- 将 View-through lookback Window 设置为 7 days。
- 启用 Install view-through attribution(安装查看归因)切换。
- 在安装事件默认回传设置中选择 for Users from > All Media sources。
要激活共享有机/非有机指示切换,请在 AppsFlyer 控制面板中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.在 Integration 选项卡中,转到 **General Settings 部分。
3.启用 **Share organic/non-organic indication(共享自然/非自然来源指示)**开关。
Unity Ads
Share organic and non-organic
建议的Rule决议
要满足建议的集成Rules,请参阅以下Resolution率信息。
未归因安装和有机安装
要满足此建议的集成Rule,请确保在 AppsFlyer 集成中正确Configure以下部分:
- General Settings:启用 **Share organic/non- organic indication(共享自然/非自然来源指示)**切换。
- 默认回传:使用 for users from Dropdown 下拉选单选择 All media sources, include organic(所有媒体来源,包括自然流量)。
要将安装回传Configure为包括All源(包括有机源),请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 Default postbacks 部分。
3.在 安装 事件行中,使用 for users from Dropdown 选择 All media sources, including organic。
Unity Ads
All installs, including organic
未归因和有机 In-app Purchase 事件
要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送 In-app Purchase 事件回传。
要为All来源(包括有机渠道)的Users发送In-app Purchase事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.在 事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
Unity Adspurchase
All media sources, including organic
未归因和有机 Ad Revenue 事件
要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送 Ad Revenue 事件回传。
要为All来源(包括有机渠道)的Users发送Ad Revenue事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.在 事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
Unity Adsad_revenue
All media sources, including organic
未归因和有机会话事件
要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送会话事件回传。
要为All来源(包括 organic)的Users发送会话事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.在 事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
Unity Adssession
All media sources, including organic
未归因关卡和有机关卡完成事件
要满足此推荐的集成规则,请确保为来自All media sources(包括有机媒体)的用户发送关卡完成事件回传。
要为来自 All 来源(包括 organic)的 Users 发送关卡完整事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.在 事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
Unity Adslevel_complete
All media sources, including organic
Lifetime postback Windows
要使用 AppsFlyer 满足此验证规则,请将应用内事件回传 Window 设置为 Lifetime。
要将回传 Window 长度设置为 Lifetime,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的。
2.转到 Integration 选项卡,转到 In-app event postbacks 部分。
3.启用 **In-app event postbacks(应用内事件回传)**开关。
4.将 **In-app event postback window(应用内事件回传窗口)**设置为 lifetime(生命周期)。
Unity Ads
Lifetime postback window