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

搜索

在AppsFlyer后台添加应用

  • 更新

概要：本文说明了在AppsFlyer中添加应用的方法。添加完毕后，您就能获取其激活和应用内事件的归因数据，并通过AppsFlyer提供的各种工具进行数据分析。

速览

如果您还未在面板中添加任何应用，您登入AppsFlyer时界面就会显示应用入驻页面。应用入驻页面会指导您完成添加应用的所有步骤，并做好归因启用前的准备工作。 

使用向导工具添加应用

您可以使用平台中的向导工具添加应用，也可以通过应用入驻页面添加应用（仅适用于安卓和iOS应用）。

请按以下方式从应用入驻页面进入向导工具：

  • 在添加您的应用这一步中，点击添加应用，然后按照界面显示的提示说明添加应用。

 注意

如果界面未显示应用入驻页面，请打开面板右上角的邮箱地址下拉菜单，然后点击应用入驻。

onboarding page.png

您可以通过以下任一方式从后台进入添加应用的向导工具：

  • 从顶部菜单栏进入我的应用，点击+添加应用
  • 进入AppsFlyer主页，点击+添加应用
  • 从页面顶部导航栏打开账户菜单（点击右上角的邮箱地址，打开下拉菜单）> 应用入驻，点击+添加其它应用

add an app (1).png

添加应用

进入添加应用向导工具后，请依次完成以下步骤：

  1. 输入相关应用的详细信息。
  2. 输入其他相关信息。
  3. 点击添加我的应用。
  4. 复制该Dev key，SDK对接流程中会用到这一信息（也可后续在应用配置页面中获取该信息）。
  5. 根据实际需求点击完成或+添加其他应用。若选择添加其他应用，请重复上述流程。

 注意

  • 只有AppsFlyer账户的管理员和具有必要权限的用户可以添加应用。
  • 按下文步骤添加应用时，每一步的可用选项取决于前一步的设置。

相关应用注册完毕后，就会显示在面板中。如需记录该应用的激活和应用内事件，并将其正确归因到相关渠道，您需要完成以下操作：

  • 在相关应用中接入SDK
  • 将该应用对接到Partner Marketplace平台中的渠道

如需查看完整的入驻流程，请参考此文档。

输入 app 信息

选择应用平台并输入必填信息，选项如下：

安卓、AndroidTV、Fire

该选项适用于以下平台：

  • 安卓（移动端）
  • AndroidTV
  • 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=。如果您没有添加国家代码，就会收到“添加应用出错”的报错消息。
      • 语言代码是可选配置，以&hl={language_code}表达
    • 如果您的应用在美国的Google Play商店上架，那么国家和语言代码都是可选配置。
待批准/未发布 您的尚未在Google Play上架或仍在审核中

安卓包名

  • 示例：com.appsflyer.adNetworkTest
  • 请注意：注意：包名区分大小写
  • 格式：
    • 至少两段（即至少带有一个点号）
    • 每段都必须以字母开头
    • 仅可使用字母、数字和下划线（a-z、A-Z、0-9、和_）
    • 最多可包含200个字符

详情请见安卓技术文档
第三方商店/非商店下载 您的应用在Google Play以外的安卓应用商店中上架，和/或可以通过应用商店以外的地址下载
  • 安卓包名详细要求请见上一行（待审批/未上架场景）

  • 频道名称：（可选）您在为该应用商店/发布位置准备的 APK 的 AndroidManifest.xml 文件中设置的唯一名称。例如，对于亚马逊商店的 APK，请在 标签application内添加以下内容。名称必须区分大小写，且必须与您在添加应用时在“频道名称”字段中输入的名称完全一致。有关更多信息，请参见这里 。

    <application>
     ...
     <meta-data android:name="CHANNEL" android:value="Amazon"/>
     ...
</application>
  • App URL（从第三方应用商店或非商店下载地址复制）

 重要提示！

