AppsFlyer与Facebook Ads的SKAN互通指南

概要:与Facebook互通后,一方面Facebook可以向AppsFlyer发送解析后的SKAN数据,另一方面AppsFlyer也可以与Facebook Ads分享广告主的CV值映射构架。

SKAN互通性:AppsFlyer <-> Facebook

如果您通过多个渠道投放广告,建议您在AppsFlyer后台完成互通设置。因为这样您就可以利用AppsFlyer平台上的其他可用指标(如成本等)来扩充SKAN的效果指标数据。

扩展阅读:AppsFlyer SKAN解决方案指南

AppsFlyer与Facebook的SKAN互通作用范围

与Facebook互通后可以实现以下功能:

  • AppsFlyer和Facebook会共享SKAN转化值(CV)的映射构架,这样广告主就能同时收到来自这两个平台的投放效果指标。
  • AppsFlyer能支持Facebook Ads中的所有投放目标,从而推动广告优化。这些目标包括:
    • Mobile app install(应用安装,简称MAI)
    • Mobile app engagement(应用互动,简称MAE)
    • Value optimization(价值优化,简称VO)
  • SKAN对接启用后,数据链路会发生以下变化:
    • Facebook的SDK停止对SKAN CV的更新(即通过kill switch来终止数据流)。
    • AppsFlyer的SDK更新CV值。
    • Facebook共享SKAN回传数据,这些数据会包含在SKAN面板和汇总报告中。

其他注意事项:

  • 在不启用SKAN渠道对接的情况下,SKAN面板会把来自Facebook的激活计为自然量。
  • 在AppsFlyer的归因模式下(即数据总览面板中):
    • 可准确归因来自Facebook的新增授权用户。
    • 拒绝授权的用户会归因为自然量。
  • iOS 14.5对SRN数据上报的影响
  • 我们与Facebook的MMP对接设置会默认打开Advertiser Tracking Enabled(启用广告主追踪)功能。(基于2021年2月Facebook移动广告规范中的iOS 14广告设置流程)

注意事项

  • 启用互通设置后,您更改衡量设置时无需再重复本指南中的MMP对接流程。也就是说,您无需再次复制相关MMP对接的URL。
  • 如果您在AppsFlyer后台关闭了SKAN衡量开关,那么Facebook就无法获得CV值的映射信息。
  • AppsFlyer SDK与Facebook SDK的对比:Facebook SDK适用于仅在Facebook投放广告的场景。如果是多渠道投放,还是建议您使用AppsFlyer的SDK,因为这样您就可以查看所有渠道的数据。
  • 关于可能出现的数据差异,请参阅本文中的相关部分

Facebook中的应用安装广告配置指南

在Facebook上配置iOS 14应用安装广告时,需特别注意Facebook投放指南中的以下几条规则:

  • 每个应用最多可以有9个广告系列,每个广告系列下最多可以有5个广告组。每个应用ID最多可以有9个广告账户,也就是说广告主最多可以在9个账户下各投放9组广告系列。
  • 您无需专门为iOS 14的广告投放单独设置账户,可以直接通过现有账户投放iOS 14广告。
  • 不同的AppsFlyer衡量类型适用于不同的Facebook优化方式,具体的对应关系如下:
    • 收入衡量:VO和AEO。
    • 转化衡量:AEO——包括Facebook的标准事件和购买事件。请确保将AppsFlyer中设置的事件准确映射到Facebook。

互通设置流程

请按以下流程完成互通设置。

对于应用激活归因:

让Facebook将SKAN数据共享给AppsFlyer

设置互通后,Facebook会将SKAN数据共享给AppsFlyer。如果您不设置互通,就无法在AppsFlyer的SKAN面板中看到归因给Facebook的SKAN激活。

针对每个应用只需完成一次互通设置。

请按以下步骤开通Facebook向AppsFlyer发送SKAN数据的权限:

  1. 在AppsFlyer后台,前往配置>对接渠道
  2. 选择Facebook。

    FacebookEnable.png

  3. 点击进入SKAN选项卡。
  4. 点击Facebook登录。您必须使用具备以下权限的管理员或广告主账户登录:
  5. 请按照用户界面的说明进行操作。
    在Facebook后台完成相关流程后,您会跳转到AppsFlyer。
  6. 确认账户状态显示为waiting for sync(等待同步)。
    在AF成功从Facebook获取数据之前都会显示这一状态。
  7. 等到第二天的UTC时间02:00之后查看授权状态,确认是否开通成功
    SKAN面板中的数据会在每天UTC时间的08:00前更新。
  8. 关于可能存在的衡量差异,请参阅本文中的相关部分

