Facebook Ads对接设置指南

从2021年10月29日开始，FB仅对广告主开放汇总数据。也就是说，浏览型和点击型的归因数据在原始数据报告中全都会显示为“restricted”（受限），且不再填充其他与媒体渠道相关的字段。详情请参考原始数据内容限制。

这一限制对所有的广告主、操作系统和MMP都生效，并且会影响到所有iOS和安卓用户的设备层级数据，不论其ATT或个性化广告的授权状态如何。

2021年10月29日之前的原始数据仍然可用。

AppsFlyer会继续接收来自Facebook的设备层级数据，因此AF的归因和报告功能（包括多触点归因、LTV、ROI、群组、留存报告、防作弊、Audience等）不受影响。详情请见汇总及分析报告工具。

如何获取安卓激活的用户层级数据？

虽然用户级别的数据受限，但对于跳转到Google Play Store的安卓应用广告，Facebook Ads会与广告主共享其元数据。在这种情况下，广告主可以在应用中接入Google Install Referrer，然后通过Referrer来查看归因字段。由Referrer提供的字段会填充AppsFlyer原始数据报告，在提交解密密钥且Facebook获得一次激活归因后，您即可查看该报告。这样，AppsFlyer就能对没有广告ID（即启用LAT）的用户进行归因。

由Referrer提供的广告系列归因字段如下：

• 广告ID
• 广告名称
• 广告集ID
• 广告设置名称
• 广告系列活动ID
• Campaign 名称
• 帐户ID
• 渠道

请注意：请确保您使用的AppsFlyer SDK为V5.4.0以上版本，否则eferrer数据可能无法正常发送。Referrer数据的优先级高于来自API的数据，且不受限。该解决方案适用于点击型归因，而非浏览型归因。

Referrer中的数据是由Facebook加密的，可以通过您Facebook开发者账户中的密钥解密。您需要向AppsFlyer提交该密钥，每个应用只需提交一次。

请注意：如果该密钥缺失或被删除，即使在没有上述广告系列归因字段的情况下，AF仍可以根据Referrer将激活归因到Facebook Ads，但需要符合以下条件：

• Facebook Ads未认领该次激活。
• 收到未解码的Facebook Install Referrer。
• 且对应的触点是末次点击。

请按以下步骤从Facebook获取解密密钥：

1. 登录Facebook开发者平台。
2. 点击进入页面右上角的My Apps。
3. 选择需要获取哪个应用的解密密钥。
4. 点击进入页面左侧的Settings > Basic。
   

   

5. 向下滚动到安卓部分，即可在Package Names字段下方看到标记为Install Referrer decryption key的解密密钥。请注意：这部分就是您之前配置包名和Google Play Store的地方。

请按以下步骤在AppsFlyer后台设置解密密钥：

1. 【必须完成】确认您应用中接入的AppsFlyer SDK是V5.4或以上版本。切勿使用之前的版本。
2. 从AF后台进入配置 > 合作伙伴配置。
3. 选择Facebook。
   

   

4. 在对接选项卡中，将密钥粘贴到Install Referrer Decryption Key字段中。每个应用只需提交一次密钥。
5. 点击保存对接。

您可以使用“Facebook成本”获取Facebook的广告系列、广告组、广告素材和流量入口级别的成本数据，以及点击和展示的汇总数据。请参考广告平台成本对接表，详细了解适用的维度、指标及功能。请注意：需要购买Xpend才能获取成本数据。

如何启用成本API：

1. 确保您已登录Facebook帐户，且该帐户已开通Facebook广告账户的广告系列管理权限。此处登录的用户必须具有管理Facebook Business Manager所有广告系列的权限
2. 进入成本选项卡。
3. 打开获取成本、点击和展示数据开关。
4. 点击Facebook登录按钮
5. 弹出消息时，请点击允许AppsFlyer访问您的Facebook广告投放数据。
   请注意：对接后每次同步数据时，AppsFlyer会接收之前7天的Facebook成本数据。

详情请见Facebook对点击和浏览的定义。

如需删除对接的Facebook账户，请将鼠标悬浮在该账户的操作栏并点击删除对接。

成本数据同步状态

您可以在成本（及广告收入）对接状态面板或单独的广告平台控制面板中查看AppsFlyer最近一次获取匹配成本数据的时间以及API状态。

Facebook允许您同步多个帐户以获取成本数据。对于每个已同步的帐户, AppsFlyer 会显示成本集成的状态以及 AppsFlyer 上一次成功提取匹配成本数据的时间。

详情请见如何通过成本、点击和展示数据扩充Facebook信息。

请按以下步骤映射应用内事件：

1. 打开应用内事件回传开关。
   首次为应用 启用Facebook应用内事件映射 ，SDK中的所有 af_XXX 事件都会自动映射到Facebook的预定义事件列表。这种自动映射功能不仅省时省力，还能大幅减少映射误差。
