文档

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 优化的广告系列目标,包括以下内容:
  • [ON 广告支出返回](../../campaigns/ROAS/返回 ON-ad-spend-campaigns)(ROAS)
  • 事件优化 (CPE)
必须正确映射 In-app Purchase 事件。
  • In-app Purchase ROAS
  • 混合 ROAS
  • 付款人 CPE
[In-app Purchase 事件值和 Revenue](#in-app-purchase-event-values-and- Revenue)
In-app Purchase 事件回传必须包含值和 Revenue。
  • In-app Purchase ROAS
  • 混合 ROAS
  • 付款人 CPE
In-app Purchase传](#in-app-purchase-postbacks)
广告系列必须在发布后的七天内具有一个或多个 In-app Purchase 事件回传。
[Ad Revenue 事件值和 Revenue](#ad- Revenue-事件-values-and- Revenue)
Ad Revenue事件回传必须包含值和Revenue。
  • 广告收入 ROAS
  • 混合 ROAS
广告系列必须在投放后的七天内具有一个或多个 Ad Revenue 事件回传。
  • 广告收入 ROAS
  • 混合 ROAS
关卡完成事件回传不得包含值或 Revenue。
会话事件回传不得包含值或 Revenue。
  • [ Retention](../../campaigns/事件/intro-to-event-campaigns# Retention) CPE
[安装回传]安装postbacks)
在发布后的两天内,应用程序必须在过去 90 天内至少有一次安装回传。
All广告系列目标

所需的Rule解析

要满足所需的集成Rules,请参阅以下Resolution率信息。

游戏 ID

要满足此验证Rule,请确保在 AppsFlyer Dashboard(AppsFlyer 后台)中进入的Game ID 与 Unity 用户获取(用户获取)后台中的Game ID 完全匹配。
要在 AppsFlyer 集成设置中进入 Unity Game ID,请执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.在 Integration 选项卡中,转到 **General Settings 部分。 3.在 Unity Ads Game ID Field 字段中输入您的 Game ID。要从 Unity Dashboard 复制 Game ID,请参阅以下步骤:

要从用户获取后台复制 Game ID,请执行以下步骤:
  1. 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
  2. 滚动或搜索以找到所需的应用。
  3. 选择应用行末尾的 Settings () 以打开应用细节 Page。
  4. 转到 MMP Settings 部分。
  5. 选择 Game ID Next 旁边的复制 () 以将该 ID 复制到剪贴板。
Unity Ads Game ID(Unity Ads Game ID)

Unity Ads Game ID

View-through attribution(查看归因)

要满足此验证Rule,请确保在 AppsFlyer 集成设置中启用视图归因。
要启用视图归因,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.在 Integration 选项卡中,转到 安装 attribution** 部分。 3.启用 **Install view-through attribution(安装查看归因)**开关。
AppsFlyer 集成设置中的安装视图归因切换。

View-through attribution enabled

View lookback Window

要满足此验证规则,请将 View-through lookback Window 设置为 7 Days。
要将 视图 lookback Window设置为 7 天,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.在 Integration 选项卡中,转到 安装 attribution** 部分。 3.启用 **Install view-through attribution(安装查看归因)**开关。 4.将 Install engaged view-through lookback window 设置为 Days。 5.使用滑动条条将Window设置为 7 Days。
安装涉及 AppsFlyer 集成设置中的穿透视图回看 Window 设置。

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 集成的
Unity Ads
。 2.在 Integration 选项卡中,转到 安装 attribution** 部分。 3.将 Install engaged click-through lookback window 设置为 Days。 4.使用滑动条条将Window设置为 2 Days。
安装涉及 AppsFlyer 集成设置中的点击式回看 Window 设置。

2-day click-through lookback window

AppsFlyer 事件映射

要满足此验证Rule,请确保将All AppsFlyer 事件映射到正确的 Unity Event name。
要将 AppsFlyer 事件映射到 Unity 事件,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.启用 **In-app event postbacks(应用内事件回传)**开关。 4.将 POST 事件映射到 mapped to partner event 柱状图中的 Unity 事件,如下所示:
  • 要
    session
    的会话事件
  • 关卡完成事件
    level_complete
  • 广告收入事件
    ad_revenue
  • purchase
    应用内购事件
请参阅表以了解建议的 AppsFlyer 事件名称和所需的 Unity 事件名称:

事件类型

建议的 AppsFlyer 事件

必需 Unity 合作伙伴事件

Mapping 注意事项

会话
af_app_opened
session
-
广告收入
af_ad_revenue
ad_revenue
如果您的 AppsFlyer 帐户支持 Ad Revenue 数据共享,请在 Ad Revenue 选项卡中启用 Get Ad Revenue data 切换。
否则,请勿发送广告收入事件。将 Mapping Ad Revenue 事件映射为其他事件类型(如 ),可能导致广告系列优化失效。有关详细信息和说明,请参阅 AppsFlyer Ad Revenue 归因 文档。
In-app Purchase
af_purchase
purchase
不要将 Revenue 事件映射到购买事件。
完成重要步骤
  • af_level_achieved
  • {custom_milestone_event}
level_complete
必须在映射到合作伙伴事件 Field 中进入
level_complete
。您可以在 **AppsFlyer 事件 Field中进入自定义 SDK 事件名称。
必须在 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 后台中执行以下步骤:
  1. 转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
    Unity Ads
    。
  2. 转到 **Integration(集成)**选项卡 > **In-app event postbacks(应用内事件回传)**部分。
  3. 激活 **In-app event postbacks(应用内事件回传)**切换。
  4. 按如下方式映射购买事件行:

AppsFlyer 事件

映射到合作伙伴事件

适合的用户来源

包括

af_purchase
purchase
所有媒体源,包括自然流量值与收入
AppsFlyer 集成设置中的事件 Mapping 表。

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 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.启用 **In-app event postbacks(应用内事件回传)**开关。 4.在映表 include 柱状图,选择 Values & Revenue:
AppsFlyer 事件 Mapping 表中的 Values & Revenue 选择。

Share Purchase event values and revenue

In-app Purchase传

要在投放广告系列的七天内满足此 Rule,您的应用必须在过去 90 天内收到一次 In-app Purchase 回传。
确保正确映映射买回传,并包含价值和Revenue。
要映射 In-app Purchase 事件回传,请在 AppsFlyer 后台中执行以下步骤:
  1. 转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
    Unity Ads
    。
  2. 转到 **Integration(集成)**选项卡 > **In-app event postbacks(应用内事件回传)**部分。
  3. 激活 **In-app event postbacks(应用内事件回传)**切换。
  4. 按如下方式映射购买事件行:

AppsFlyer 事件

映射到合作伙伴事件

适合的用户来源

包括

af_purchase
purchase
所有媒体源,包括自然流量值与收入
AppsFlyer 集成设置中的事件 Mapping 表。

Purchase event mapping for In-app Purchase campaigns

Ad Revenue事件值和Revenue

要满足此验证规则,请确保在 AppsFlyer 集成设置中映射 Ad Revenue 事件时包含 Values & Revenue。
重要
要使用 AppsFlyer 映射 Ad Revenue 事件,必须首先[启用 Ad Revenue](#ad- Revenue-postbacks) 共享。有关详细信息和说明,请参阅 AppsFlyer Ad Revenue 归因 文档。
要配置此数据共享设置,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.启用 **In-app event postbacks(应用内事件回传)**开关。 4.在映表 include 柱状图,选择 *Values & Revenue。
请参阅以下正确的 Mapping 示例:

AppsFlyer 事件

映射到合作伙伴事件

适合的用户来源

包括

af_ad_revenue
ad_revenue
所有媒体来源,包括自然流量数值及收入
AppsFlyer 事件 Mapping 表中的 Values & Revenue 选择。

Share Ad Revenue event values and revenue

广告收入回传

要在投放广告系列后的七天内满足此 Rule,您的应用必须在过去 90 天内收到过一次 Ad Revenue 回传。
确保在 AppsFlyer 集成设置中启用 Ad Revenue 数据。
若要与您的广告系列共享 Ad Revenue 事件数据,请在 AppsFlyer 后台中执行以下步骤:
1

Activate ad revenue sharing

要激活 Ad Revenue 数据共享,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.在 Ad Revenue 选项卡中,激活 **Get Ad Revenue 数据 切换。
AppsFlyer 集成设置中的 Ad Revenue 选项卡和 Get Ad Revenue 切换。

Get ad revenue toggle

2

Configure ad revenue data-sharing

要配置 Ad Revenue 数据共享 Settings,请在 AppsFlyer 后台中执行以下步骤:
1.在 AppsFlyer 后台侧边菜单中,转到 Settings(设置) > Revenue Settings(收入设置)。
重要
要访问 **Revenue Settings 菜单,您需要 AppsFlyer ROI360 订阅。有关详细信息和说明,请参阅 AppsFlyer Ad Revenue 归因 文档。
2.在 RevenueSettings > Ad Revenue 选项卡中,选择 新建Ad Revenue集成**。
3.在收入合作伙伴列表中选择 Unity Ads。
4.在合作伙伴配置中,选择 **Impression-level (via SDK) with Device-level (via S2S API)(广告展示级别(通过 SDK)与设备级别(通过 S2S API))**作为上报类型。
AppsFlyer Ad Revenue 合作伙伴配置中的广告展示关卡和设备关卡选项。

AppsFlyer Revenue settings configuration

3

Enter your API credentials

要完成 Ad Revenue 数据共享设置,请在 AppsFlyer Dashboard ** Revenue Settings** 中执行以下步骤:
1.在 App Key Field 字段中输入您的 Unity Game ID。如需从 Unity Dashboard(Unity 后台)获取 Game ID,请参考以下步骤:

要从用户获取后台复制 Game ID,请执行以下步骤:
  1. 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
  2. 滚动或搜索以找到所需的应用。
  3. 选择应用行末尾的 Settings () 以打开应用细节 Page。
  4. 转到 MMP Settings 部分。
  5. 选择 Game ID Next 旁边的复制 () 以将该 ID 复制到剪贴板。
2.在 Secret Key Field 中输入您的 Unity API 服务帐户 secret Key。如需从 Unity Dashboard(Unity 后台)获取 secret Key,请参考以下步骤:

注意
只有组织所有者或组织管理员可以创建服务帐户和密钥。请参阅用户类型、角色和权限以了解更多信息。
要从用户获取后台获取您的 Secret Key 和 Key ID,请按以下步骤操作:
1

Create or open your service account

要Generate API 密钥,您需要一个服务帐户。要访问服务帐户,请执行以下步骤:
1.转到 Settings > API management。
用户获取后台的 API 管理 Page

API management

2.在 Stats API v2.0 部分,选择 Service account。 3.ON **Service Accounts Page上,从表选择您的帐户。如果没有服务帐户,请选择 + New(新建) 以创建一个帐户。
2

Generate keys

要GenerateKey和Key id,请执行以下步骤:
1.从服务帐户Page面中,转到 **密钥 部分。
2.选择 **+ Add key 可Generate *Key id 和 Secret Key。无法查视图以前生成的密钥。
3.选择 **Key ID(密钥 ID)**和 **Secret key(密钥)**后的复制按钮,复制两组凭据。
重要
后台仅显示一次 Secret Key。将 Key ID 和 Secret Key 存储在安全的地方。如果丢失了 Secret Key,则必须创建新建Key。
3

Assign the organization role

未分配角色的服务帐户仍可进行身份验证,但其发出的每个请求都会失败,并显示
403
错误和无效凭据 message。在使用服务帐户的凭据之前,必须将 Advertise Stats API MMP Viewer** 角色分配给该帐户。
要分配此角色,请从服务帐户执行以下步骤:
1.在 组织角色 部分中,选择 + 管理组织角色。
2.Open 用户获取 Category并选择 Advertise Stats API MMP Viewer**。
3.选择 Save。

关卡完成事件

要满足此验证规则,确保在 AppsFlyer 集成设置中映射关卡完成事件时选择 No values & no Revenue。
要在关卡完成回传中Configure包含的数据,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.启用 **In-app event postbacks(应用内事件回传)**开关。 4.在映表 include 柱状图中,选择 No values & no Revenue:
请参阅以下正确的 Mapping 示例:
注意
您可以在 AppsFlyer 事件 Field中进入自定义 SDK 事件名称。必须在映射到合作伙伴事件** Field 中进入
level_complete
。

AppsFlyer 事件

映射到合作伙伴事件

适合的用户来源

包括

af_level_achieved
level_complete
所有媒体来源,包括自然流量没有值且没有 Revenue
AppsFlyer 事件 Mapping 表中的 No values & no Revenue 选择。

No values or revenue in level complete event postbacks

会话事件

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

AppsFlyer 事件

映射到合作伙伴事件

适合的用户来源

包括

af_app_opened
session
所有媒体来源,包括自然流量没有值且没有 Revenue
AppsFlyer 事件 Mapping 表中的 No values & no 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 集成的
Unity Ads
。 2.在 Integration 选项卡中,转到 **General Settings 部分。 3.启用 **Share organic/non-organic indication(共享自然/非自然来源指示)**开关。
共享有机和非有机

Share organic and non-organic

要满足建议的集成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 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 Default postbacks 部分。 3.在 安装 事件行中,使用 for users from Dropdown 选择 All media sources, including organic。
All installs, include organic

All installs, including organic

未归因和有机 In-app Purchase 事件

要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送 In-app Purchase 事件回传。
要为All来源(包括有机渠道)的Users发送In-app Purchase事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.在
purchase
事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
所有媒体来源,包括有机流量

All media sources, including organic

未归因和有机 Ad Revenue 事件

要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送 Ad Revenue 事件回传。
要为All来源(包括有机渠道)的Users发送Ad Revenue事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.在
ad_revenue
事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
所有媒体来源,包括有机流量

All media sources, including organic

未归因和有机会话事件

要满足此建议的集成规则,请确保为来自所有媒体(包括有机媒体)的 Users 发送会话事件回传。
要为All来源(包括 organic)的Users发送会话事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.在
session
事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
所有媒体来源,包括有机流量

All media sources, including organic

未归因关卡和有机关卡完成事件

要满足此推荐的集成规则,请确保为来自All media sources(包括有机媒体)的用户发送关卡完成事件回传。
要为来自 All 来源(包括 organic)的 Users 发送关卡完整事件回传,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.在
level_complete
事件一行中,使用 for users from 下拉选单选择 All media sources, include organic
所有媒体来源,包括有机流量

All media sources, including organic

Lifetime postback Windows

要使用 AppsFlyer 满足此验证规则,请将应用内事件回传 Window 设置为 Lifetime。
要将回传 Window 长度设置为 Lifetime,请在 AppsFlyer 后台中执行以下步骤:
1.转到 Collaborate > 合作伙伴市场,搜索打开 Unity Ads 集成的
Unity Ads
。 2.转到 Integration 选项卡,转到 In-app event postbacks 部分。 3.启用 **In-app event postbacks(应用内事件回传)**开关。 4.将 **In-app event postback window(应用内事件回传窗口)**设置为 lifetime(生命周期)。
AppsFlyer 集成设置中的应用内事件回传 Window 设置。

Lifetime postback window