对于应用内事件归因:

与Facebook分享CV值映射构架

SKAdNetwork-Facebook-AppsFlyer_integration__5_.png

AppsFlyer与Facebook的SKAN互通启用方式

步骤 操作 具体内容

1

应用侧的前期准备
  • 在应用中接入最新版本的AppsFlyer SDK

2

检查SKAN设置

确认已设置并启用AppsFlyer的SKAN方案,因为这样AppsFlyer的SDK才能调用SKAN API来设置CV。

请按以下步骤检查SKAN设置

  1. 从AF后台进入配置 > SKAN转化值操作台
  2. 点击选项图标,确认SKAN衡量已开启。
    Measurement_mode_on_facebook_ads.png
  3. 选择合适的衡量模式。详情请见SKAN转化值操作台
  4. 记下应用内事件的准确名称,在下一步流程中会用到。请注意:事件名称是分大小写的。

3

应用内事件映射

检查应用内事件是否正确映射到Facebook,并作必要的修改。

请按以下步骤查看并设置应用内事件映射

  1. 在AppsFlyer后台,前往配置>对接渠道
  2. 选择Facebook
  3. 进入对接选项卡。
  4. 【必须完成】打开应用内事件回传开关。
    • 请务必根据当前选定的SKAN衡量模式进行映射。默认的衡量模式为收入模式。
      in-app_events_fb_en-us.png
    • 请确认SKAN衡量模式中设置的应用内事件(即AppsFlyer事件)正确映射到Facebook的事件标识符(即渠道映射事件)。若不设置事件映射,Facebook就无法优化投放,仅能记录激活数。

       注意

      在SKAN转化值操作台中添加、更改或删除转化值(CV)时,请确保相关事件已映射到应用内事件回传。否则Facebook无法呈现CV值的更新。

      应用内事件映射指南

      衡量选项 映射条件
      自定义

      把在自定义模式中设置的应用内事件映射到Facebook。

      如需通过回传上报收入,必须把Send revenue(发送收入)设置为Values & revenue(事件值和收入)。

      SendValueandRevenue.png

      af_skad_revenue用于总体收入的衡量,一般映射到Facebook的fb_mobile_purchase收入事件。

      请注意:fb_mobile_purchase可以对应多个事件。

      收入

      如果您想通过向广告平台回传数据来上报收入,请确保您已经在回传中设置了相关应用内收入事件的映射。

      af_skad_revenue用于总体收入的衡量,一般映射到Facebook的fb_mobile_purchase收入事件。

      请注意:fb_mobile_purchase可以对应多个事件。

      转化 映射1–6个转化事件,与Facebook的事件一一对应。
  5. 点击保存对接
  6. 向下滚动到SKAN配置,点击MMP连接URL右侧的复制图标。在后续步骤中,您需要把这个URL粘贴到Facebook后台,具体位置请见下一部分的说明。

    skan_configuration_mmp_url.jpg

4

打通AppsFlyer与Facebook的对接。
  1. 在Facebook后台打开events manager(事件管理器)。

    FacebookSkadNetworkSetup.jpg

  2. 进入Settings(设置)选项卡。

    mceclip0.png

  3. 在Configure App Events for SKAdNetwork(为SKAN配置应用内事件)板块,点击Set Up Events(设置事件)。

    mceclip1.png

  4. 选择Import from partner app(导入MMP的CV映射构架)。
    界面会显示MMP Connection URL(MMP对接链接)字段,请将相关链接复制粘贴到该字段中。
    这是为了向Facebook发送CV映射信息,并让广告主应用中的Facebook SDK停止设置CV。如果“Import from partner app”(导入MMP的CV映射构架)显示为不可用,请参考问题排查部分。
  5. 请按照Facebook用户界面中的说明进行操作。完成操作后会出现以下两种结果:
    1. MMP对接URL成功粘贴到Facebook用户界面。代表您已顺利完成对接,可以继续完成剩下的步骤。
    2. MMP对接URL粘贴失败,Facebook用户界面报错。如果出现这种情况:
      - 等待24小时,然后重复以上步骤。- 如果持续出现同样的错误(超过24小时),请联系AppsFlyer技术支持。

