Facebook(Meta)广告归因集成

 

自 2024 年 10 月 9 日起,Meta 和 Singular 将额外支持 iOS 聚合事件测量 (AEM) 的增强功能 "高级 AEM"。 对于符合 AEM 条件的应用程序,高级 AEM 可在 Singular 跟踪器数据中报告 AEM 安装属性,从而进一步改进归因测量。请参阅什么是高级 AEM?

集成摘要

作为 Meta 移动测量合作伙伴,Singular 允许应用程序发布商跟踪来自FacebookInstagram 的广告下载推荐。一旦下载被 Singular 验证,您还可以跟踪这些用户在您的移动应用程序中的后续用户参与情况。

Singular 通过多种方式报告来自 Meta 的归因数据:

  1. Meta的自归因API:Singular会将用户级应用活动报告给MMP专用的Meta API,由Meta进行自归因,并在Singular中进行归因。通过该 API 进行的归因受Meta 针对广告商的数据限制
  2. Meta 的 "Meta Referrer"(仅限安卓):请参见"Meta Referrer
  3. Meta 的 "聚合事件测量(Aggregated Event Measurement)"(仅限 iOS):请参见"聚合事件测量
  4. Meta 的 "SKAdNetwork 报告"(仅限 iOS): 请参阅 "Meta SKAdNetwork 报告": 请参阅"Meta SKAdNetwork 集成指南"。

(参见合作伙伴集成术语表)

合作伙伴 Facebook (Meta)
合作伙伴类型

自归因广告网络

创意 支持
出版商 支持
浏览 支持
通过 Android Meta Referrer 提供用户层级报告,适用于具有广泛目标定位功能的 Advantage+ 应用程序推广活动和手动应用程序推广活动
深度链接 Singular与Meta的集成不使用Singular跟踪链接(包括Singular深度链接)。请参阅Meta 文档,了解如何设置 Meta 深度链接
再营销

支持
仅适用于 iOS 聚合事件测量 (AEM) 的用户级报告

点击标签 否(自归因)
接收所有安装

推荐(自归因)
iOS AEM 需要

接收所有事件

推荐(自归因)
iOS AEM 需要

设置说明

