我们能为您提供什么帮助?

在 AppsFlyer 中添加应用

  • 更新

核心要点:了解如何在 AppsFlyer 中添加应用,以获取安装和应用内事件的归因数据,并使用 AppsFlyer 提供的各种工具分析数据。

概述

如果您尚未在 AppsFlyer 面板中添加应用,登录 AppsFlyer 后,系统会显示应用接入页面。该页面将引导您完成添加应用的所有步骤,并帮助您为归因做好准备。 

进入添加应用向导

您可以从平台进入添加应用向导,也可以通过应用接入页面添加应用(仅适用于 Android 和 iOS 应用)。

通过应用接入页面进入向导:

  • 在 Add your app(添加应用) 步骤中,点击 Add app(添加应用),然后按照提示操作。

注意

如果应用接入页面尚未打开,请在顶部菜单栏中点击电子邮件地址下拉菜单,然后选择 App onboarding(应用接入)。

onboarding page.png

通过平台进入添加应用向导:

  • 在顶部菜单栏中选择 My Apps(我的应用),然后点击 + Add app(添加应用)。
  • 在 AppsFlyer 首页点击 + Add app(添加应用)。
  • 在顶部菜单栏中打开账户菜单(电子邮件地址下拉菜单),选择 App onboarding(应用接入),然后点击 + Onboard another app(接入另一个应用)。

add an app (1).png

添加应用

进入 添加应用 向导后,按照以下步骤操作:

  1. 填写应用详细信息。
  2. 填写其他信息。
  3. 点击 Add my app(添加我的应用)。
  4. 复制 Dev Key,供 SDK 对接时使用(您也可以稍后在 应用设置页面中查看该密钥)。
  5. 点击 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 复制)

  • 示例:https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest&hl=en&gl=GB
  • 重要提示!
    • 如果您的应用未在美国的 Google Play 商店上架:
      • URL 必须包含应用实际上架的国家或地区代码,如上述示例所示:&gl={country_code}。如果未填写国家或地区代码,添加应用时会报错。
      • 语言代码为可选项: &hl={language_code}
    • 如果应用已在美国的 Google Play 商店上架,国家或地区代码和语言代码均为可选项。
等待审核/尚未发布 应用尚未发布,或正在等待 Google Play 审核

Android 包名

  • 示例:com.appsflyer.adNetworkTest
  • 注意:包名区分大小写
  • 格式要求:
    • 至少包含两个字段段落,各段之间以一个或多个句点分隔
    • 每个字段段落都必须以字母开头
    • 仅允许使用字母、数字和下划线(a-z、A-Z、0-9 或 _)
    • 最长为 100 个字符

详情请参阅 Android 开发者文档

第三方商店/非应用商店渠道 应用位于 Google Play 以外的 Android 应用商店,和/或可通过应用商店以外的渠道下载
  • Android 包名:具体要求请参阅上文。
  • 应用 URL:从第三方应用商店或应用下载页面复制。
  • 渠道名称(可选):您可以在为相应商店或下载渠道准备的 APK 文件的 AndroidManifest.xml 中设置唯一名称,例如 my_apk。渠道名称必须符合以下要求: 
<application>
     ...
     <meta-data android:name="CHANNEL" android:value="my_apk"/>
     ...
</application>

注意

不建议使用 channel 参数实现多商店归因。为简化对接流程并采用更标准化的实现方式,建议改用 af_store 参数。

 重要提示!

如果您的应用可以通过多个来源获取,例如 Google Play、第三方应用商店和应用商店以外的下载渠道,请务必考虑如何设置Android 多商店归因。  

iOS、tvOS 和 macOS

以下平台适用此选项:

  • iOS
  • tvOS
  • macOS
App Store 状态 适用情况 必填信息
已上架 应用已在 App Store 上架

App Store URL(从 App Store 复制)

  • 示例:https://apps.apple.com/us/app/partner-integrations/id1543229303
  • 注意事项:
    • URL 必须包含商店所在国家或地区的两位字母代码,例如上述 URL 中的 us
    • 如果应用在 2019 年 6 月 14 日之前已上架 App Store,其 URL 中可能包含 itunes.apple.com,而不是 apps.apple.com。
等待审核/尚未发布

应用尚未发布,或正在等待 App Store 审核

 

应用提交至的 App Store 所在国家或地区

 

App Store 分配的应用 ID,不包含前缀 id

  • 示例:1543229303
  • 格式:由 9 位或 10 位数字组成,仅允许使用 0-9

Windows

以下平台适用此选项:

  • Windows Phone
  • Windows(桌面端)
Microsoft Store 状态 适用情况 必填信息
已上架 应用已在 Microsoft Store 上架

Microsoft Store URL(从 Microsoft Store 复制)

  • 示例:https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • 注意:上述 URL 是 Windows Phone 应用的示例。 Windows 桌面端应用的 URL 格式可能有所不同。

应用 ID:最长为 150 个字符。

等待审核/尚未发布

应用尚未发布,或正在等待商店审核

 

Microsoft Store 分配的应用 ID

  • 最长为:150 个字符
  • 示例:9wzdncrfhwfg
  • 注意:应用 ID 区分大小写

Web(PBA)

 注意

