2025 年 6 月 17 日,Meta 重新启用了高级移动测量 (AMM) 报告,使其与应用广告生态系统保持一致。
借助 AMM,广告主可以访问 iOS 和 Android 设备的行级 Meta 归因数据(包括来自 MMP 自归因集成的数据),从而消除了以往仅能获取通过 Meta Referrer 归因的 Android 安装数据的限制。
正在从其他 MMP 迁移?请参阅在不影响优化的情况下将 Meta 广告系列迁移到 Singular,了解如何在切换期间保持 Meta 广告系列的效果。
集成摘要
作为 Meta 移动测量合作伙伴,Singular 允许应用发布商跟踪来自 Facebook 和 Instagram 的广告下载推荐。下载经 Singular 验证后,您还可以跟踪这些用户随后在您的移动应用中的互动情况。
Singular 通过多种方式报告来自 Meta 的归因数据:
- Meta 的自归因 API:Singular 将用户级应用活动报告给 Meta 专为 MMP 提供的 API,由 Meta 进行自归因,并可在 Singular 中归因。通过该 API 进行的归因受Meta 针对广告主的数据限制约束。
- Meta 的 "Meta Referrer"(仅限 Android):请参阅"Meta Referrer"
- Meta 的 "Aggregated Event Measurement"(仅限 iOS):请参阅"Aggregated Event Measurement"
- Meta 的 SKAdNetwork 报告(仅限 iOS):请参阅"Meta SKAdNetwork 集成指南"
(请参阅合作伙伴集成术语表)
| 合作伙伴 | Facebook (Meta) |
| 合作伙伴类型 | 自归因广告网络 |
| 创意 | 支持 |
| 发布商 | 支持 |
| 浏览归因 |
支持 通过 Android Meta Referrer 提供用户级报告,适用于 Advantage+ 应用广告系列,以及采用以下定位方式的手动应用推广广告系列:广泛定位 |
| 深度链接 | Singular 与 Meta 的集成不使用 Singular 跟踪链接(包括 Singular 深度链接)。请参阅Meta 关于设置 Meta 深度链接的文档。 |
| 再互动 |
支持 仅适用于 iOS Aggregated Event Measurement (AEM) 的用户级数据 |
| 点击标签 | 否(自归因) |
| 接收所有安装 | 必需(自归因) iOS AEM 必需 |
| 接收所有事件 | 推荐(自归因) iOS AEM 必需 |
设置说明
必须配置 Facebook (Meta) Ads 归因集成,才能使用 Meta 的所有测量方法。
前提条件
- 确保您的应用已通过 SDK 或 S2S 集成与 Singular 集成(请参阅Singular SDK/S2S 入门)
- 仅适用于 iOS 应用:必须实现深度链接支持,才能为 Meta 应用互动广告系列支持 Aggregated Event Measurement (AEM) 测量。请参阅AEM 要求
| 1 |
设置 Facebook (Meta) Ads在 Meta 上注册应用:要投放 Meta 移动应用广告,必须在 Meta 上注册应用。请访问 Meta App Dashboard 设置您的应用。 |
| 2 |
在 Singular 中将 Facebook (Meta) 配置为合作伙伴
|
| 3 |
指定归因设置
|
| 4 |
向 Meta 发送事件回传Singular 支持按照 Meta 的所有要求向 Meta 发送事件通知。
|
| 5 |
在 Singular 中跟踪 Facebook (Meta) 安装完成上述步骤后,您即可在 Singular 报告中查看 Meta 移动应用广告系列的结果。
每个归因于 Meta 移动应用安装广告的安装,都会根据在 Meta 中创建的广告系列名称、广告组和广告组名称进行报告。 |
数据映射
Meta 广告系列值按如下方式映射到 Singular 报告维度:
| Singular 值 | Meta 值 | 示例 |
|---|---|---|
| Tracker Campaign Name | Campaign Name | "MyCampaign" |
| Tracker Campaign ID | Campaign ID | 12345678 |
| Tracker AdGroup Name | AdSet Name | "MyAdGroup" |
| Tracker AdGroup ID | AdSet ID | 98123747 |
| Tracker Creative ID | Ad ID | 123192873 |
| Tracker Publisher Site Name | Publisher Platform | "Instagram" "Facebook" "Audience Network" "WhatsApp" "Threads" |
运行 Meta 报告时,Singular 还会将 SDK 数据与 Meta Ads API 提供的营销数据进行匹配,包括:
- 按广告系列划分的支出
- 按创意划分的支出,包括图片或视频
- 账户 ID
常见问题
作为 Meta 移动测量合作伙伴,Singular 允许应用发布商跟踪来自 Facebook 和 Instagram 的广告下载推荐。下载经 Singular 验证后,您还可以跟踪这些用户随后在您的移动应用中的互动情况。
Singular 通过两种方式从 Meta 获取归因数据:
- Meta 的自归因 API:由于 Meta 的数据共享限制,从该 API 收到的安装数据仅可在 Singular 汇总报告中使用(不可在用户级数据日志中使用)。
- Meta 的 Meta Install Referrer 解决方案:这种仅适用于 Android 的测量机制支持在广告 ID 不可用的情况下进行归因。请参阅Meta Referrer 常见问题。
自 2025 年 6 月 18 日起推出的 Meta 高级移动测量报告,使广告主能够访问 iOS 和 Android 设备的用户级归因数据(包括来自 MMP 自归因集成的数据),从而消除了以往仅能获取通过 Meta Referrer 归因的 Android 安装数据的限制。
要访问用户级报告,必须为相关 App ID 接受 AMM 条款。请按照以下指导在报告中启用 Meta:
- 访问 Meta 的高级移动测量条款。
- 选择相关 App ID。
- 接受条款。
- 必须由您的 Meta 开发者应用的管理员接受 Meta 的高级移动测量条款。
- 用户级数据仅适用于 AMM 接受日期之后新归因的用户。
- 用户级数据不向非广告主平台提供,例如 Singular 与第三方分析合作伙伴的回传集成。
Singular 采用 Meta 要求的所有必要安全措施,以确保 Singular 与 Meta 之间的通信安全。我们还遵守 Meta 规定的所有隐私政策,以保护您的数据。
如果您已按照设置步骤完成测试,但仍然看不到 Meta 归因的安装,请联系 Singular 支持团队获取更多帮助。请在首封邮件中提供您的账户名称、相关应用以及 Facebook App ID,以便快速解决问题。
作为 iOS 14 相关更新的一部分,Meta 发布了与 MMP 配合使用 Advertiser Tracking Enabled 标志的新指南,包括他们如何使用 ATE 标志。您与 Singular 的集成会自动实现此标志,并为通过 iOS App Tracking Transparency 选择允许跟踪的用户设置该标志。您无需在 Singular SDK 实现中执行任何额外操作。
互动观看是指用户观看视频广告的时长超过 5 秒;如果视频时长不足 5 秒,则指观看了视频时长的 97%。
在汇总报告中,互动观看转化报告在 "conversion type" = "click-through" 下。
如果您已实现Singular 广告收入归因,则可以通过 Meta 的 AdImpression 事件向 Meta 报告广告收入数据。只要广告收入数据符合 Meta 的资格要求,报告给 Meta 的广告收入即可用于优化。
注:Meta 可能会在其报告中对广告收入值进行四舍五入,因此 Meta 报告中显示的金额可能与用于优化的值不完全一致。
- 集成Singular 广告收入归因
-
通过 Facebook 合作伙伴配置向 Meta 传递广告收入数据。选择"__ADMON_USER_LEVEL_REVENUE__" SDK 事件,将其映射到"AdImpression",并勾选"Include Revenue Value"。
- 查看Meta 关于最大化转化价值的资格要求
如果 Meta 返回此错误,表示该事件应为收入类型事件。要解决此问题,请确保在使用 Singular SDK 从应用发送该事件时包含所需的货币和价值参数。此外,请在 Partner Configuration 设置中为该事件启用 "Include Revenue Value"。
不会。对事件映射的任何更改仅从配置之时起生效,历史数据不会被追溯更改。
请确保 Meta 上的所有权限均已设置为允许您为该广告主投放广告系列。请在 Meta 广告系列名称中包含您的公司名称,以便我们将您的广告系列与其他代理商的广告系列或广告主自有的广告系列区分开来。
(iOS) Aggregated Event Measurement 常见问题
自 10 月 9 日起,只要您的应用在 Meta Events Manager 中符合 AEM 条件,Advanced AEM 将适用于所有现有和新建的 Facebook 配置,并默认启用。
启用 Meta Advanced AEM 报告(即跟踪器安装):
- (Singular)确保已为您的 iOS 应用配置 Facebook 合作伙伴配置,并已勾选"Include Advanced AEM Attributions"选项。Meta 中的默认 Singular 合作伙伴配置会发送未授予 iOS App Tracking Transparency (ATT) 权限的用户的应用事件,在这种情况下,Meta 会将这些事件的处理限制为 AEM。
-
(Meta)在 Meta Events Manager 中确认您的应用符合 Aggregated Event Measurement 的条件。如果您的应用符合 AEM 条件,Advanced AEM 数据将通过您的 Singular 集成提供。
注:在配置 Meta 应用推广广告系列时,Advanced AEM 的 Singular 报告并不要求将"Aggregated Events Measurement"选项选为"Attribution"
为"App Promotion"广告系列启用 Meta AEM 报告(即广告网络安装):
-
(Singular)一个已启用的 Singular iOS Facebook 合作伙伴配置
- 向 Meta 报告应用内事件回传是可选的,但建议启用,以支持 VO 和 AEO 优化。请注意,AEM 要求向 Meta 同时报告 ATT 选择加入和选择退出的数据,这是 Facebook 合作伙伴配置的默认行为。
- (Singular) 已配置的 Singular Facebook 数据连接器
- (Meta)确保将"MMP"选为"Preferred Connection Method"(在 Meta Events Manager 中设置)。
-
(Meta)创建 Meta 应用推广广告系列时:
- 在"Campaign"配置中,启用"iOS 14+ campaign"选项
- 在"Ad Set"配置中,选择 AEM 选项作为归因方法:
- 在"Campaign"配置中,启用"iOS 14+ campaign"选项
为"App Engagement"广告系列启用 Meta AEM(即再互动):
-
- (Singular)一个 iOS 应用,且支持深度链接
-
(Singular)一个已集成 Singular 并支持深度链接的应用
- Singular SDK 集成,或
- iOS SDK 12.0.3+,或
- iOS SDK 11.0.7+,并已实现 supportedDomains(用于 App AEM 广告系列中使用的所有通用链接)
- Singular 服务器到服务器 (S2S) 集成
- 深度链接支持 已实现,并在所有报告的会话中传递 openuri=
- Singular SDK 集成,或
- (Singular) 一个已启用再互动的 Singular iOS Facebook 合作伙伴配置
- (Meta)确保在 Meta Events Manager 中将"MMP"选为"Preferred Connection Method"。
Singular 支持报告由 App AEM 广告系列带来的安装和再互动(来自深度链接)。
- AEM 安装仅以汇总形式报告为"Network Installs",数据来自Facebook Data Connector 集成
- Advanced AEM 点击和浏览安装在 Singular 的汇总"Tracker Installs"中报告。Advanced AEM 的用户级归因可通过AMM 报告获取。
- AEM 再互动来自应用互动广告系列带来的深度链接,同时以用户级和汇总形式报告。支持的广告系列粒度包括:
- Campaign ID
- Sub Campaign ID
- Creative ID
为避免在 Meta 中出现用于 AEM 的重复应用事件,建议仅由 Singular SDK 实现这些事件,并通过 MMP 集成将其传递给 Meta。有关详细信息,请参阅我们的Meta 与 Singular SDK 互操作性指南。
确保在 Meta Events Manager 中将"MMP"选为"Preferred Connection Method"。
(Android) Meta Referrer 常见问题
自 2025 年 6 月 18 日起,访问 Meta 归因的行级归因数据不再需要"Meta Referrer"。所有 Meta 用户级归因数据均可通过 Meta 高级移动测量 (AMM) 报告访问。
自 2025 年 6 月 18 日起,访问 Meta 归因的行级归因数据不再需要"Meta Referrer"。所有 Meta 用户级归因数据均可通过 Meta 高级移动测量 (AMM) 报告访问。
"Meta Referrer"是 Meta 推出的 Android 专用测量解决方案,使广告主能够针对以应用安装为目标、在 Facebook、Instagram 和 Audience Network 上投放的广告系列,获取 Android 应用安装的细粒度用户级归因数据(请参阅Meta 的数据政策)。它由用于应用安装测量的"Google Play Install Referrer"和"Meta Install Referrer"两项技术组成。
| Google Play Install Referrer | Meta Install Referrer |
| (自 2021 年 10 月起可用) 使用"Google Play Install Referrer"对通过 Google Play 商店进行的 Meta 应用安装广告系列的 Android 点击安装进行归因。 |
(自 2023 年 11 月起可用)
"非同一会话"是指用户点击广告并被重定向到应用商店,但没有立即点击"Download/Install"。用户稍后返回应用商店页面才点击"Download/Install"。 |
自 2023 年 11 月起,Singular 与 Meta 的集成同时支持"Google Install Referrer"和"Meta Install Referrer",Singular 将其统称为"Meta Referrer"测量。
自 2025 年 6 月 18 日起,Meta 的 AMM 改变了 Singular 在自归因数据与"Meta Referrer"数据之间进行安装归因的方式和时机。
| 如果已接受 AMM | 如果未接受 AMM |
|
AMM 允许共享 Meta 自归因的用户级数据。因此,Meta 自归因 API 的归因优先级高于 Meta Referrer 归因,具体如下。 Meta Referrer 用于 Meta 自归因 API 无法归因的情况,例如没有广告 ID 的 Android 用户。 |
Singular 优先使用 Meta Referrer 数据来测量归因,以优先确保广告主能够获取用户级数据。对于给定的 Android 应用安装,Singular 将按以下顺序优先采用归因方法:
如果没有任何 Meta Referrer 数据,或者按照最后接触方法 Meta Referrer 数据输给了 Meta 自归因转化,Singular 将使用自归因声明。这样既能最大限度地获取用户级归因数据,又能确保对 Meta 广告系列进行准确的汇总测量。 |
通过 Meta Install Referrer 或 Google Install Referrer 进行的归因在用户级报告中以来源"Facebook"提供,并可分别通过归因方法("Method")"meta_referral_id" 和 "referral_id" 加以区分。
Singular 的"Meta Referrer"测量包括 Meta 在通过 Facebook、Instagram 或 Audience Network 投放 Android 应用安装广告时使用的两种安装推荐技术。
| Google Play Install Referrer | Meta Install Referrer |
|
当用户在 Meta 的应用(如 Facebook 或 Instagram)或 Audience Network 上点击广告主的应用安装广告时,Meta 会加密并记录相关的广告系列元数据(Meta referrer),并将其附加到 Play Store URL 中的 referrer 参数。Play Store URL 会将用户重定向到 Play Store 的应用产品页面,商店会保存附加的 Meta referrer。 安装完成且用户首次打开应用后,Singular 的 SDK 会从 Play Install Referrer API 读取 Google Play install referrer,以从 Google Play install referrer 数据中获取 Meta referrer。随后,Singular 的服务器会对 Meta referrer 进行解密,以进行安装归因。 |
当用户在 Meta 的应用(如 Facebook 或 Instagram)或 Audience Network 上查看或点击广告主的应用安装广告时,Facebook 应用会加密相关的广告系列元数据(Meta referrer),并将其记录在设备上 Facebook 应用的本地存储层中。 安装完成且用户首次打开应用后,Singular 的 SDK 会从设备本地存储层获取的 Meta install referrer 数据中读取 Meta referrer。随后,Singular 的服务器会对 Meta referrer 进行解密,以进行安装归因。 |
这两种技术会同时使用,并与 Singular 和 Meta 的自归因集成配合,最终得出单一的归因决策。请参阅"Singular 如何在自归因数据与"Meta Referrer"数据之间进行安装归因?"
Meta Referrer 同时使用"Google Play Install Referrer"和"Meta Install Referrer"进行测量。建议同时实现这两种方法,以便在其中一种不可用时最大限度地提高数据可用性。
Singular SDK 和 S2S 集成要求
| Google Play Install Referrer | Meta Install Referrer | |
| Singular SDK |
|
|
| Singular S2S API |
|
|
合作伙伴配置要求
- 配置 Facebook 合作伙伴配置,并提供 Meta "Install Referrer Decryption Key",具体请参阅步骤 2.4。
Meta 提供的这两种测量方法之间出现差异的一些可能原因如下:
- Meta Referrer 支持 Android 12+ 上限制广告跟踪的用户,这些设备上 Google 广告 ID 不可用。Meta 自归因仅在 Google 广告 ID 可用时才可用。
- Meta Referrer 仅支持应用安装。
- Meta Referrer 仅适用于在该设备上发生的点击和浏览。Meta 自归因支持对使用多台设备的 Meta 用户进行跨设备归因声明。
- Meta Referrer 不支持重定向到落地页的广告系列
- Meta Referrer 支持浏览归因,但仅适用于采用广泛定位的广告系列或 Advantage+ 应用广告系列
- 如果仅使用 Google Install Referrer,而未启用 Meta Install Referrer:
- Google Install Referrer 仅测量应用安装,且仅针对引导至 Play Store 的广告系列。如果用户与相关广告的互动并未直接引导至 Play Store,则 Google Install Referrer 不支持。
- Google Install Referrer 仅支持点击归因,而 Meta 自归因同时支持点击归因和浏览归因
- Google Install Referrer 使用的是紧接在应用下载之前的 referrer 值。在下载之后、首次打开应用之前重复点击同一广告,不会更新 referrer 值。Meta 的自归因逻辑则可能返回下载之后、首次打开应用之前更近的接触点
- Google Install Referrer 仅支持 Google Play 商店,不支持第三方应用商店。
要通过 Meta Referrer 接收浏览安装数据,必须使用广泛定位。支持的广告系列配置如下:
- 年龄:应用默认设置 "18-65+"
- 性别:应用默认设置 "All genders"。
- 地区:将区域、国家组(如亚洲)或特定国家/地区设置为投放地区。
-
详细定位:如果应用了人口统计、兴趣或行为等详细定位,则必须选择启用Advantage 详细定位。
-
自定义受众:如果应用了自定义受众,则必须选择启用Advantage 自定义受众。
Meta Referrer 归因仅适用于 Android 设备。
要找到您的解密密钥,请按照以下步骤操作:
- 在 Meta Developers Portal 中,前往 My Apps 并选择相关应用。
- 前往 Basic 设置,向下滚动到 Android 应用商店部分。
- 在 Package Names 下,找到标记为 Install Referrer Decryption Key 的密钥。
合作伙伴数据政策
作为已集成 Meta 自归因 API 的 Meta 移动测量合作伙伴,Singular 遵守以下数据处理要求。
数据保留
Meta 用户级数据会在原始归因 13 个月后删除。13 个月后,归因于 Meta 的用户将被视为/标记为"自然量",并在 Singular 的汇总报告和用户级报告中如此体现。
数据访问
用户级归因数据可通过 Meta 高级移动测量 (AMM) 计划获取。要访问用户级报告,必须为相关 App ID 接受 AMM 条款。请按照以下指导在报告中启用 Meta:
- 访问 Meta 的高级移动测量条款。
- 选择相关 App ID。
- 接受条款。
- 必须由您的 Meta 开发者应用的管理员接受 Meta 的高级移动测量条款。
- 用户级数据仅适用于 AMM 接受日期之后新归因的用户。
- 用户级数据不向非广告主平台提供,例如 Singular 与第三方分析合作伙伴的回传集成。
如果未接受 AMM 协议,所有通常用于标识 Facebook 归因的字段都会被标记为"未归因"。无需 AMM 协议即可获取用户级数据的例外情况:
-
- 通过以下方式得出的 Android 安装归因:Meta Referrer
- 来自 AEM 应用互动 广告系列的 iOS 再互动归因
Limited Data Use
Meta 允许广告主在最终用户选择限制或允许对其数据进行处理时,使用"limited data use" (LDU) 标志通知 Meta。此功能适用于美国以下各州的用户:
- 加利福尼亚州(自 2020 年 7 月起)
- 科罗拉多州(自 2023 年 6 月起)
- 康涅狄格州(自 2023 年 6 月起)
在与 Meta 等符合隐私要求的合作伙伴集成时,Singular 会使用传递给 Singular SDK 和 S2S 的 limitDataSharing 值。当 Singular.limitDataSharing(true) 时,如果该用户是加利福尼亚州、科罗拉多州或康涅狄格州居民,Meta 将在 Meta 定向中对该用户应用"limit data use"。如果未明确提供 limitDataSharing 值,Singular 默认会通知 Meta 对加利福尼亚州、科罗拉多州和康涅狄格州居民应用"limit data use"。
有关实现详情和示例,请参阅我们的 iOS SDK、Android SDK 和 S2S API 指南。有关"LDU"功能的更多信息,请参阅Meta 的开发者文档。
Advantage+ Catalog Ads
借助 Singular 的集成,您可以在现有事件上转发 Meta 的 Advantage+ Catalog Ads 所需的参数。Meta 自己的指南规定了三个必需事件:
| 事件 | 属性 |
|---|---|
| ViewContent |
必需: content_id、content_type。可选:value、currency。 |
| AddToCart |
必需: content_id、content_type。可选:value、currency。 |
| Purchase |
必需: content_id、content_type、value、currency。对于包含多个商品的订单,请发送 contents,而不是单个 content_id。它是一个 JSON 数组,每个商品对应一个对象,每个对象都包含各自的 id 和 quantity。 |
Singular 如何映射这些参数
在发送给 Meta 的回传中,Singular 会将这些参数转换为 Meta 自己的字段名称:content_id 映射为 fb_content_id,content_type 映射为 fb_content_type,value 映射为 _valueToSum,currency 映射为 fb_currency,contents 映射为 fb_content。
Singular 需要为您的账户配置自定义回传。请联系您的 CS 联系人或 Singular 支持团队,并提供您的应用正在发送的事件和参数名称,以便映射您的回传。请参阅 Advantage+ Catalog Ads for Mobile Apps,了解 Meta 自己的参数参考和确切的 JSON 结构。有关设置的更多详细信息,请参阅动态广告和目录广告的应用事件。