需要配置 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 的合作伙伴

  1. 访问Meta 应用程序控制面板。从应用程序列表中找到您的应用程序并复制应用程序 ID

    Where to find the Facebook App ID

  2. 在 Singular 中,转到 "属性">"合作伙伴配置",然后在搜索框中输入 "Facebook"。
  3. 输入您的 Facebook 应用 ID。您可以使用逗号分隔添加多个 Facebook 应用 ID。

    fb_app_id.png

  4. 仅适用于 Android 应用程序:输入您的安装推荐人解密密钥(Install Referrer Decryption Key)(请参阅下面的"在哪里可以找到安装推荐人解密密钥?)

    重要: 要使用Meta Referrer进行归因,必须执行此步骤。

    fb_decryption_key.png

3

指定归因设置

  1. 如果要对 Meta 广告的浏览转化进行归因,请启用 "浏览归因"。
  2. 如果您想对参与 Meta 广告的现有应用程序用户的再次参与进行归因,请启用再次参与跟踪。
    partnerconfig_settings1.png
  3. 选择您的点击归因回溯窗口,以指定广告可以被归功于安装的时间长度。
    partnerconfig_window.png
  4. 保存集成。
    注:保存 Facebook Ads 集成配置后,Singular 将自动跟踪安装和会话至 Meta。这与 mobile_app_install 和 fb_mobile_activate_app 事件相对应。您无需在步骤 6 中单独配置这些事件。
4

向 Meta 发送事件回传

Singular 支持根据 Meta 的所有要求向 Meta 发送事件通知。

facebook_events.png

  • 首先,从下拉菜单中选择要发送给 Meta 的事件。
  • 然后,映射您的应用内事件:

    • 根据 SDK 中使用的名称选择左侧字段中的事件名称,并将该名称映射到 Meta 预定义的转换事件之一。
    • 或者,选择"(Use SDK Event Name)",以便在 Meta 的自定义事件优化营销活动中使用该事件(仅限 Android 和 iOS<14 营销活动)。
    • 包含收入值:如果相关,选中 "Include Revenue Value"复选框。如果不选中,则只发送事件的计数。建议 "fb_mobile_purchase "和 "AdImpression " Meta事件使用 "包含收入值"。
      • fb_mobile_purchase:任何应用程序内的收入 SDK 事件都应映射到 "fb_mobile_purchase",以便将收入发送到 Meta,从而启用价值优化活动。
      • AdImpression: 如果已实施Singular 的广告收入归属,则可通过 "AdImpression"向 Meta 报告广告收入。选择"__ADMON_USER_LEVEL_REVENUE__"SDK 事件并将其映射到 "AdImpression",选中 "Include Revenue Value"(包括收入值)。

另请参阅: 在同一应用程序中使用 Meta SDK 和 Singular SDK/S2S

5

在 Singular 中跟踪 Facebook(Meta)安装情况

完成上述步骤后,您就可以在 Singular 报告中看到 Meta 移动应用程序营销活动的结果。

  • 对于 iOS 应用程序,Meta 的聚合事件测量(AEM)适用于

归因于 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

常见问题

Singular 如何跟踪 Meta 归因?

作为Meta移动测量合作伙伴,Singular 允许应用程序发布商跟踪来自 Facebook Instagram 的广告下载推荐。一旦下载被 Singular 验证,您还可以跟踪这些用户在您的移动应用程序中的后续参与情况。

Singular 通过两种方式从 Meta 获得归因数据:

  • Meta 的自归因 API:由于 Meta 的数据共享限制,从该 API 获取的安装数据只能在 Singular 的汇总报告中使用(不能在用户级数据日志中使用)。
  • Meta 的 Meta Install Referrer 解决方案:这一新的安卓应用程序安装测量解决方案可在 Singular 的汇总报告和用户级数据日志中显示数据。请参见 Meta Referrer FAQ。
Singular 和 Meta 之间的通信安全吗?

Singular 使用 Meta 要求的所有必要安全措施,以确保 Singular 和 Meta 之间的通信安全。我们也遵守 Meta 规定的所有隐私政策来保护您的数据。

我仍然看不到 Meta 归因安装。我在哪里可以得到帮助?

如果您已经按照设置步骤进行了测试,但仍未看到 Meta 归因安装,请联系 Singular 的支持团队寻求更多帮助。请在第一封邮件中提供您的账户名、对应的应用程序和 Facebook 应用程序 ID,以确保快速解决问题。

在哪里可以找到应用程序的 Facebook 应用程序 ID?

您需要有一个开发者帐户。转到 Meta 应用程序控制面板。从应用程序列表中找到您的应用程序并复制应用程序 ID

Where to find the Facebook App ID

我需要设置启用广告商跟踪 AdvertiserTrackingEnabled (ATE) 标志吗?

作为 iOS 14 相关更新的一部分, Meta 宣布了MMP一起使用启用广告商跟踪标志的新指南,包括如何使用 ATE 标志您与 Singular 的集成会自动执行该标志,并为通过 iOS应用程序跟踪透明度选择跟踪的用户设置该标志在您的 Singular SDK 实施中不需要额外的操作。

我能向 Meta 发送广告收入数据吗?

如果您已实施Singular 广告收入归因,则可通过 Meta 的 AdImpression 事件向 Meta 报告广告收入数据。如果广告收入数据符合 Meta 的资格要求,向 Meta 报告的广告收入可用于优化。

如果 Meta 报告某个事件缺少货币和价值参数,我该怎么办?

如果从 Meta 中遇到此错误,则表明该事件预计为收入类型事件。要解决这个问题,请确保在使用 Singular SDK 从应用程序发送事件时,包含所需的货币和价值参数。此外,在合作伙伴配置设置中,确保为该事件启用 "包含收入值(Include Revenue Value)"。

更改事件映射会影响历史数据吗?

不会,对事件映射的任何更改只会从配置生效起开始应用。历史数据不会被追溯更改。

我是一家需要与广告商开展广告活动的代理公司,我该怎么做?

请确保 Meta 上的所有权限都设置为允许您为广告客户开展营销活动。请在 Meta 广告系列名称中包含您的公司名称,以便我们将您的广告系列与其他存在的代理广告系列或内部广告客户广告系列区分开来。

(iOS)聚合事件测量 AEM 常见问题

什么是 Meta 应用程序 AEM 和高级 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帮助中心的文章

启用应用程序 AEM 和高级 AEM 有哪些要求?

从 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 选项作为归因方法:

为 "应用程序参与"营销活动启用 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)集成
    • (Singular) 启用了重新参与的活动 Singular iOS Facebook 合作伙伴配置
    • (Meta)确保在 Meta 事件管理器中将 "MMP "选为"首选连接方法"。
Singular 如何归因和报告应用程序 AEM 活动?

Singular支持报告应用程序 AEM 活动提供的安装和重新参与(来自深层链接)。

  • 通过Facebook 数据连接器集成,AEM 安装仅作为 "网络安装 Network Installs"汇总报告。
  • 高级 AEM 安装在 Singular 的汇总 "跟踪安装 Tracker Installs"中报告。 由于 Meta 的数据共享政策,高级 AEM 的用户级别属性不可用。
  • AEM 再参与会在用户级别和汇总(跟踪器再参与 tracker re-engagements)中报告,这些再吸引来自应用程序吸引活动提供的深度链接。支持的营销活动粒度包括
    • 活动 ID
    • 子营销活动 ID
    • 创意 ID
