AppsFlyer 集成指南:事件、成本与广告平台验证
AppsFlyer 集成需要分别验证三件事:应用是否记录了预定事件,各广告合作伙伴是否收到了允许共享的信号,以及是否导入了正确账户的成本。Meta、Google、Apple Ads 和 X 的要求各不相同。账户已连接,并不代表 ROAS 数据
AppsFlyer 中可能已经出现安装记录,但对应的购买事件仍未传到 Google Ads。Apple Ads 归因也可能正常运作,而广告成本尚未导入。如果此时就认定集成完成,后续决策可能建立在不完整的转化
本指南面向共同配置集成的开发人员与获客负责人,依据 2026 年 10 月 9 日核查的官方文档编写,并提供可在自家应用中执行的
先定义事件,再连接广告平台
为每个事件记录用户行为、触发条件、参数、负责人和接收方。区分试用开始、首次付费购买和续费。在把收入归到广告活动之前,先明确取消、退款以及服务器与客户端重复通知的
使用适合应用框架的 SDK 集成指南,核对应用 ID、SDK 启动和用户同意流程。AppsFlyer 通过 af_revenue 计入收入,仅发送一个自定义的 price 参数并不够。购买验证流程可能自动发送购买事件;如果再手动发送同一事件,就可能
假设进行一笔 9.99 美元的测试购买,应记录事件时间、币种和交易参考号。沿着应用、AppsFlyer、各已配置接收方逐一追踪。确认收入只计入一次,试用没有被当成实际付款。按照 AppsFlyer 的说明注册测试设备,让重复安装测试得到
按各平台的要求建立连接
当前入口是 Collaborate > Partner Integrations 下的 Marketplace 标签页。选择合作伙伴并启用集成。已有连接显示在单独的活跃集成标签页中。为应用 ID、账户范围、事件映射和归因窗口保留带日期
Meta Ads:核对应用 ID、事件映射和数据权限
填写匹配的 Facebook App ID,将 AppsFlyer 事件映射到预定的 Meta 事件。根据用户同意方案,确认哪些用户的事件及参数值可以共享。具体设置以 Meta 集成说明
Android 应用还需核对 Meta install referrer 的要求,包括受支持的 SDK 和解密密钥。启用这一选项并不意味着所有历史归因记录都将
AppsFlyer 当前的 Meta 指南也介绍了 Advanced Mobile Measurement(AMM)。接受条款会影响之后完成归因的用户在设备层面的数据访问。此前受限的转化不会被追溯补齐,这些用户后续的应用内事件也可能保留原有限制。原始数据字段缺失时,应先排查这种情况,再判断是否为 SDK
Google Ads:分别检查关联 ID 与转化导入
在 Google Ads 中创建第三方应用分析关联,提供商选择 AppsFlyer。确认应用及操作系统正确,再将关联 ID 填入 AppsFlyer 的 Google Ads 集成。Android 和 iOS 需要各自
接着检查 Google Ads 中的转化操作。导入 first_open、再互动所需的 session_start,以及需要使用的已映射应用内事件。事件必须先发生,才会出现在可导入列表中。AppsFlyer 表示可能有最长六小时的延迟。请遵循 Google Ads 集成指南,包括各平台的
2026 年 9 月版指南还列出了 iOS 设备端计量所需的额外 SDK 和 Google 计量要求。核查应用支持的实现方式,包括 Firebase 或独立方案。仅填写关联 ID 并不会自动启用这些能力。成本报告需要单独连接,并核对授权的 Google Ads
Apple Ads:把归因与成本报告分开配置
Apple Ads 归因使用 SDK 获取的 AdServices 令牌,并与 Apple 的归因服务交换信息。报告 API 则提供广告活动元数据和成本。在 AppsFlyer 中使用成本数据需要 ROI360 权限。归因正常并不能证明这一权限也已具备。报告连接应授权所有需要的广告活动组。具体参见 Apple Ads 配置指南。
标准 Apple Ads 集成没有面向合作伙伴的事件回传设置,因此不能照搬 Meta 的事件接收检查来验收。营销合作伙伴的集成属于另一
还要留意一项有明确生效日期的报告变更。AppsFlyer 说明,自 2026 年 9 月 1 日起,Apple Ads 在所有归因声明中提供广告互动时间戳,从而更一致地应用已配置的回溯窗口和末次接触规则。变更公告还指出,按年龄或性别定向的广告组会返回 false 归因响应。调查 9 月 1 日前后的数据变化时,应核对适用范围。报告规则变化本身不能证明实际获客表现发生
X Ads:核对账户授权和迁移范围
按照 X Ads 集成指南,接受 Mobile App Conversion Tracking 条款、授权 AppsFlyer、选择目标账户,并保存已启用的集成。X 要求账户具备付款方式。设置约定的点击和浏览归因窗口,检查事件共享选项。成本报告需要单独连接及 ROI360
迁移时需要注意,X 同一时间只支持一个 MMP 连接。依据同时使用多个 MMP 的限制制定切换计划。运行两个 SDK 不会自动产生两套完整且可比
用各环节的证据完成验收
将测试的应用构建版本、设备、同意状态、时间和预期事件记录在一起。各项检查回答的是
| 连接 | 应检查的证据 | 能确认什么 |
|---|---|---|
| 应用到 AppsFlyer | 安装和事件记录、币种、收入 | 已实现的应用行为正在被计量 |
| Meta | 事件映射以及接收方收到的允许共享事件 | 获准共享的信号到达了设定目标 |
| 关联范围、已导入操作及报告状态 | Google Ads 可以使用预定转化 | |
| Apple Ads | 归因响应及单独核查的报告账户范围 | 归因与成本、元数据访问分别正常 |
| X | 所选账户、合作伙伴事件设置及成本导入状态 | 所需的账户与报告连接已经启用 |
SDK 测试通过并不能证明广告活动带来了增量效果。成本导入缺失也不应靠修改事件映射来诊断。定位失败的环节,修复后重新测试
在计量边界内解读报告
核对报告时,记录日期范围、时区、点击与浏览窗口,以及按安装日还是事件发生日汇总。Apple Ads 的下载数可能不同于 AppsFlyer 的首次打开数。各广告网络声明的转化,也可能与 AppsFlyer 跨网络的归因
使用 SKAdNetwork 时,记录转化值映射及负责更新它的 SDK。SKAN 指南说明了延迟到达的汇总回传,以及隐私机制对明细的限制。没有转化值不一定意味着漏记了购买。针对实际 iOS 配置核查当前 SDK、广告网络和框架支持情况。笼统的 AdAttributionKit 兼容声明不能代替
报告延迟和用户群组成熟度需要分开看。昨天安装用户的报告即使已经完整,也不可能包含他们下个月的续费。比较相同观察时长的群组,并将已观察收入与用户生命周期价值预测
把套餐与必要功能一起纳入预算
2026 年 10 月 9 日核查的价格页面显示,Zero 负责自有媒体计量。首年 12,000 次免费转化属于 Growth 的新用户额度。之后 Growth 公布的价格为每次可计费转化 0.07 美元,包括适用的安装、再互动和再归因。自然安装和自然行为不计费。Enterprise
确认拟购买的套餐是否包含 ROI360、Protect360、原始数据导出和 API 访问。试用期能用的功能,不代表正式套餐一定包含。将可计费转化量与必要的附加功能
如果仍在选型,可以参考我们的 Adjust 与 AppsFlyer 对比和 Adjust 配置指南。如果计量正常但增长仍然乏力,免费的 90 秒增长诊断可帮助评估漏斗的四个阶段。需要追查具体数据缺口时,我们的付费广告与移动数据和归因服务提供实施和