核心要点:了解如何在 AppsFlyer 中添加应用,以获取安装和应用内事件的归因数据,并使用 AppsFlyer 提供的各种工具分析数据。
概述
如果您尚未在 AppsFlyer 面板中添加应用,登录 AppsFlyer 后,系统会显示应用接入页面。该页面将引导您完成添加应用的所有步骤,并帮助您为归因做好准备。
进入添加应用向导
您可以从平台进入添加应用向导,也可以通过应用接入页面添加应用(仅适用于 Android 和 iOS 应用)。
通过应用接入页面进入向导:
- 在 Add your app(添加应用) 步骤中,点击 Add app(添加应用),然后按照提示操作。
注意
如果应用接入页面尚未打开,请在顶部菜单栏中点击电子邮件地址下拉菜单,然后选择 App onboarding(应用接入)。
通过平台进入添加应用向导:
- 在顶部菜单栏中选择 My Apps(我的应用),然后点击 + Add app(添加应用)。
- 在 AppsFlyer 首页点击 + Add app(添加应用)。
- 在顶部菜单栏中打开账户菜单(电子邮件地址下拉菜单),选择 App onboarding(应用接入),然后点击 + Onboard another app(接入另一个应用)。
添加应用
进入 添加应用 向导后,按照以下步骤操作:
- 填写应用详细信息。
- 填写其他信息。
- 点击 Add my app(添加我的应用)。
- 复制 Dev Key,供 SDK 对接时使用(您也可以稍后在 应用设置页面中查看该密钥)。
- 点击 Done(完成),或点击 + Add another app(添加另一个应用)继续添加其他应用。重复上述步骤即可。
注意
- 只有管理员及拥有相应权限的账户用户才能添加应用。
- 添加应用时,可选项会根据您之前选择的选项而有所不同。
注册应用后,该应用会显示在面板中。要确保系统记录安装和应用内事件,并将其正确归因到相应的媒体渠道,您还需要:
- 对接 SDK。
- 在合作伙伴市场中将应用与合作伙伴关联。
请参阅完整的应用接入流程说明,了解如何完成后续步骤。
填写应用详细信息
选择应用所属的平台,并填写相应的必填信息,如下所示:
Android、Android TV 和 Fire
以下平台适用此选项:
- Android(移动端)
- Android TV
- Amazon Fire
- Amazon Fire TV
- Kindle
| Google Play 状态 | 适用情况 | 必填信息 |
|---|---|---|
| 已上架 | 应用已在 Google Play 商店上架 |
Google Play URL(从 Google Play 复制)
|
| 等待审核/尚未发布 | 应用尚未发布,或正在等待 Google Play 审核 |
Android 包名
详情请参阅 Android 开发者文档 |
| 第三方商店/非应用商店渠道 | 应用位于 Google Play 以外的 Android 应用商店,和/或可通过应用商店以外的渠道下载 |
注意不建议使用 channel 参数实现多商店归因。为简化对接流程并采用更标准化的实现方式,建议改用 af_store 参数。 重要提示!如果您的应用可以通过多个来源获取,例如 Google Play、第三方应用商店和应用商店以外的下载渠道,请务必考虑如何设置Android 多商店归因。 |
iOS、tvOS 和 macOS
以下平台适用此选项:
- iOS
- tvOS
- macOS
| App Store 状态 | 适用情况 | 必填信息 |
|---|---|---|
| 已上架 | 应用已在 App Store 上架 |
App Store URL(从 App Store 复制)
|
| 等待审核/尚未发布 |
应用尚未发布,或正在等待 App Store 审核
|
应用提交至的 App Store 所在国家或地区
App Store 分配的应用 ID,不包含前缀 id
|
Windows
以下平台适用此选项:
- Windows Phone
- Windows(桌面端)
| Microsoft Store 状态 | 适用情况 | 必填信息 |
|---|---|---|
| 已上架 | 应用已在 Microsoft Store 上架 |
Microsoft Store URL(从 Microsoft Store 复制)
应用 ID:最长为 150 个字符。 |
| 等待审核/尚未发布 |
应用尚未发布,或正在等待商店审核
|
Microsoft Store 分配的应用 ID
|
Web(PBA)
注意
Web 应用用于定义一个网站,并将其纳入 People-Based Attribution(PBA,基于用户的归因)功能所使用的品牌组合。
- 此选项仅向已订阅 PBA 的客户开放。
- 了解更多关于 PBA,以及如何归因网站访问、网页事件和由网站辅助促成的应用安装,从而统一查看用户在不同渠道、平台和设备上的旅程。
完整 URL:输入您希望衡量流量的网站完整 URL。您需要在该网站上部署或计划部署 PBA网页端SDK。
URL 需要包含 –
- 协议
- 子域名【可选】
- 域名
- 顶级域名
- 路径[可选]– 用于指定网站上的某个目录或页面
应用名称:您为该应用选择的名称
- 最长为 100 个字符
- 不允许使用 XSS 标签
重要提示!
创建网页端应用后,如果要修改其属性(URL 和应用名称),必须先删除该应用,再重新创建;这也意味着您必须删除该应用所属的品牌组合。
后续步骤:
- 将新创建的网页端应用添加到 PBA 品牌组合中,以便在 PBA 面板中查看。
- 创建品牌组合前,请确保已将所有计划纳入该品牌组合的移动应用添加到账户中。
- 在网页端应用指定的网站上对接 PBA网页端SDK,以开始获取衡量数据。
Web
使用网页端平台创建新的网页端应用,通过网页端Performance Measurement(网页效果衡量)衡量网站访问和转化。
开始之前
- 旧版 People-Based Attribution(PBA)Web 应用会显示在「Web(PBA)」分类下,并标记为「Legacy(旧版)」。
- 如果您正在从旧版 PBA网页端应用迁移,可以继续使用现有的 PBA网页端Dev Key。
添加网页端应用
- 进入 My Apps(我的应用) > Add app(添加应用)。
- 选择 Website(网站)。
- 填写以下信息。
应用名称:为网页端应用选择的名称。
- 长度:1–100 个字符
- 允许使用的字符:各语言的字母、数字、空格(不能位于开头或结尾),以及以下特殊字符:. - _ :
- 不允许使用的字符: ; { } $ < > ` \
示例:My Online Store、Corporate Website 2024、E-Commerce_Production
主域名(完整 URL):网站的主域名。创建网页端应用时需要设置此项,创建后无法修改。
- 格式:有效的域名,不包含协议、路径或端口
- 长度:最多 500 个字符
-
处理:AppsFlyer 会自动执行以下处理
- 移除 http:// 或 https://
- 移除末尾的斜杠
- 将域名转换为小写
- 不可修改:创建应用后,无法编辑主域名
重要提示:如果需要更改主域名,必须删除并重新创建网页端应用,这会导致历史数据的连续性受到影响。
示例:
- https://shop.example.com/checkout → 保存为 shop.example.com → 应用 ID:website-shop.example.com
- example.com/ → 保存为 example.com → 应用 ID:website-example.com
应用 ID:AppsFlyer 根据主域名为网页端应用生成的唯一 ID。
- 系统会按照以下格式自动生成:website-<primary_domain>
- 示例:website-shop.example.com
Web SDK ID:Web SDK 用于归因的标识符(之前称为 web_dev_key)。
创建应用时有两种选择:
选项 1:生成新的 ID(默认)
- 自动创建新的网页端SDK ID
- 格式:website-{yourdomain.com}
- 示例:website-shop.example.com
- 适用场景:全新的网页归因对接
选项 2:沿用现有 PBA Dev Key
- 从下拉菜单中选择现有 PBA(People-Based Attribution)Web 应用的 Dev Key
- 无需修改网站代码,即可平滑迁移
- 适用场景:从旧版 PBA 迁移至新的网页归因解决方案
注意:沿用 PBA Dev Key 后,您无需修改网站的现有实现,即可从 PBA 迁移到新的网页端应用
每个 PBA Dev Key 只能分配给一个Web 应用。分配给某个网页端应用后,该密钥便不能再用于其他网页端应用。
- 长度:1–550 个字符
- 不可修改:创建应用后无法更改
- PBA 迁移:下拉菜单中仅显示您账户下 PBA网页端应用所使用的 Dev Key
币种:应用报告所使用的币种。
- 使用标准 ISO 4217 币种代码(例如 USD、EUR、GBP、ILS)
- 从下拉菜单中选择
- 此项为必填项
时区:应用报告所使用的时区。
- 使用 IANA 时区格式(例如 America/New_York、Europe/London、Asia/Tokyo)
- 从下拉菜单中选择
- 此项为必填项
- 点击 Create app(创建应用)。
限制
- 创建应用后,无法更改主域名。
- 主域名会自动以 PRIMARY 类型添加到 Excluded Domains(排除域名)。
每个旧版 Web Dev Key 只能用于一个新的网页端应用。
注意
有关网页归因设置的完整信息,请参阅相关文档。
Roku
应用名称:从 Roku Developer Dashboard(Roku 开发者面板)复制的频道名称。
- 示例:My Roku channel
-
格式要求:
- 最长为 100 个字符
- 不允许使用 XSS 标签
频道 ID:Roku 分配给该频道的数字 ID。
-
格式要求:
- 仅允许使用数字(0–9)
- 最长为 50 个字符
-
如何查找频道 ID?
- 打开 Roku Developer Dashboard,点击要添加到 AppsFlyer 的频道名称,进入该频道的 Roku Preview & Publish 页面。这将打开该频道的 Roku Preview & Publish 页面。
-
页面 URL 末尾的数字就是频道 ID:
Amazon Vega OS
应用名称:您为应用选择的名称。
应用 ID:应用的 ID。采用反向 DNS 格式:<tld>.<company_name>.<app_name>
至少包含两个字段段落。每个字段段落都必须以字母开头,后续可使用 A-Z a-z 0-9. -
示例:com.company.my_app
详情请参阅 Amazon Vega OS 文档中的“id”字段。
Vizio SmartCast
应用名称:您为应用选择的名称。
应用 ID:Vizio 识别的应用 ID。必须以 vizio. 开头,后续包含 2–10 个字符,可使用 A-Z a-z 0-9. -。如需确认应用 ID,请联系您的 Vizio 对接代表。
Samsung Tizen
应用名称:您为应用选择的名称。
应用 ID:Samsung 分配给应用的 Bundle ID。以字母 G 开头,后跟 8–15 位数字。如何获取应用 ID?
-
通过相关链接登录 Samsung TV Seller Office。
- 输入开发者 URL。
- 系统会自动生成并显示 Bundle ID。您可以使用该 ID 访问应用商店 URL。
- 如果遇到问题,请在 Seller Office 中提交工单。
LG WebOS
应用名称:您为应用选择的名称。
应用 ID:LG WebOS 应用 ID。
-
格式要求:
- 最长为 50 个字符
- 使用类似 Bundle ID 的格式,可包含
A-Za-z._必须以字母开头。
- 示例:com.my-company.app
如需确认应用 ID,请联系您的 LG WebOS 对接代表。
PlayStation
应用名称:您为应用选择的名称。
应用 ID:PlayStation concept ID,即分配给游戏或其他内容项目的唯一标识符。该 ID 是 PlayStation 商店 URL 中的一个 5–9 位数字。该 ID 位于应用商店 URL 的末尾:
Vidaa
应用名称:您为应用选择的名称。
应用 ID:Vidaa 应用 ID。最长为 50 个字符。
Steam
应用名称:您为应用选择的名称。
应用 ID:Steam 应用 ID。即 Steam 商店 URL 中显示的 5–8 位数字:
Meta Quest(Oculus)
应用名称:您为应用选择的名称。
应用 ID:Meta Quest 应用 ID,显示在下载该应用的 Meta 应用商店 URL 末尾。长度为 3–50 个字符,可使用 A-Z a-z0-9._-
Nintendo Switch
应用名称:您为应用选择的名称。
应用 ID:Nintendo Switch 应用 ID,显示在下载该应用的商店 URL 末尾。由 14 位数字组成。
- 示例:70010000012345
Xbox
应用名称:您为应用选择的名称。
应用 ID:Xbox 应用 ID,显示在下载该应用的 Xbox 商店 URL 末尾。仅包含 12 位字母和数字(A-Z a-z0-9)。
注意:应用 ID 区分大小写。
Epic Games
应用名称:您为应用选择的名称。
应用 ID:Epic Games 应用 ID,可在下载该应用的商店中找到。长度为 3–50 个字符,可使用:A-Z a-z0-9._-。
Native PC
应用名称:您为应用选择的名称。
应用 ID:Native PC 应用 ID。长度为 3–50 个字符,可使用:A-Z a-z0-9._-。
填写其他信息(不适用于网页端应用):
选择币种
选择应用数据在面板中显示时使用的币种。系统会根据事件发生时适用的汇率,将收入和支出事件转换为所选币种。详情请参阅有关应用币种设置及其影响的说明。
重要提示!
请谨慎选择应用币种。一旦系统记录了成本和收入数据,就无法再更改币种。
选择时区
此处选择的时区应与您在其他归因合作伙伴平台(例如 Meta Ads 和 Google Ads)中设置的时区保持一致。这样可以尽可能确保 AppsFlyer 面板中的数据与合作伙伴提供的数据相匹配。
注意
- 设置时区后,该设置会被锁定,直到次日才能更改。
- 详情请参阅有关应用时区设置及其影响的说明。
定义应用受众
选择 Yes(是) 或 No(否),说明您的应用是否面向儿童,或是否面向混合受众(包括儿童和成人)。
如果选择 Yes(是):
- 打开并阅读有关如何为面向儿童的应用实施合规要求的指南。
- 勾选确认框,确认您已阅读该指南,并将按照指南要求实施相应的控制措施。
注意
通过 API 批量管理应用
账户管理员可以通过专用 API 批量管理多个应用。该 API 支持界面中的主要功能,包括添加和删除应用,以及更新应用设置。该 API 同时还采用了相同的错误验证机制。
注意
目前,通过 API 添加应用和更新应用设置仅适用于移动应用;删除应用则适用于所有平台。
添加调试或测试应用
如果开发人员创建了调试、沙盒或测试应用,您必须先将其添加到面板。开发人员开始使用该应用进行测试后,相关数据便会显示在该应用的面板中。
注意
对于尚未在 App Store 上架且没有有效 App Store ID 的 iOS 应用,您仍然可以使用虚拟的 iOS App Store ID添加应用,并继续进行 SDK 测试。这样无需真实的 App Store 上架记录,也可以对接 SDK 并开展测试。
有关如何创建调试应用并将其添加到面板的开发说明,请参阅:
关于待发布应用
在调试应用或测试 AppsFlyer SDK 时,将应用设置为待发布状态会很有帮助。
应用在面板中显示为待发布状态,不会影响数据采集和衡量。无论应用在应用商店中处于待发布状态还是已正式上线,只要用户安装并使用该应用,安装数据和应用内事件数据都会照常记录在面板中。
待发布应用正式上线后,AppsFlyer 会自动检测并更新其状态,因此您无需重新添加应用。详情请参阅有关待发布应用的说明,以及如何手动刷新应用状态的可选操作步骤,请了解更多。
故障排查
以下是一些常见问题及解决方法:
无法添加应用
如果出现此错误,请联系您的客户成功经理(CSM),或发送电子邮件至hello@appsflyer.com。
应用未在商店中上架
请确认您复制的商店 URL 正确,并且使用了相应的应用名称或应用 ID。
无法访问应用市场
从非美国地区的商店添加 Android 应用时,有时会出现此错误。请按照以下步骤解决:
- 按照上文所述,将应用状态设置为等待审核/尚未发布,然后添加应用。
- 进入 AppsFlyer 的应用设置页面。
- 将应用商店国家/地区更改为正确的选项(例如日本)。
出现错误:“出了点问题,请重试。”
一种可能的原因是:尝试添加 Android 应用时没有填写国家或地区代码,而该应用又未在美国的 Google Play 商店上架。请参阅上文的详细说明,了解如何解决此问题。
我的 iOS 应用已从 App Store 下架,为什么仍然能看到安装数据?
这是因为,如果用户的设备之前安装过该应用,操作系统仍可能允许用户重新安装。因此,即使应用已不再出现在 App Store 中,用户仍可能安装该应用,而这些安装仍会计入 AppsFlyer 的统计数据。
其他信息
产品线
您可以向产品线添加应用,也可以从产品线中移除应用。有关产品线及其功能的详细信息,请参阅产品线相关文档。