如果您的应用可以通过多种渠道下载（即Google Play、第三方商店和非商店下载地址的任意一种组合），请务必了解一下多商店安卓归因设置的各种方案。强烈建议您在使用归因衡量服务之初中就做出正确的配置，这样才能确保您获取的数据以及数据的格式符合您的实际需求。 

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中包含2个字母组成的国家代码，代表应用商店所在的国家（如上述URL中的us）
    • 对于在2019年6月14日之前添加到App Store的应用，其URL中可能包含itunes.apple.com（而非apps.apple.com）。
待批准/未发布

您的应用尚未在App Store上架或仍在审核中

 

在App Store中提交相关应用时所选择的国家

 

由App Store指定的App ID，不带前缀“id”

  • 示例：1543229303
  • 格式：9 或 10 个数字字符，0-9

Windows

该选项适用于以下平台：

  • Windowsphone
  • Windows（PC端）
Microsoft Store中的状态 使用场景 必填信息
已上架 您的应用已在Microsoft Store上架

Microsoft Store URL（从Microsoft Store复制）

  • 示例：https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • 请注意：请注意：上述URL是Windows Phone应用的URL示例。PC端Windows应用的URL格式与此不同。

App ID：最多可包含150个字符.
待批准/未发布

您的应用尚未上架或仍在审核中

 

由Microsoft Store指定的App ID

  • 最多可包含150个字符
  • 示例：9wzdncrfhwfg
  • 请注意：应用ID区分大小写。

网页（PBA）

 注意

网页应用是指您在PBA（基于用户的归因）功能的品牌套件中设定的网页。

  • 该选项仅对购买了PBA功能的客户可用。
  • 如需进一步了解PBA（基于用户的归因）以及网页访问、网页事件和网页助攻激活的归因，请参考此文档。该功能可帮助您全面掌握跨渠道、跨平台、跨设备的用户链路。

 

完整URL：完整URL：如果您需要衡量某个网站的流量，并且已经（或将要）在某个网站中接入PBA Web SDK，请在添加该网页应用时填写其完整URL。

URL_diagram

其中包括以下内容：

  • scheme
  • 子域名【可选】
  • 域名
  • 顶级域名（Top-level Domain）。
  • 路径【可选】–网站中某个特定目录或页面的地址

应用名称：您为相关应用设定的 

  • 最多可包含100个字符
  • 不支持XSS标签

 重要提示！

网页应用创建完毕后，就无法再修改其属性（即URL和应用名称）。如需要修改其属性，必须先将其删除然后重新创建，也就是说您必须同时删除包含该网页应用的品牌套件。

下一步：

  • 将您新创建的网页应用添加到PBA品牌套件中，这样就能在PBA面板中查看其数据。
    • 在创建品牌套件前，请先确保所有需要通过品牌套件监测的应用都已添加到您的账户中。
  • 在该网页应用对应的网站中接入PBA网页SDK，打通各端衡量数据的串联。

网页

使用 Web 平台创建一个新的 Web 应用，并通过 Web Attribution 功能衡量网站访问量和转化情况。

开始之前

  • 旧版基于用户的归因（PBA）Web 应用会显示在“Web (PBA)”下，并标注为“旧版”。
  • 如果您是从旧版 PBA Web 应用程序迁移而来，可以使用现有的 PBA Web 开发密钥。

添加 Web 应用

  1. 前往“我的应用” > “添加应用”。
  2. 选择网站。
  3. 请输入以下内容：

 