备注

  • 该流程只需完成一次,也就是说在AppsFlyer后台更改衡量设置后无需再次复制粘贴对接URL。比如,如果您从收入模式切换到转化模式,Facebook会使用现有的URL来获取现行的映射构架。
  • 完成该流程后,Facebook就能通过其独有的随机化结构从AppsFlyer获得CV映射构架,这是广告主无法配置的。
  • 如果您在AF后台更改了衡量设置,新设置会在24小时内开始对Facebook生效。

5

iOS 14投放设置

确认Facebook后台的iOS 14投放设置已开启。

您可以在设置页面的New App installs Campaign(新建应用安装广告)部分查看该设置。

FBiOS14.png

其他信息

关闭SKAN对接

关闭Facebook Ads对接时,不仅需要关闭启用该渠道按钮,还必须删除SKAN连接,才能停止SKAN数据的记录。

请按以下步骤关闭SKAN对接:

  1. 在AppsFlyer后台,前往配置>对接渠道
  2. 选择Facebook Ads。
  3. 进入SKAN标签页。
  4. 点击相关账户的删除图标。

AppsFlyer和Facebook之间的衡量和节奏差异

项目 具体内容
应用内事件名称

2021年8月5日之前,面板沿用了Facebook的事件名称,但之后不再使用这些事件名称。

收入模式中的用户转化指标

【2021年8月16日弃用】

在收入模式中,出于收入命名惯例的原因,用户转化(即付费用户)指标不包含通过Facebook广告上报收入的用户数。具体请见上一章节(应用内事件名称)。

数据可用日期

对接后每次同步数据时,AppsFlyer会接收最近7天的Facebook数据。

激活日期

AppsFlyer和Facebook判断激活日期的方式不同,其中需要注意以下几点:

  • iOS SKAN回传中不包含激活实际发生的时间。
  • Facebook将回传数据的接收时间作为激活时间,并根据Facebook中对相关应用设置的时区来界定激活日期。
  • AppsFlyer会根据广告主所设置的用户行为窗口期来推算激活时间。此计算方法不考虑应用级别和Facebook Ad账户的时区设置。
数据时效性
  • AF会在UTC时间的01:00从Facebook拉取SKAN数据。
  • 面板和汇总数据会在7小时后更新。

检查ads_read权限

ads_read权限允许Facebook Ads客户通过API拉取广告效果数据,用于自定义面板和数据分析。

请按以下步骤检查您的Facebook Ads账户是否具有ads_read权限:

  1. 登录Facebook开发者账户
  2. 选择一个Facebook App ID。
  3. 进入App Review > Permissions and Features

    FBad_permission.png

  4. 请确认ads_read权限处于ready for use(可用)状态。如果已有该权限,则无需进行其他操作。
  5. 如果没有ads_read权限,您需要按以下步骤申请该权限:
    1. 进入App Review > Requests
    2. 申请ads_admin权限。
    3. 重复上述步骤,直到确认您已获得必要权限为止。

问题排查、数据差异及高频答疑

操作 具体内容

无法连接到Facebook

问题描述

在Facebook后台收到以下报错消息:we can't connect. Check that you're using the correct URL. If the problem continues, contact your partner app for help.(连接失败,请检查您使用的URL是否正确。如果持续出现该问题,请联您的MMP。)

解决方式

在AppsFlyer后台确认是否已打开应用内事件映射,以及是否已将AppsFlyer事件映射到Facebook。(应用内事件映射在上一部分有详细说明)

【指南最近更新日期:2021年4月20日】

事件优先级

问题:如何在Facebook后台设置事件优先级?

答案:您无需在Facebook中设置优先级。因为只有使用Facebook SDK设置CV值时才会用到Facebook的优先级设置功能,但由于您是通过AppsFlyer SDK设置的CV,因此不需要使用该选项。AppsFlyer在转化模式中衡量的6个事件是不分优先级的。

【指南最近更新日期:2021年4月20日】

事件次数

问:为什么AppsFlyer后台显示的事件发生次数高于Facebo后台的数据?

答:Facebook仅统计0-1的事件发生次数。因此即使您界定了更高的事件发生次数范围,Facebook也不会记录超过1的事件发生次数,只有AppsFlyer会记录超出的部分仅。

“Import from partner app“(导入MMP的CV映射构架)不可用

ImportFromPartnerApp.png

问题描述

