概要:本文主要讲解了如何完成Meta ads与AppsFlyer的对接配置。
Meta ads设置指南
如要使用AppsFlyer来对Meta ads上的应用广告进行归因,最初的对接流程需要多长时间?
如果您已经在您的应用中接入了AppsFlyer SDK,并且在Meta ads上定义了您的应用,那么只需要不到一分钟的时间就能完成对接!
完成对接后,您无需登陆Facebook或在应用中接入Facebook SDK,即可进行移动归因。请按下文所述的基础设置步骤说明进行操作,完成后可以进一步了解Meta ads的高阶设置选项。
Facebook 应用 ID
在AppsFlyer中配置Meta ads对接之前,首先需要创建并获取Facebook App ID。
请按以下步骤创建Facebook App ID:
- 从Meta ads后台进入您的App Dashboard(应用面板)。
- 点击Apps下方的Create New App。
- 填写您的应用名称,并输入命名空间。请确保添加到您应用下的平台正确无误,否则可能无法对激活进行准确的归因。
请按以下步骤获取Facebook App ID:
- 从Meta ads后台进入您的App Dashboard(应用面板)。
- 点击所需的应用。
- 点击并复制屏幕左上方的App ID。
AppsFlyer是根据App ID来归因数据的,您可以使用同一个Facebook App ID对某个应用的安卓和iOS版本进行归因。但需要注意,Meta ads限制iOS 14+应用的广告账户数量,一个应用不能超过9个账户。
Meta ads基础归因设置
请按以下步骤使用AppsFlyer对Meta ads投放进行归因:
-
请按以下步骤激活Meta ads的对接:
- 进入 Meta开发者平台中的应用部分。
-
选择相关应用。
-
点击并复制
页面顶部的App ID。
- 从AppsFlyer的侧边栏中选择协作 > Partner Marketplace
- 搜索并选择Meta ads。
- 点击设置对接后, 您会跳转到 对接配置页面。
-
在渠道对接选项卡中,
打开启用该渠道开关。
请注意:/strong>在您与该渠道合作期间,请确保该开关总是处于打开状态。 -
在通用设置部分:
- 将您刚刚复制的App ID粘贴到Facebook App ID 字段中。
- 复制 Meta ads中的install referrer解密密钥,并将其粘贴到对应的字段中。
- 开启或关闭高级数据共享(Advanced data sharing), 详见下文的高级数据共享 说明。(2024年10月14日前逐步 向所有账户开放)。
- 点击保存对接 。
-
【可选】以下为推荐设置的配置方法:
-
建议将点击回溯窗口期设置为7天,
与Meta ads的窗口期对齐。
(请注意: 某些情况下,默认窗口期会有所变化)。 - 将浏览回溯窗口期设置为1天, 与Meta ads的设置对齐。
-
如需对
再归因窗口内完成重装激活的用户进行归因,
请打开重装激活归因的开关。
对于重装激活归因,无需再开启浏览型归因 或配置回溯窗口, 因为系统会自动沿用激活归因中的 配置。
-
建议将点击回溯窗口期设置为7天,
与Meta ads的窗口期对齐。
如果在完成上述操作后仍无法在AppsFlyer后台看到归因结果,请参考 Meta ads对接问题排查指南。
Meta ads高级归因设置
Meta ads的基础归因设置完成之后,您可以进一步设置一些高级对接配置。
用户级数据
Meta ads的受限归因数据
自2021年10月29日起,Meta仅向广告主 提供汇总数据。也就是说, 浏览及展示型归因的数据 在原始数据报告都会显示为“restricted”(受限)。与媒体渠道相关的其他字段 则不会得到填充。详情请见 原始数据内容限制。
这一限制对所有的广告主、操作系统和MMP都生效,并且会影响到所有iOS和安卓用户的设备层级数据,不论其ATT或个性化广告的授权状态如何。
AppsFlyer仍会从Meta ads接收设备层级的数据,也就是说我们的归因和报告功能(包括包括多触点归因、LTV、ROI、群组、留存报告、防作弊、受众共享等解决方案)不受影响。详情请见汇总与分析报告工具。
获取安卓端激活和应用内事件的用户级别数据
Google Play Install Referrer API
虽然用户级别的数据受限,但是对于将用户引导至Google Play商店的安卓端应用广告,Meta ads仍会与广告主共享广告投放的元数据。对于这类数据,广告主可以通过Google Play Install Referrer API获取归因字段(须在相关应用中接入该API)。通过Google Play install referrer API提供的字段会在AppsFlyer原始数据报告的匹配类型(match type)一栏以gp_referrer
标记出来。这些数据仅当同时满足以下条件时才会出现:1)解密密钥已提交;2)有归因到Meta ads 的激活。AppsFlyer可以通过这一方式对不带设备ID(即启用了LAT)的用户进行归因。
注意事项
AppsFlyer还可以通过Meta install referrer从设备本地存储中 接收广告系列元数据。 详情请见 Dev Hub(开发者资源中心) 的文档说明,了解如何让SDK 读取Meta install referrer。
除了Google Play Install Referrer API之外, AppsFlyer还可以通过Meta install referrer从设备本地存储中 接收广告系列元数据。 用于归因衡量。Meta install referrer与 Google Play Install Referrer API之间最主要的区别 如下:
- Meta install referrer中可包含展示 及点击数据,而Google Play Install Referrer API仅可传输点击数据
- Meta install referrer中可能包含 多个session的数据,而Google Play Install Referrer API仅限 末次session的数据(相关设备上的点击 和应用激活必须在同一个session内发生)
因此,您可能会看到原始数据报告中
归因到Meta的激活出现提升。如果某次激活
通过Google Play Install Referrer API
或Meta install referrer得到归因,则相关数据
会出现在原始数据报告中。通过
Meta install referrer传输的归因数据
会填充到AppsFlyer原始数据报告中。
对于Facebook带来的转化,其匹配类型(match type)会标记为fb_referrer
,
来自Instagram的
转化则以ig_referrer
来标记。仅在同时符合以下条件时,原始数据报告中才会呈现上述数据:
1)您已向AppsFlyer提交解密密钥(decryption key),且
2)已有激活被归因到Meta ads。Meta install referrer
的解密密钥(decryption key)与
Google Play Install Referrer中使用的密钥一致。
若您之前已向AppsFlyer提交过该密钥,则无需重复提交
。
通过Referrer获取的广告系列归因字段如下:
- Ad ID(广告ID)
- Ad name(广告名称)
- Adset ID(广告组ID)
- Adset name(广告组名称)
- Campaign ID(广告系列ID)
- Campaign name(广告系列名称)
- Account ID(账户ID)
- Channel(流量入口)
注意事项
-
Google Play Install Referrer API:
- 必须使用V5.4.0及以上版本的AppsFlyer SDK 才能确保referrer数据 的正常传递。Referrer数据的优先级 高于通过API传输的数据,且不 受限。这种数据传输方式对 点击型归因和 浏览型归因都适用。
- 流量入口(Channel)字段的值取决于Google Play Install Referrer API传递的channel值(由Meta发送到Google Play)。如果AppsFlyer接收到的channel值为空字符串,则流量入口字段显示为“None”。
- Meta install referrer: 请 参见 这篇公告文档中的 前期准备及必要操作部分。
Meta install referrer—常见问题解答
Meta install referrer在哪些场景中可用于归因?
-
激活归因:
- 点击型归因适用于所有广告系列
- 支持对 进阶赋能型应用广告(Advantage+ App Campaigns)以及 普投(如使用默认的受众年龄和性别设置)的手动应用广告 (Manual App Promotion Campaigns) 进行浏览行归因
- 兼容性:Google Play和Google Play以外的安卓应用商店
- 例外情况:不支持跳转到落地页的 广告系列
Meta ads中的普投用于哪些场景?
如需接收浏览型激活数据,就必须使用普投 (Broad targeting)。适用于普投的投放配置 包括:
- 年龄:默认设置 (18-65+)
- 性别:默认设置(所有性别)
- 地理位置:可指定国家和国家集群。 请注意:如需针对范围较小的地区进行定向投放 (如按城市或邮编投放),请 在添加这些定向条件时 将其要求设置为“relaxed”(宽松)。
- 精准定向:对于兴趣分组、行为模式 以及人口统计特征的高级选项,须将其要求设置为“relaxed”(宽松)。
- 自定义人群包:将定向要求设置为“relaxed”(宽松)。
-
将定向要求设置为“relaxed”时,必须
勾选“Advantage detailed targeting”选项,如下图所示:
来自Google Play Referrer API或Meta install referrer的加密数据
来自Google Play Referrer API或Meta install referrer的数据由Meta完成加密。您可以使用您Meta开发者账户中的密钥对这些数据进行解密。您需要向AppsFlyer提交该密钥,具体步骤请见下文说明。每个应用只需提交一次解密密钥。
请注意:如果该密钥缺失或被删除,即使在没有上述广告归因字段的情况下,AF仍可以根据Referrer将激活归因到Meta ads,但需要符合以下条件:
- Meta ads未认领该激活
- 从Google Play Install Referrer API接收到数据,但该数据未解码
-
且对应的广告交互是激活前的最后一次点击
请按以下步骤获取Meta账户中的解密密钥:
- 登录Meta开发者平台。
- 点击进入页面右上角的My Apps。
- 选择相关应用,获取其解密密钥。
-
从页面左侧进入Settings > Basic。
- 向下滚动到安卓部分,即可 在包名(Package Names)字段的下方 看到标记为Install Referrer decryption key的解密密钥。 请注意:您的包名及Google Play Store 的配置也是在这个部分完成的。
请按以下步骤在AppsFlyer后台设置解密密钥:
成本、点击和展示
此对接可提供广告系列、广告组、广告以及国家/地区维度的 汇总成本、点击 和展示数据。另请参阅 广告平台成本对接列表 ,其中列出了所有的适配维度、指标 和功能。
请注意:该对接涵盖点击 和展示数据,但 您需要购买ROI360才能获得成本数据。
成本API的启用方式如下:
- 确保您已登入Meta ads用户 账号,且有权限处理该账号 在Meta ads上的广告投放。您作为登录用户必须 具有在Meta Business Manager中投放所有广告系列的 权限。
- 进入成本选项卡。
- 打开获取成本、点击和展示数据开关。
- 点击f login按钮。您 可以使用Meta ads的business或admin账号 完成登录。
-
在弹窗提示中选择允许AppsFlyer访问您的
Meta ads广告系列数据。
请注意:在对接完成后的首次数据同步 以及后续同步中, AppsFlyer最多会接收到最近7天 的成本数据。
详情请见 Meta ads对点击和浏览的定义。
如需删除绑定的Meta ads账户,请按以下方式操作:在 “操作”一栏中,将鼠标悬停在相关账号上,然后点击 删除连接。
注意
- 在已登入Meta ads的状态下 点击f login 按钮,窗口会立即打开并 关闭。这是正常现象。
- 如果您的账号下有多个具备Meta ads权限的用户, 建议您为这些用户 都完成登录,以 避免获取的数据不完整。
成本数据同步状态
您可以在成本(及广告收入)对接状态面板或单独的广告平台面板中查看AppsFlyer最近一次获取匹配成本数据的时间以及API状态。
您可以同步多个帐户的成本数据拉取。 对于每个同步账户,AppsFlyer都会显示 成本对接的状态以及AppsFlyer最近一次拉取到 匹配成本数据的时间。
如需进一步了解数据扩充,请参考成本、点击及展示数据。
应用内事件映射
请按以下步骤映射应用内事件:
-
打开应用内事件回传开关。
为某个应用 首次启用Meta ads的应用内事件映射时, 系统会自动将af_app_open 映射到fb_mobile_activate_app。 -
填写以下参数:
参数名称 说明 AppsFlyer事件 输入事件名称。 该名称必须与 AppsFlyer 通过 SDK 或 S2S接收到的事件名称 一致。
提示: 如果 下拉菜单中没有 您要查看的 事件:- 请确保您 以非自然的方式 安装相关应用 并完成该事件, 然后重新在下拉菜单中查找该事件。
- 在 AppsFlyer事件一栏中 输入该事件,然后点击创建自定义事件的按钮。 详情请见 自定义事件的映射指南。
渠道映射事件 Meta ads 赋予 各事件的 唯一名称 或ID。您可以使用下列方式 配置映射:
- 文本字段: 输入该事件在 Meta ads中的 事件ID
- 下拉菜单: 选择最合适的 AppsFlyer预定义 事件。
- 按原样: 按原样发送事件, 不映射 事件 名称。
事件来源 选择事件回传的范围:
- 仅该合作渠道:仅回传归因到Meta ads的事件。
- 所有媒体渠道,包括自然流量:回传归因到任何渠道以及自然量的事件。
回传内容 - 不发送值与收入(默认): 仅发送 事件本身, 不带事件 值。
- 发送值与收入: 发送所有事件 参数, 回传内容 收入值 (若 有)。
- 仅发送值: 发送 除 收入值以外的所有参数。
- 如需在事件列表中添加SDK 或S2S事件 请点击添加项目。
关于事件名称的限制:
- 事件名称的长度限制:2-40个字符
-
不允许使用以下字符:
- 冒号(:)
- 期间(。)
- 非拉丁(英文)字母的字符集:自 2020年1月12日起,Meta ads不再接受 中文字符。AppsFlyer未 测试过其他字符集。 在使用特定的字符集之前,请务必 先确认Meta ads可在回传中支持 这些字符。
- 事件名称区分大小写。为了避免出现数据差异,请 确保您在所有渠道对接和应用版本中 使用的事件名称大小写都保持一致。
注意事项
Meta ads可以根据您的广告收入数据 来优化投放。如需通过此方式优化投放,您需要 将af_ad_revenue事件映射 到对应的Meta ads事件。再营销归因
AppsFlyer支持Meta ads的再营销归因。 广告主可以使用这一功能对现有用户与Facebook广告的 交互行为进行归因,并通过AppsFlyer报告来衡量 此次广告交互之后的用户质量。 建议您仅在面向Facebook上的自有流量定向投放 广告时才使用这一功能。
- 在应用配置页面打开再营销开关 。
- 在Meta ads的渠道对接页面中打开 再互动归因的开关。
-
设置
点击型再互动回溯窗口。
再互动回溯窗口是指 从广告点击到 应用打开之间的最长时间间隔, 在此期间完成的应用打开才会被记录为再互动。
选择回溯窗口的时间单位(小时或天), 然后将滑块拖动到所需的时间值。
- 启用浏览型再互动归因。
-
使用滑动条根据您的需求设置浏览型再互动回溯窗口期(最长为24小时)。用户浏览广告后,在该窗口期内打开应用时,AppsFlyer才会将该应用打开记录为一次再互动。
-
设置 再互动窗口期。
在此期间发生的应用内事件 会归因到再营销渠道, 并将其记录为主要带量渠道。
这个值可以设置为数天(1-90天)、数小时(最长23小时) 或用户的整个生命周期。默认值为30天。
进一步了解 AppsFlyer再营销归因。
进一步了解 Meta ads等SRN中的深度链接配置。
高级数据共享(Advanced data sharing)
开启高级数据共享后, Meta在接收带有设备级别标识符的 回传及事件时会覆盖到所有设备,包括 将Advertising ID(即IDFA)设置为不可用的设备。
此时, AppsFlyer可对这些事件进行归因。 该功能关闭时,仅限 带有IDFA的设备所产生的回传和事件才会得到共享和归因。
这种数据共享方式同时支持以下两类应用:1)在广告主应用和流量侧应用中都拒绝授权的设备(dual opt-out),以及 2)仅在其中一个应用中拒绝授权的设备(single opt-out)。 该方式适用于iOS中的深度链接到再互动转化以及点击到激活转化, 这些流量仅可通过末次点击逻辑进行归因, 归因窗口期最长为 24小时。
注意事项
若高级数据共享开关已打开, 但您未接收到Meta的归因数据, 请检查这些共享事件是否符合Meta的共享标准。 详情请见 Meta提供的说明文档
加州消费者隐私法案(CCPA)合规性
在符合CCPA隐私条例的情况下, 位于美国加州的Meta ads用户所产生的数据 会受到限制。
如需符合CCPA要求: 请打开 限制Meta ads对用户个人信息的使用(CCPA) (此开关在渠道对接选项卡中)。
进一步了解 数据保护法。
广告收入记录
如果您的应用通过Meta Audience Network Ad Revenue 进行广告变现,您可以在 AppsFlyer中记录来自Meta ads的收入。无论是结合 应用内购买的收入数据,还是单独使用广告收入数据,都可以 全面了解您的用户收入情况。
记录Meta Audience Network的广告收入
- 进入广告收入选项卡, 打开获取广告收入数据的开关。
-
选择您想要获取的
汇总广告收入数据类型:已归因的收入(Attributed Revenue)
和/或 汇总的变现收入(Aggregated monetization revenue):
-
已归因的收入(Attributed Revenue):
按获客渠道呈现的
收入。
设置事件来源, 请选择一个最能 体现相关广告收入模型的 事件。举例来说,如果您的收入 按广告展示来计算,建议您 向AppsFlyer发送ad_viewed事件。 您可以为每个变现平台分别 配置最为适配的事件, 也可以使用af_app_opened
事件。如果使用应用打开来表达收入事件, AppsFlyer就会根据用户完成的每一次应用打开 对广告收入进行归因。 - 汇总层级的变现收入: 按广告渠道分组的收入。
-
已归因的收入(Attributed Revenue):
按获客渠道呈现的
收入。
- 界面会显示广告收入事件。 这是一个只读字段,用于表示新创建的广告收入事件, 其命名方式“[收入来源事件]_monetized” (以上文中基于广告展示的收入为例,此时该字段会显示为ad_viewed_monetized )。该广告收入事件 会在面板中显示为一个额外添加的事件。
- 点击连接至Meta ads, 在Meta ads中启用 Meta Audience Network Ad Revenue。使用您的Meta ads 证书完成登录,并对Meta Audience Network Ad Revenue进行授权。
-
输入
Audience Network App ID(Facebook App ID)。
您可以从Meta Audience Network中获取此ID。
- 获取 Facebook App ID。
- 将此ID复制到AppsFlyer中的Audience Network App ID 字段。
- 点击保存广告收入。
授权
使用该选项卡中的权限开关,根据实际需求向Meta ads 开放各种操作权限及数据访问权限。
进一步了解 如何为对接渠道授权。
适用于iOS的Aggregate Event Measurement(AEM)
AppsFlyer支持Meta ads的Aggregated Event Measurement(全事件衡量,简称AEM)。该解决方案可用于优化Meta ads上的iOS转化及应用内事件,同时对iOS再互动进行归因。
Meta ads对接问题排查
如果您已完成基础对接,但仍未在AppsFlyer面板看到来自Meta ads的归因结果,可能是因为对接之后Meta ads尚未带来新增激活。
出现该问题时,请检查是否出现以下情况:
未收集IDFA
您必须将AdSupport.framework添加到您的项目中,才能进行IDFA的收集。详情请参见iOS专用的SDK对接指南。您可以检查激活原始数据报告中的IDFA一列是否为空。建议通过您的iOS应用收集IDFA,通过安卓应用收集GAID。
从iOS 14.5开始,您必须在应用界面显示ATT弹窗,在用户同意授权后才能收集IDFA。
请注意:SKAdNetwork归因不受IDFA可用性的影响。但请确保在Meta ads后台设置iOS 14广告时打开“iOS 14 Campaign”开关。
错误的Facebook App ID
请检查该App ID是否与Meta ads后台的值完全一致。
注意:您还可以使用Facebook的Graph API来验证您的Facebook App ID。
Meta ads上的应用状态
您必须将Meta ads上的应用状态设置为Live(已上线)而不是In development(开发中),否则无法正常归因。
Meta ads广告类型设置有误
AEM归因未生效
Meta ads应用激活
设置Meta ads中的App Install(应用激活)广告时,您可以从下拉列表中选择应用,也可以复制粘贴该应用的完整商店链接。虽然这两种方法在Meta ads上都可行,但如果您第二种方法,会导致AppsFlyer无法归因。
下图为正确的设置方法,按此方法设置后AppsFlyer可正常归因。
下图为错误的设置方式,按此方式设置后AppsFlyer无法正常归因。
Meta ads更新
重要提示!
从2021年10月29日开始,Meta ads仅向广告主提供汇总数据,包括激活和应用内事件。该限制对所有的广告主、操作系统和MMP都生效,并且会影响到所有iOS和安卓用户的设备层级数据,不论其ATT或个性化广告的授权状态如何。
此次更新(2021年10月29日)之前产生的激活和应用内事件的原始数据仍然可用。
请注意:您可以通过Google Install Referrer获取用户级别数据。
详情请见重要更新公告。
与Meta ads有关的iOS 14更新
我们会确保AppsFlyer与Meta Ads的MMP对接总是使用Advertiser Tracking Enabled标记,因此广告主无需在AppsFlyer后台进行任何操作。这是继Meta ads在2021年2月推出iOS 14应用指南后做出的更新。
相关文档
- 请参考Meta ads与AppsFlyer的SKAN互动设置,了解iOS 14的相关注意事项。
- Meta投放管理合作平台配置 (Bidalgo / Kenshoo / Adquant / Webpals)