如果我也使用 iOS 版 Meta SDK,应该如何启用应用程序聚合事件测量 AEM?
为了避免在 Meta for AEM 中重复使用应用程序事件,建议仅使用 Singular SDK 实现这些事件并通过 MMP 集成将其传递给 Meta。有关详细信息,请参阅我们的 Meta 和 Singular SDK 互操作性指南。

确保在 Meta 事件管理器中将 "MMP "选为"首选连接方法"。
Meta 的应用程序 AEM 如何与 SKAdNetwork 协同工作?
Meta's App AEM 和 SKAdNetwork 是两种不同的测量方法。Meta 在其相关指南中记录了比较两种方法时的预期差异。
  • App AEM 利用通过 Singular 与 Meta 的 MMP 归因整合报告的应用程序转换数据(本文)
  • SKAdNetwork 利用苹果公司的归因框架进行归因。有关 SKAdNetwork 的 Singular 与 Meta 集成的更多信息,请阅读我们帮助中心的相关文章

(安卓)Meta Referrer 常见问题解答

什么是 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 月起可用)
使用"Google Play Install Referrer"为通过 Google Play 商店进行的 Meta 应用程序安装活动的 Android 点击安装进行归因。

(自 2023 年 11 月起可用)
除了支持与 Google Play Install Referrer 相同的归因方案外,Meta Install Referrer 还支持 Google Play Install Referrer 不支持的归因流程:

  • 大多数浏览归因方案(Advantage+ 应用程序营销活动和具有广泛定位功能的手动应用程序推广营销活动)
  • 支持非谷歌应用商店
  • 非同一会话点击归因

"非同一会话 "是指用户点击广告并被重定向到应用商店,但没有立即点击 "下载/安装"。用户稍后返回应用商店页面点击 "下载/安装"。

截至 2023 年 11 月,Singular 与 Meta 的集成同时支持 "Google Install Referrer"和 "Meta Install Referrer",Singular 称之为 "Meta Referrer"测量。

Singular 如何在自归因数据和 "Meta Referrer"数据之间进行安装归因?

Singular 优先使用 "Meta Referrer"数据来归因,以便优先为广告商提供用户级数据。对于给定的安卓应用程序安装,Singular 将优先采用以下归因方法:

  1. (Meta Referrer) Meta Install Referrer
  2. (Meta Referrer)Google Install Referrer
  3. Meta 自归因 API

如果 Meta Referrer 数据不可用,或由于最后一次接触方法输给 Meta 自归因转化时,Singular 将使用自归因认领。这样做既能最大限度地利用用户级归因数据,又能确保对 Meta 营销活动进行准确的综合衡量。

通过 Meta Install Referrer 或 Google Install Referrer 进行的归因可在用户级报告中作为来源 "Facebook "提供,并可分别通过归因方法("Method")"meta_referral_id""referral_id" 进行区分。

Meta Referrer 如何工作?

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 "之间进行安装归因?

启用 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 应用程序接口

 

合作伙伴配置要求

  • 根据 步骤 2.4配置 Facebook 合作伙伴配置并提供 Meta "Install Referrer Decryption Key"
为什么 Meta Referrer 归因和 Meta 自归因之间存在差异?

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 归因有何关联?

要通过 Meta Referrer 接收浏览型安装数据,必须进行广泛定向。您可以在下面找到支持的营销活动配置:

  • 年龄:应用默认设置 "18-65+"。
  • 性别:应用默认设置 "所有性别"。
  • 地点:默认设置: 应用地区、国家组(如亚洲)或特定国家作为位置。
  • 详细定位:如果要应用人口统计、兴趣或行为等详细定向,则需要选择 "高级 "详细定向
  • 自定义受众:如果应用了自定义受众,则需要选择进入优势自定义受众



Meta Referrer 解决方案是否适用于 iOS 营销活动?

Meta Referrer 归因仅适用于 Android 设备。

在哪里可以找到我的 "Install Referrer Decryption Key"?

要找到您的 Install Referrer Decryption Key,请按照以下步骤操作:

  1. 在 Meta Developers Portal 中,转到 "我的应用程序"并选择相关应用程序。
  2. 转到 "基本设置",向下滚动到 "安卓应用商店 "部分。
  3. "软件包名称"下,找到标有 "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 SDKAndroid SDKS2S API指南。有关 "LDU "功能的更多信息,请参阅Meta 的开发人员文档