应用名称您为相关应用设定的

  • 长度1000个字符以内，
  • 允许的字符：字母（任何语言）、数字、空格（不能位于开头或结尾）以及特殊字符：. - _ :
  • 被屏蔽的字符： ; { } $ < > ` \

示例：我的网店，企业网站 2024，电子商务_制作

 

主域名（完整网址）：您网站的主域名。此设置在创建 Web 应用时确定，之后无法更改。

  • 格式：仅限有效的域名（不包含协议、路径或端口）
  • 长度最多500个字符
  • 处理中AppsFlyer 会自动
    • 删除 http:// 或 https://
    • 移除末尾的斜杠
    • 将域名转换为小写
  • 不可变性：应用创建后无法编辑

重要通知｜要更改主域名，您必须删除并重新创建 Web 应用，这将导致历史数据的连续性中断。

如

  • https://shop.example.com/checkout → 存储为 shop.example.com → 应用 ID：website-shop.example.com
  • example.com/ → 存储为 example.com → 应用 ID：website-example.com

 

App ID（应用ID）AppsFlyer 根据主域名为该 Web 应用生成的唯一标识符。

  • 使用以下格式自动生成：website-<primary_domain>
  • 示例：website-shop.example.com

 

Web SDK ID：Web SDK 用于归因的标识符（此前称为 web_dev_key）。

在创建应用时有两种选项：

Option 1:生成新内容（默认）

  • 自动创建一个新的 Web SDK ID
  • 格式：website-{yourdomain.com}
  • 示例：website-shop.example.com
  • 使用场景新的网络归因实现方案

Option 2:重复使用现有的 PBA 开发密钥

  • 从现有 PBA（基于用户的归因）Web 应用开发密钥的下拉菜单中进行选择
  • 无需修改网站代码即可实现无缝迁移
  • 使用场景从旧版 PBA 迁移至新的网络归因解决方案

请注意：重复使用 PBA 开发密钥，可让您在无需更改网站实现的情况下，从 PBA 迁移至新的 Web 应用。 

每个 PBA 开发者密钥只能分配给一个 Web 应用。一旦某个 PBA 开发者密钥被用于某个 Web 应用，该密钥就无法再用于其他 Web 应用。

  • 长度1000个字符以内，
  • 不可变性：应用创建后无法更改
  • PBA 迁移：下拉菜单中仅显示您账户中 PBA 网络应用的开发者密钥

 

货币：该应用报告中使用的货币。

  • ISO 4217 标准货币代码（例如：USD、EUR、GBP、ILS）
  • 从下拉菜单中选择
  • 必填字段

 

时区该应用报告所使用的时区。

  • IANA 时区格式（例如：America/New_York、Europe/London、Asia/Tokyo）
  • 从下拉菜单中选择
  • 必填字段

 

  1. 点击“创建应用”。

 

局限性

  • 应用创建后，主域名将无法更改。
  • 主域名将自动作为类型为“PRIMARY”的域名添加到“排除域名”中。

每个旧版 Web Dev Key 仅可用于一个新的 Web 应用。

 

注意

有关网页归因设置的完整信息，请参阅此处。

 

Roku

应用名称：应用名称：从Roku Developer Dashboard/strong>复制Channel名称。

  • 示例：My Roku channel
  • 格式：
    • 最多可包含200个字符
    • 不支持XSS标签

Channel ID：由Roku为相关Channel指定的

  • 格式：
    • 0-9之间的数字
    • 最多可包含50个字符
  • 查询方式
    • 进入Roku Developer Dashboard，点击您要添加到Appsflyer的Channel名称。界面会打开该Channel的Roku Preview & Publish（预览与发布）页面。

    • 浏览器中该页面URL最后的数字即为

Amazon Vega OS

应用名称：您为相关应用设定的

应用ID：该应用的 ID。通过反向DNS表示法查找：<tld>.<公司名称>.<应用名称>
必须包含至少 2 个分段。每个片段必须以一个字母开头，后跟以下字符： A-Z a-z 0-9. -

示例：com.company.myapp


如需了解更多信息，请参阅 Amazon Vega OS 文档中的“id”字段。

Vizio SmartCast

应用名称：您为相关应用设定的

应用ID：Vizio认证的以 开头vz，后跟 2 至 20 个字符，来自：0-9.a-zA-Z - 。如果您需要确认该应用ID，请与您的Vizio客户经理沟通。 

Samsung Tizen

应用名称：您为相关应用设定的

应用ID：应用ID：即三星为相关应用指定的Bundle ID，以字母开头G，后跟8至15位数字。获取 App ID 的方法： 

  1. 登录三星电视卖家办公室。
    1. 请参阅此处“应用内广告”部分下的指南。
  2. 请输入您的开发者网址
  3. 您的 Bundle ID 已自动生成并显示。这可用于访问应用商店的网址。
  4. 请在广告标签或竞价请求中使用您的 Bundle ID 和 App Store 链接，以支持 App-ads.txt 验证。
  5. 如有任何问题，请在卖家办公室提交工单。
注意：要访问您专属的应用商店网页，请在 URL“https://www.samsung.com/us/appstore/app/”中添加您的 Bundle ID。 
例如，如果您的包 ID 是“G15147002586”，则该页面的 URL 将是“https://www.samsung.com/us/appstore/app/G15147002586/”。随后，开发者 URL、包 ID 和应用商店 ID 将显示在该页面的元数据中。

LG WebOS

应用名称：您为相关应用设定的

应用ID：该应用在LG WebOS中的应用ID

  • 格式：
    • 最多可包含50个字符，
    • 以A-Za-z._捆绑包形式呈现的角色。必须以字母开头。
  • 示例：com.my-company.app 

如果您需要确认该应用ID，请与您的LB WebOS客户经理沟通。  

PlayStation

应用名称：您为相关应用设定的

应用ID：应用ID：相关的PlayStation concept ID，这是PlayStation为游戏或其他内容概念指定的唯一标识符，由5-9位数字组成，您可以在对应的PlayStation商店链接中看到该ID：可在其应用商店URL的末端查看该ID。

playstation_app_id_url.png

Vidaa

应用名称：您为相关应用设定的

应用ID：该应用在Vidaa中的ID。最多可包含150个字符.

Steam

应用名称：您为相关应用设定的

应用ID：该应用在Steam中的ID，由5-8位数字组成，您可以在对应的Steam商店链接中看到该ID：

steam_store_app_url.png

Meta Quest（Oculus）

应用名称：您为相关应用设定的

应用ID： Meta Quest 应用的 ID，即从该应用下载的 Meta 应用商店 URL 末尾显示的 ID。由3-50个字符组成，有效字符包括、、A-Z、 

Nintendo Switch

应用名称：您为相关应用设定的

应用ID：Nintendo Switch 应用的 ID，即在下载该应用的商店 URL 末尾显示的 ID。由14位数字组成。

  • 示例：70010000012345

Xbox

应用名称：您为相关应用设定的

应用ID：Xbox 应用的 ID，即从该应用下载的 Xbox 商店网址末尾显示的 ID。仅包含12个字母和数字（A-Z a-z0-9）。 

请注意：应用ID区分大小写。

Epic Games

应用名称：您为相关应用设定的

应用ID：应用ID：该应用在Epic Games中的ID（即在可下载该应用的商店中所呈现的应用ID）由3-50个字符组成，有效字符包括、A-Z、a-z0-9._-、 

PC端原生应用（Native PC）

应用名称：您为相关应用设定的

应用ID：PC端原生应用ID。由3-50个字符组成，有效字符包括、A-Z、a-z0-9._-、 

输入其他信息（不适用于网页应用）：

选择货币

选择面板呈现该应用的数据时所使用的货币单位。AppsFlyer会按事件发生当下的汇率来换算该事件对应的收入和成本金额。如需进一步了解应用层级的货币设置及其影响，请参考此文档。

 重要提示！

请务必谨慎选择您的应用所使用的货币，因为AppsFlyer一旦记录到该应用的成本和收入信息后，您就无法再更改其货币设置。

选择时区

您在此处选择的时区需要与您在其他归因平台（如Meta ads或Google Ads）中设置的时区一致。这是为了最大限度地缩小AppsFlyer面板与这些平台之间的数据差异。

 注意

  • 时区设置完毕后即会保持锁定状态，无法更改，直到次日才会解除锁定。
  • 如需进一步了解应用层级的时区设置及其影响，请参考此文档。

定义应用受众

选择是或否，以说明您的应用是否面向儿童，或受众包含儿童（即同时面向成人和儿童）。
如果您选择是：

  1. 请参阅此说明，了解面向儿童的应用需要符合的合规标准。
  2. 勾选“已阅读”，确认您已阅读该说明，并且会按照其中的合规标准控制数据收集。

 注意

  • 应用添加完毕后的两周内，您会收到一条消息，让您确认您已针对面向儿童的应用实行了数据隐私控制。确认完毕后，您会收到一条确认信息。您可以从消息中心查看这条确认信息，也可以在审计日志中看到确认详情。
  • 请参见面向儿童的应用常见问题解答。

通过API批量管理您的应用

账号管理员可以使用专用API批量管理多个应用。该API支持AF面板提供的主要功能，包括添加和删除应用，以及更新应用配置。该API同时也融合了与面板相同的错误验证机制。

 注意

该API目前仅支持移动端应用的添加和配置更新，但支持所有平台中的应用删除

添加一个调试或测试应用

如果您的开发者创建了调试版、沙盒版或测试版应用，您必须将该应用添加到仪表盘中。一旦您的开发人员开始对应用进行测试，相关数据就会显示在应用的仪表盘中。

注意

对于尚未发布到 App Store 且尚未拥有有效 App Store ID 的 iOS 应用，您仍可通过使用一个临时 iOS App Store ID 来添加该应用，从而继续进行 SDK 测试。这使得无需在 App Store 上架应用即可进行 SDK 集成和测试。

有关如何创建调试应用并将其添加到仪表板的开发者指南，请参阅：

待批应用的添加方式

在应用调试阶段中将待批应用添加到您的账户有助于您测试AppsFlyer SDK对接。

即使您的应用在面板中显示为待批状态，也不会对数据收集和衡量任何影响。不管您的应用是待批还是已上架，只要有用户将其激活并与其互动，AppsFlyer面板就能照常记录其激活和应用内事件数据。

待批应用上架后，AppsFlyer会自动探测到该变化并更新其状态，所以您不必在应用上架后再次添加该应用。如需进一步了解待批应用即手动更新应用状态的可选操作，请参考此文档。

问题排查

本章节可为您解答一些常见问题：

“应用尚未添加”报错

如果出现这条报错消息，请联系您的CSM或发送邮件至hello@appsflyer.com。

“应用不在商店中”报错

请检查您使用的应用名称/ID以及复制的商店URL是否正确无误。

“无法访问应用商店”报错

添加非美国商店的安卓应用时可能会出现这条报错。请按以下方式解决该问题：

  1. 添加应用时将应用状态设置为待审核/未上架，详细步骤请见上文说明。
  2. 进入AppsFlyer的应用配置页面。
  3. 更正应用商店国家（假设您的应用在日本的应用商店上架，则将国家改为Japan）。

“出错了，请再试一次”

出现上述报错可能是因为您添加安卓应用时没有提供国家代码信息（对于不在美国Google Play商店上架的应用，必须添加该信息）。解决此问题的详细方法请见上文。

我的 iOS 应用已被从 App Store 下架。为什么我还能看到安装记录？

出现这种情况是因为，如果用户设备上之前已安装过该应用，他们可以通过操作系统重新安装该应用。即使该应用已不在 App Store 上架，用户仍可安装，且这些安装次数仍会计入 AppsFlyer 的统计数据中。

其他信息

产品系列

您可以向产品线中添加或移除应用。有关产品线及其所提供内容的更多信息，请参见此处。

Tags