AppsFlyer与Meta ads的SKAN互通指南

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

SKAN互通:AppsFlyer <-> Meta ads

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

AppsFlyer与Meta ads的SKAN互通作用范围

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

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

其他注意事项: 

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

注意事项

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

Meta ads中的应用激活广告配置指南

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

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

互通设置流程

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

对于应用激活归因:

让Meta ads将SKAN数据共享给AppsFlyer

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

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

请按以下步骤为Meta ads开通与AppsFlyer的SKAN数据共享:

  1. 从AppsFlyer后台进入协作 > 活跃对接
  2. 搜索并选择Meta ads。
  3. 进入SKAN标签页。

    skan_repprtiing_-_connected_accounts.png

  4. 点击f login。您必须使用具备以下权限的管理员或广告主账户登录:
  5. 请按照用户界面的说明进行操作。
    Meta会生成一个access token(访问密钥),用于开放与AppsFlyer的数据共享。完成相关流程后,您会跳转到AppsFlyer。 
  6. 如果这是您首次设置该渠道的对接,请确认账户状态显示为Waiting for sync(等待同步)。
    在AF成功从Meta ads获取数据之前都会显示这一状态。
  7. 等到第二天的UTC时间02:00之后查看授权状态,并确认状态已变为Data was pulled successfully(数据拉取成功)。
    SKAN控制面板中的数据会在每天UTC时间08:00前更新。
  8. 关于可能存在的衡量差异,请参阅本文中的相关部分。 

对于应用内事件归因:

与Meta ads分享CV值映射构架

SKAdNetwork-Facebook-AppsFlyer_integration__5_.png

AppsFlyer与Meta ads的SKAN互通启用方式

步骤 操作 说明 

1

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

2

检查SKAN设置 

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

请按以下方式查看SKAN设置

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

3

应用内事件映射

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

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

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

       注意

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

      应用内事件映射指南

      衡量选项 映射条件
      自定义

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

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

      SendValueandRevenue.png

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

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

      收入

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

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

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

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

    meta_ads_skan_configuration_mmp_url.png

4

将AppsFlyer连接到Meta ads
  1. 在Meta ads后台打开events manager(事件管理器),然后 进入Settings(设置)选项卡。 

    FacebookSkadNetworkSetup.jpg

  2. 点击“Settings”选项卡中的Configure events(配置事件)。

    mceclip0.jpg

  3. 在Events Manager中选择Import from Partner App(导入MMP的CV映射构架) 。 

    mceclip1.png

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

说明

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

5

iOS 14投放设置

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

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

FBiOS14.png

其他相关信息

关闭SKAN对接

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

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

  1. 从AppsFlyer后台进入协作 > 活跃对接
  2. 搜索并选择Meta ads。
  3. 进入SKAN标签页。
  4. 点击相关账户的删除图标。

Meta ads与AppsFlyer之间的衡量方式及时间安排差异

注意事项 说明 
应用内事件名称 

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

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

【2021年8月16日弃用】

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

数据可用日期

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

激活日期 

AppsFlyer和Meta ads判断激活日期的方式不同,考虑:

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

检查ads_read权限

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

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

  1. 登入您的Meta ads开发者账户
  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. 重复上述步骤,直到确认您已获得必要权限为止。

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

操作 说明 

Meta ads无法连接

问题描述

在Meta ads后台收到以下报错消息: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事件映射到Meta ads。(应用内事件映射在上一部分有详细说明) 

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

事件优先级

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

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

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

事件次数

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

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

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

ImportFromPartnerApp.png

问题描述

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

解决方式

此时可完成以下任一操作:

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

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

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

范围之间不能重叠或跳数 

问题描述

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

解决方式

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

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

向Meta ads发送事件

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

解答:对于授权广告跟踪的用户,发送所有事件可提升Meta ads的投放优化能力。

将多个AppsFlyer事件映射到同一个Meta ads事件

问题:是否能将多个AppsFlyer事件映射到同一个Meta ads事件?

解答:多个事件同时映射到同一个Meta ads标准事件时,由于Meta ads无法区分这些事件,因而会仅针对Meta ads能够识别的某一个事件优化投放。

没有可以拉取的数据

问题: 为什么连接状态显示为“No data to pull: Check your Meta data-sharing permissions”(没有可以拉取的数据:请检查您的Meta数据共享权限)?

解答:此时可能尚无SKAN数据,或者您需要通过相关账户中的管理员用户角色登入Meta ads。

问题: 界面提示“没有可以拉取的数据:请检查您的Meta数据共享权限”,但我仍能看到Meta ads的数据,这种情况有问题吗?

解答:区分。界面显示这条报错消息并不代表您的对接有问题,您的数据仍会照常拉取。

面板中未呈现Meta ads数据

问题描述

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

FacebookSKAdIntegration.png

解决方式

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

投放iOS广告时Meta ads后台报错

问题描述

背景情况:

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

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

解决方式

  1. 从AppsFlyer后台进入协作 > 活跃对接
  2. 搜索并选择Meta ads。 
  3. 关闭渠道对接选项卡中的启用该渠道开关。
  4. 点击保存对接
  5. 等待15秒。
  6. 打开激活渠道开关
  7. 点击保存对接
  8. 等待Meta ads接收到信号,最长需要24小时。 

由Meta ads上报的收入

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

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

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

回溯性数据补充

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

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

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

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

代理对接

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

CV更新后Meta As后台未显示

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

AppsFlyer和Meta ads Manager中的模型推算数据差异

AppsFlyer模型可以推算出基础SKAN归因无法提供的汇总数据。详情请见此文档

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