Web 应用用于定义一个网站,并将其纳入 People-Based Attribution(PBA,基于用户的归因)功能所使用的品牌组合。

  • 此选项仅向已订阅 PBA 的客户开放。
  • 了解更多关于 PBA,以及如何归因网站访问、网页事件和由网站辅助促成的应用安装,从而统一查看用户在不同渠道、平台和设备上的旅程。

 

完整 URL:输入您希望衡量流量的网站完整 URL。您需要在该网站上部署或计划部署 PBA网页端SDK。

URL_diagram

URL 需要包含 –

  • 协议
  • 子域名【可选】
  • 域名
  • 顶级域名
  • 路径[可选]– 用于指定网站上的某个目录或页面

应用名称:您为该应用选择的名称 

  • 最长为 100 个字符
  • 不允许使用 XSS 标签

 重要提示!

创建网页端应用后,如果要修改其属性(URL 和应用名称),必须先删除该应用,再重新创建;这也意味着您必须删除该应用所属的品牌组合。

后续步骤:

  • 将新创建的网页端应用添加到 PBA 品牌组合中,以便在 PBA 面板中查看。
    • 创建品牌组合前,请确保已将所有计划纳入该品牌组合的移动应用添加到账户中。
  • 在网页端应用指定的网站上对接 PBA网页端SDK,以开始获取衡量数据。

Web

使用网页端平台创建新的网页端应用,通过网页端Performance Measurement(网页效果衡量)衡量网站访问和转化。

开始之前

  • 旧版 People-Based Attribution(PBA)Web 应用会显示在「Web(PBA)」分类下,并标记为「Legacy(旧版)」。
  • 如果您正在从旧版 PBA网页端应用迁移,可以继续使用现有的 PBA网页端Dev Key。

添加网页端应用

  1. 进入 My Apps(我的应用) > Add app(添加应用)。
  2. 选择 Website(网站)。
  3. 填写以下信息。

 

应用名称:为网页端应用选择的名称。

  • 长度: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)
  • 从下拉菜单中选择
  • 此项为必填项

 

  1. 点击 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? 

  1. 通过相关链接登录 Samsung TV Seller Office。
    1. 输入开发者 URL。
  2. 系统会自动生成并显示 Bundle ID。您可以使用该 ID 访问应用商店 URL。
  3. 如果遇到问题,请在 Seller Office 中提交工单。
注意:要访问应用专属的商店网页,请将 Bundle ID 添加到以下 URL 中:“https://www.samsung.com/us/appstore/app/”。 
例如,如果 Bundle ID 为“G15147002586”,对应的网页 URL 为:“https://www.samsung.com/us/appstore/app/G15147002586/”。该页面的元数据中会显示开发者 URL、Bundle ID 和应用商店 ID。

LG WebOS

应用名称:您为应用选择的名称。

应用 ID:LG WebOS 应用 ID。

  • 格式要求:
    • 最长为 50 个字符
    • 使用类似 Bundle ID 的格式,可包含 A-Z a-z._ 必须以字母开头。
  • 示例:com.my-company.app 

如需确认应用 ID,请联系您的 LG WebOS 对接代表。  

PlayStation

应用名称:您为应用选择的名称。

应用 ID:PlayStation concept ID,即分配给游戏或其他内容项目的唯一标识符。该 ID 是 PlayStation 商店 URL 中的一个 5–9 位数字。该 ID 位于应用商店 URL 的末尾:

playstation_app_id_url.png

Vidaa

应用名称:您为应用选择的名称。

应用 ID:Vidaa 应用 ID。最长为 50 个字符。

Steam

应用名称:您为应用选择的名称。

应用 ID:Steam 应用 ID。即 Steam 商店 URL 中显示的 5–8 位数字:

steam_store_app_url.png

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(是):

  1. 打开并阅读有关如何为面向儿童的应用实施合规要求的指南。
  2. 勾选确认框,确认您已阅读该指南,并将按照指南要求实施相应的控制措施。

注意

  • 添加应用两周后,系统会向您发送通知,要求您确认已为面向儿童的应用实施隐私控制措施。确认后,您将收到确认消息。您可以随时在通知中心查看该消息,也可以在审计日志中查看确认详情。
  • 有关面向儿童的应用,请参阅常见问题。

通过 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 应用时,有时会出现此错误。请按照以下步骤解决:

  1. 按照上文所述,将应用状态设置为等待审核/尚未发布,然后添加应用。
  2. 进入 AppsFlyer 的应用设置页面。
  3. 将应用商店国家/地区更改为正确的选项(例如日本)。

出现错误:“出了点问题,请重试。”

一种可能的原因是:尝试添加 Android 应用时没有填写国家或地区代码,而该应用又未在美国的 Google Play 商店上架。请参阅上文的详细说明,了解如何解决此问题。

我的 iOS 应用已从 App Store 下架,为什么仍然能看到安装数据?

这是因为,如果用户的设备之前安装过该应用,操作系统仍可能允许用户重新安装。因此,即使应用已不再出现在 App Store 中,用户仍可能安装该应用,而这些安装仍会计入 AppsFlyer 的统计数据。

其他信息

产品线

您可以向产品线添加应用,也可以从产品线中移除应用。有关产品线及其功能的详细信息,请参阅产品线相关文档。