Facebook后台的Import from partner app(导入MMP的CV映射构架)不可用应用没有通过MMP SDK向Facebook发送任何事件。

解决方式

请执行以下任一操作:

  • 尽快通过MMP SDK向Facebook发送事件。
  • 通过Facebook SDK或App Events API向Facebook发送事件,并从其他两个模式中任选一个来设置转化值映射构架。

在Facebook首次记录到事件后,你就可以配置Facebook与AppsFlyer的对接。

【指南最近更新日期:2021年4月25日】

范围之间不能重叠或跳数

问题描述

在AppsFlyer的SKAN自定义衡量模式下,在Facebook中导入CV映射构架时界面显示以下消息:Ranges can't overlap and must be in consecutive order.(范围之间不能重叠或跳数。)

解决方式

自定义CV映射构架中的收入值必须设置为连续递增。

【指南最近更新日期:2021年4月26日】

向Facebook发送事件

问题:对于CV衡量选项中未选择的事件,是否有必要向Facebook发送事件回传?

答案:发送授权用户的所有事件有助于Facebook优化投放。

将多个事件映射到同一个Facebook事件

问题:是否能将多个应用内事件映射到同一个Facebook事件?

答案:多个事件同时映射到同一个Facebook标准事件时,由于Facebook无法区分这些事件,因此会对其中一个他们能够辨识的事件来进行优化。

面板未显示Facebook数据

问题描述

在SKAN对接选项卡中,出现failed to pull data(无法拉取数据)的报错消息。

FacebookSKAdIntegration.png

解决方式

请确认关联账户是否是具有ads_read权限的Facebook管理员账户或广告主账户。

投放iOS广告时Facebook后台报错

问题描述

背景情况:

  • 投放iOS 14广告时Facebook后台报错
  • 最近在App Store上架了新应用或面向儿童的应用

出现这种情况是因为Facebook不知道您使用的SDK适用于SKAN(也就是AppsFlyer SDK)。

解决方式

  1. 在AppsFlyer后台,前往配置>对接渠道
  2. 选择Facebook
  3. 进入对接选项卡。
  4. 关闭激活渠道开关。
  5. 点击保存对接
  6. 等待15秒。
  7. 打开激活渠道开关。
  8. 点击保存对接
  9. 等待Facebook接收到信号,最长需要24小时。

由Facebook上报的收入

【最近更新日期:2021年7月12日】

Facebook通过您的SKAN设置根据CV值推算出收入数据。但这不是通过计算公式直接得出的,而是通过Facebook的算法判定的。

因此即使您设置的收入衡量单位是整数,上报的收入数据中也会出现带小数点的值。

激活与redownloads(重新安装)

【最近更新日期:2021年11月30日】

  • Facebook向AF发送用户回传数据时,不会区分哪些是首次安装的用户,哪些是重新安装的用户,因此激活指标会比实际偏高。
  • 从iOS 15开始,您可以让系统直接向AppsFlyer发送回传数据备份。AF会将这些数据作为原始数据提供给广告主,用来计算激活和重新安装的数量。

回溯性数据补充

【最近更新日期:2021年12月23日】

有时AF会因为登录失败等情况而无法连接到Facebook并获取数据。遇到这种情况时您不需要担心,因为AF会在下次登录成功时自动补全前7天的数据缺漏。

AppsFlyer面板上显示的激活/事件/收入远高于Facebook

通常出现这样的数据差异是因为Facebook面板默认只显示点击型激活或事件,而AppsFlyer面板则同时显示点击型和浏览型激活及事件。

代理对接

如果代理商在广告主的Facebook Ads账户中具有管理员用户的身份,那么他们可以直接代表广告主完成本文所述的SKAN互通操作。广告主也无需登录到其Facebook Ads账户,广告主账户会对代理登录进行标记。

CV更新后Facebook后台未显示

在SKAN转化值操作台中添加、更改或删除转化值(CV)时,请确保相关事件已映射到应用内事件回传。否则Facebook无法呈现CV值的更新。

AppsFlyer和Facebook Ads Manager中的模型推算数据差异

AppsFlyer模型可以推算出基础SKAN归因无法提供的汇总数据。了解详情

由于AppsFlyer仅取用已确认的、中立的数据,因此AF模型不使用Facebook模型推算出来的数据。所以Facebook Ads Manager的报告和AppsFlyer的报告之间可能会有数据和颗粒度的差异。