集成摘要
作为 Meta 移动测量合作伙伴,Singular 允许应用程序发布商跟踪来自Facebook和Instagram 的广告下载推荐。一旦下载被 Singular 验证,您还可以跟踪这些用户在您的移动应用程序中的后续用户参与情况。
Singular 通过多种方式报告来自 Meta 的归因数据:
- Meta的自归因API:Singular会将用户级应用活动报告给MMP专用的Meta API,由Meta进行自归因,并在Singular中进行归因。通过该 API 进行的归因受Meta 针对广告商的数据限制。
- Meta 的 "Meta Referrer"(仅限安卓):请参见"Meta Referrer
- Meta 的 "聚合事件测量(Aggregated Event Measurement)"(仅限 iOS):请参见"聚合事件测量
- Meta 的 "SKAdNetwork 报告"(仅限 iOS): 请参阅 "Meta SKAdNetwork 报告": 请参阅"Meta SKAdNetwork 集成指南"。
(参见合作伙伴集成术语表)
合作伙伴 | Facebook (Meta) |
合作伙伴类型 |
自归因广告网络 |
创意 | 支持 |
出版商 | 支持 |
浏览 |
支持 通过 Android Meta Referrer 提供用户层级报告,适用于具有广泛目标定位功能的 Advantage+ 应用程序推广活动和手动应用程序推广活动 |
深度链接 | Singular与Meta的集成不使用Singular跟踪链接(包括Singular深度链接)。请参阅Meta 文档,了解如何设置 Meta 深度链接。 |
再营销 |
支持 |
点击标签 | 否(自归因) |
接收所有安装 |
推荐(自归因) |
接收所有事件 |
推荐(自归因) |
设置说明
需要配置 Facebook (Meta) Ads 归因集成,以便利用 Meta 的所有测量方法。
前提条件
- 确保您的应用程序已通过 SDK 或 S2S 集成与 Singular 集成(请参阅Singular SDK/S2S 入门)。
- 仅适用于 iOS 应用程序:必须实施深度链接支持,以支持 Meta 应用程序参与活动的聚合事件测量 (AEM) 测量。 请参阅AEM 要求
1 |
设置 Facebook (Meta) 广告在 Meta 上注册应用程序:要运行 Meta 移动应用程序广告,应用程序必须在 Meta 上注册。访问 "Meta 应用程序控制面板 "设置应用程序。 |
2 |
将 Facebook (Meta) 配置为 Singular 的合作伙伴
|
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 |
运行 Meta 报告时,Singular 还会将 SDK 数据与 Meta Ads API 提供的营销数据进行匹配,包括
- 营销活动支出
- 创意支出,包括图片或视频
- 账户 ID
常见问题
作为Meta移动测量合作伙伴,Singular 允许应用程序发布商跟踪来自 Facebook 和 Instagram 的广告下载推荐。一旦下载被 Singular 验证,您还可以跟踪这些用户在您的移动应用程序中的后续参与情况。
Singular 通过两种方式从 Meta 获得归因数据:
- Meta 的自归因 API:由于 Meta 的数据共享限制,从该 API 获取的安装数据只能在 Singular 的汇总报告中使用(不能在用户级数据日志中使用)。
- Meta 的 Meta Install Referrer 解决方案:这一新的安卓应用程序安装测量解决方案可在 Singular 的汇总报告和用户级数据日志中显示数据。请参见 Meta Referrer FAQ。
Singular 使用 Meta 要求的所有必要安全措施,以确保 Singular 和 Meta 之间的通信安全。我们也遵守 Meta 规定的所有隐私政策来保护您的数据。
如果您已经按照设置步骤进行了测试,但仍未看到 Meta 归因安装,请联系 Singular 的支持团队寻求更多帮助。请在第一封邮件中提供您的账户名、对应的应用程序和 Facebook 应用程序 ID,以确保快速解决问题。
作为 iOS 14 相关更新的一部分, Meta 宣布了与MMP一起使用启用广告商跟踪标志的新指南,包括如何使用 ATE 标志。您与 Singular 的集成会自动执行该标志,并为通过 iOS应用程序跟踪透明度选择跟踪的用户设置该标志。在您的 Singular SDK 实施中不需要额外的操作。
如果您已实施Singular 广告收入归因,则可通过 Meta 的 AdImpression 事件向 Meta 报告广告收入数据。如果广告收入数据符合 Meta 的资格要求,向 Meta 报告的广告收入可用于优化。
- 整合Singular 广告收入归因
- 通过 Facebook 合作伙伴配置向 Meta传递广告收入数据。选择"__ADMON_USER_LEVEL_REVENUE__"SDK 事件并将其映射到 "AdImpression",选中 "Include Revenue Value"(包含收入值)。
- 查看Meta 的资格要求,以最大限度地提高转换值
如果从 Meta 中遇到此错误,则表明该事件预计为收入类型事件。要解决这个问题,请确保在使用 Singular SDK 从应用程序发送事件时,包含所需的货币和价值参数。此外,在合作伙伴配置设置中,确保为该事件启用 "包含收入值(Include Revenue Value)"。
不会,对事件映射的任何更改只会从配置生效起开始应用。历史数据不会被追溯更改。
请确保 Meta 上的所有权限都设置为允许您为广告客户开展营销活动。请在 Meta 广告系列名称中包含您的公司名称,以便我们将您的广告系列与其他存在的代理广告系列或内部广告客户广告系列区分开来。
(iOS)聚合事件测量 AEM 常见问题
App AEM 是一种解决方案,可帮助广告商接触到更多人并衡量其平台上的广告效果。
App AEM 利用 Singular 通过 MMP 集成向 Meta 发送的转换数据。这包括与未提供 iOS 应用程序跟踪透明度 (ATT) 许可的用户相关的事件,在这种情况下,Meta 将把这些事件的处理限制为仅用于聚合事件测量 (AEM)。应用程序 AEM 支持 iOS 14 及以上版本的应用程序推广(安装)和应用程序参与(重新参与)活动。
自 2024 年 10 月 9 日起,Meta 和 Singular 将额外支持名为 "高级 AEM "的 AEM 增强功能。 高级 AEM 可在 Singular 跟踪器数据中报告符合 AEM 条件的应用程序的 AEM 归因,从而进一步改进了安装 AEM 的测量方法。查看AEM 归因和报告
有关应用程序 AEM 的更多信息,请参阅 Meta帮助中心的文章。
从 10 月 9 日起,只要您的应用程序在Meta Events Manager 中符合 AEM 条件,高级 AEM 将适用于所有现有和新的 Facebook 配置,并默认启用。
要启用 Meta 高级 AEM 报告(即跟踪器安装 tracker installs)
- (Singular)确保为您的 iOS 应用程序配置了 Facebook 合作伙伴配置,并选中了 "包含高级 AEM 归因 "选项。Meta 中默认的 Singular 合作伙伴配置会为未提供 iOS 应用程序跟踪透明度 (ATT) 权限的用户发送应用程序事件,在这种情况下,Meta 会将这些事件的处理限制在 AEM 中。
-
(Meta)在Meta 事件管理器中验证您的应用程序是否符合 "聚合事件测量AEM"的条件。 如果您的应用程序符合 AEM 条件,高级 AEM 数据将通过您的 Singular 集成提供。
注意:在配置 Meta 应用程序推广活动时,高级 AEM 的 Singular 报告不需要将 "聚合事件测量AEM"选项选为 "归因Attribution"。
启用 Meta AEM 报告 "应用程序推广 "活动(即渠道安装 network installs):
- (一个活跃的 Singular iOS Facebook 合作伙伴配置
- 向 Meta 报告应用程序内事件回传是可选的,但建议启用 VO 和 AEO 优化。请注意,AEM 要求向 Meta 报告 ATT opt-in 和 opt-out 数据,这是 Facebook 合作伙伴配置的默认行为。
- (Singular) 已配置 Singular Facebook 数据连接器
- (Meta)确保在Meta Events Manager 中将 "MMP "选为"首选连接方法"。
-
(Meta)创建 Meta 应用推广活动时:
- 在 "活动 "配置中,启用 "iOS 14+ 活动 "选项
- 在 "广告组 "配置中,选择 AEM 选项作为归因方法:
- 在 "活动 "配置中,启用 "iOS 14+ 活动 "选项
为 "应用程序参与"营销活动启用 Meta AEM(即跟踪器再参与 tracker re-engagements):
-
- (Singular)支持深度链接的 iOS 应用程序
-
(Singular)支持深度链接的 Singular 集成应用程序
- Singular SDK 集成,或
- iOS SDK 12.0.3+,或
- iOS SDK 11.0.7 以上版本,并为 App AEM 活动中使用的任何通用链接实施了supportedDomains
- Singular 服务器到服务器(S2S)集成
- 实现深度链接支持,并在所有报告会话中传递 openuri=
- Singular SDK 集成,或
- (Singular) 启用了重新参与的活动 Singular iOS Facebook 合作伙伴配置
- (Meta)确保在 Meta 事件管理器中将 "MMP "选为"首选连接方法"。
Singular支持报告应用程序 AEM 活动提供的安装和重新参与(来自深层链接)。
- 通过Facebook 数据连接器集成,AEM 安装仅作为 "网络安装 Network Installs"汇总报告。
- 高级 AEM 安装在 Singular 的汇总 "跟踪安装 Tracker Installs"中报告。 由于 Meta 的数据共享政策,高级 AEM 的用户级别属性不可用。
- AEM 再参与会在用户级别和汇总(跟踪器再参与 tracker re-engagements)中报告,这些再吸引来自应用程序吸引活动提供的深度链接。支持的营销活动粒度包括
- 活动 ID
- 子营销活动 ID
- 创意 ID
确保在 Meta 事件管理器中将 "MMP "选为"首选连接方法"。
(安卓)Meta Referrer 常见问题解答
"Meta Referrer"是 Meta 推出的安卓专用归因解决方案,允许广告商从 Facebook、Instagram 和以应用程序安装为目标的 Audience Network 广告系列中获取安卓应用程序安装的细粒度用户级归因数据(参见 Meta的数据政策)。它由用于应用程序安装归因的 "Google Play Install Referrer "和 "Meta Install Referrer"技术组成。
Google Play Install Referrer | Meta Install Referrer |
(自 2021 年 10 月起可用) |
(自 2023 年 11 月起可用)
"非同一会话 "是指用户点击广告并被重定向到应用商店,但没有立即点击 "下载/安装"。用户稍后返回应用商店页面点击 "下载/安装"。 |
截至 2023 年 11 月,Singular 与 Meta 的集成同时支持 "Google Install Referrer"和 "Meta Install Referrer",Singular 称之为 "Meta Referrer"测量。
Singular 优先使用 "Meta Referrer"数据来归因,以便优先为广告商提供用户级数据。对于给定的安卓应用程序安装,Singular 将优先采用以下归因方法:
- (Meta Referrer) Meta Install Referrer
- (Meta Referrer)Google Install Referrer
- Meta 自归因 API
如果 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 提供安卓应用安装广告时使用的两种 Install Referrer 技术。
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 Install Referrer)并将其记录在设备上 Facebook 应用程序的本地存储层中。 一旦安装完成,用户首次打开应用程序,Singular 的 SDK 就会从设备上本地存储层获取的 Meta Install Referrer 数据中读取 Meta Referrer。然后,Singular 的服务器会对 Meta Referrer进行解密,以确定安装归属。 |
这两种技术同时使用,并与 Singular 与 Meta 的自归因集成一起,得出 Singular 归因决策。请参阅"Singular 如何在自归因数据和 "Meta Referrer "之间进行安装归因?
Singular SDK 和 S2S 集成要求
Google Play Install Referrer | Meta Install Referrer | |
Singular SDK |
|
|
Singular S2S 应用程序接口 |
|
|
合作伙伴配置要求
- 根据 步骤 2.4配置 Facebook 合作伙伴配置并提供 Meta "Install Referrer Decryption Key" 。
Meta 提供的两种测量方法之间出现差异的一些可能原因如下:
- Meta Referrer 支持安卓 12+ 系统上的限制广告跟踪用户,在安卓 12+ 系统上,谷歌广告 ID 不可用。只有当谷歌广告 ID 可用时,Meta 自归因才可用。
- 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 归因仅适用于 Android 设备。
要找到您的 Install Referrer Decryption Key,请按照以下步骤操作:
- 在 Meta Developers Portal 中,转到 "我的应用程序"并选择相关应用程序。
- 转到 "基本设置",向下滚动到 "安卓应用商店 "部分。
- 在"软件包名称"下,找到标有 "Install Referrer Decryption Key"的密钥。
合作伙伴数据政策
作为集成了 Meta 自归因 API 的 Meta 移动测量合作伙伴,Singular 遵守以下数据处理要求。
请注意,这些政策仅适用于 Meta 的自归因转化,不适用于安卓系统上的 Meta Referrer转化。
数据保留
Meta 用户级数据在原始归属 6 个月后删除。6 个月后,归属于 Meta 的用户将被视为/标记为"自然"用户,并在 Singular 的汇总和用户级报告中反映为"自然 Organic"用户。
数据访问
为保护最终用户的隐私,Meta 不允许广告商访问任何基于自归因转化的用户级数据。任何通常识别自归因的 Meta 转化的字段都标记为 "Unattributed"。
有限数据使用
如果最终用户选择限制或允许使用 "有限数据使用"(LDU)标记处理美国以下各州用户的数据,Meta 允许广告商通知 Meta:
- 加利福尼亚州(截至 2020 年 7 月)
- 科罗拉多州(截至 2023 年 6 月)
- 康涅狄格州(截至 2023 年 6 月)
Singular 在与 Meta 等符合隐私保护标准的合作伙伴集成时,会使用传递给 Singular SDK 和 S2S 的limitDataSharing值。当 Singular.limitDataSharing(true) 时,如果该用户是加利福尼亚州、科罗拉多州或康涅狄格州居民,Meta 将在 Meta 目标定位中 "限制数据使用"。如果没有明确提供limitDataSharing 值,Singular 默认会通知 Meta,"限制数据使用 "应适用于加利福尼亚州、科罗拉多州和康涅狄格州居民。
有关实施细节和示例,请参阅我们的iOS SDK、Android SDK 和S2S API指南。有关 "LDU "功能的更多信息,请参阅Meta 的开发人员文档。