2. 填写以下参数:

   参数名称	说明
   SDK Event Name （SDK事件名称）	事件的名称，即AppsFlyer从SDK处接收到的事件名称或来自S2S事件的名称。 提示-如果在列表中看不到要查看的事件,请确保以非自然方式激活应用，并完成该事件，然后再次检查该事件是否在列表中。您也可以输入事件名称，点击创建自定义然后照常映射。详情请见自定义事件映射。
   Partner Event Identifier（事件标识符）	为您的事件选择最合适的预定义Facebook事件标签。您还可以发送Facebook CUSTOM事件。
   Sending option （发送选项）	选择事件回传的范围： 仅该合作渠道是指仅回传由Facebook Ads带来的用户所产生的事件。 所有媒体渠道，包括自然流量是指向Facebook Ads回传所有用户的事件。
   Send Revenue（发送收入）	不发送值与收入：仅发送事件本身，不发送事件值。 仅发送值：发送除收入值以外的所有参数。 发送值与收入： 发送所有事件参数，包括收入值（若有）。

3. 点击添加事件，在列表中添加SDK事件。

关于事件名称的限制：

• 事件名称的长度限制：2-40个字符
• 不允许使用以下字符：
  • 英文格式的冒号（:)
  • 英文格式的句号（.）
  • 非拉丁（英文）字符集：自2020年1月12日起，Facebook不再接受中文字符。AppsFlyer尚未测试其他字符集，因此您在使用其他字符集之前，请先确认Facebook是否支持回传中出现这些字符。
• 事件名称区分大小写。为避免出现数据差异，请确保所有媒体渠道和应用版本中设置的事件名称大小写完全一致。

详情请见Facebook Ads的应用内事件映射。

AppsFlyer对Facebook的再营销归因允许广告主使用AppsFlyer报告将现有用户的参与度与Facebook广告关联起来，并测量用户的质量，参与度。

建议您仅在针对现有用户投放Facebook广告时才使用该功能。

1. 在应用设置页面打开再营销开关。
2. 进入Facebook Ads渠道页面，打开再互动归因开关。
3. 设置再营销点击归因窗口期。
   再营销归因窗口期规定了用户点击广告后在多长时间内打开应用时，该点击才会被记录为再互动。
   请选择归因窗口期的单位（小时或天），并将滑块滑动到所需值。
4. 设置再互动窗口期。在此期间，用户的应用内事件会归因到再营销渠道（这里的在营销渠道会被记录为主要流量来源，即primary source）。
   这个值可以设置为数天（1-90天）、数小时（至多23小时）甚至是终生。默认值为30天。
   

   

深入了解AppsFlyer再营销归因。

深入了解通过深度链接实现Facebook等SRN上的用户跳转。

CCPA隐私条例规定限制来自美国加州Facebook用户的数据。

如需符合CCPA要求：在对接选项卡中打开限制Facebook使用用户个人信息（CCPA）开关。

详情请见CCPA合规性。

如果您的应用通过Facebook Audience Network Ad Revenue进行广告变现，您就可以使用AppsFlyer记录来自Facebook的收入。无论您的应用是否存在应用内购数据，该方法都可以让您全面了解用户带来的收入。

请按以下步骤启用Facebook Audience Network Ad Revenue的广告收入记录：

1. 在广告收入选项卡中，打开获取广告收入数据开关。
2. 选择您需要的汇总收入数据类型：已归因收入和/或汇总变现收入。
   • 已归因收入：根据用户获取来源记录的收入。
     设置事件来源，选择最符合您的变现模式的应用内事件。例如，如果您的广告收入基于广告展示，则建议向AppsFlyer发送ad_viewed（广告浏览）事件。您可以为每个变现平台分别设置最合适的事件。您也可以使用af_app_opened事件来记录广告收入。这种情况下，广告收入归因给用户的每一次应用打开。
   • 汇总变现收入：根据广告来源记录的收入。
3. 界面会显示广告收入事件。这是一个只读字段，代表名为[source event]_monetized的新增广告收入事件（如上图的Ad_Watched_Monetized）。该广告收入事件会在面板中作为其他事件显示。
4. 点击对接到Facebook，收集Facebook上的Facebook Audience Network广告收入。请使用您的Facebook证书进行登录，以开通Facebook Audience Network Ad Revenue权限。
5. 输入Audience Network App ID（Facebook App ID）。您可以从Facebook Audience Network（FAN）中获取此ID。
   • 获取Facebook App ID。
   • 将该ID复制粘贴到AppsFlyer后台的 Audience Network App ID 字段。
6. 点击保存广告收入。

您可以为Facebook Ads开通某些权限，允许其执行对应的操作并获取对应的数据。

详情请见为对接渠道授权。