应用内事件回传配置

概要:本文介绍了如何使用应用事件数据来衡量应用互动及用户质量,并优化投放。

广告主可通过应用内事件衡量用户与应用的互动,并比较不同渠道的用户质量,以打造高度契合的拉新策略。广告平台可通过回传获得应用内事件数据,并使用该信息优化投放,或用于CPA结算的广告。详情请见富应用内事件指南

选择要回传的应用内事件

广告主可以使用本文中介绍的设置,指定回传中发送的应用内事件。

本文中所说的应用内事件也包括被拦截的事件,即被Protect360屏蔽的应用内事件,或不符合指定验证规则的事件。

应用内事件回传窗口期

投放CPA广告的广告主可以配置应用内事件回传窗口期,转化发生后过了这个窗口期就不再发送事件回传。

举例来说,假设您为用户激活后15天内发生的事件付费,则窗口期设置如下:

15-day_in_app_event_postback_setting.png

窗口期过后不再发送回传,也不会通知广告平台,但AppsFlyer仍会记录相关事件,并归因到对应的广告平台。

回传总是按照当前的窗口期设置来发送。请参考以下示例:

1月1日

窗口期设为15天。

用户激活应用。

1月2日 窗口期更改到10天。
1月14日

用户完成一个购买事件。

不向广告平台发送该事件的回传,
因为该事件已经不在当前窗口期(10天)的范围内。

1月15日

窗口期更改为20天。

1月18日

用户再次完成购买事件。

向广告平台发送该事件的回传,
因为该事件仍在当前窗口期(20天)的范围内。

默认回传窗口

首次设置应用内事件回传时,窗口期默认为六个月。

 注意

对于2019年7月30日之前开始的应用内事件回传,窗口期默认为“终身”。也就是说,在这种情况下AF总是会向广告平台发送应用内事件回传。

回传窗口期配置权限

以下人员具有窗口期配置权限:

  • 广告主
  • 代理商,前提是广告主事先向其开放配置应用内事件回传权限
    请注意:广告主和代理同时在同一个广告平台上投放时,可各自根据其与广告平台协定的计费方式分开设置单独的回传窗口期。
  • 广告平台,前提是广告主事先向其开放配置应用内事件回传权限

事件映射

应用代码中对某类事件的称法因广告主而异,而且广告主与渠道的事件命名方式也不尽相同。例如,对于通过应用购买商品这样的用户行为,有的广告主称之为“purchase”(购买),有的则是“purchase_event”(购买事件),有的可能以更为晦涩的ID来命名,如“event5”。

在这种情况下,大部分广告平台都需要确保“purchase”跟“event5”所指的是同一个事件,即购买。因此,广告主必须将事件名称映射到每个在投的媒体渠道。

 注意

  • 事件名称区分大小写。为避免出现数据差异,请确保所有媒体渠道和各应用版本中使用的事件名称完全一致。
  • 在具体渠道配置页面的对接选项卡中设置的事件映射对标准回传和SKAN回传都生效。

映射方式

事件映射共有三种方式。

每个广告平台都有自己的事件映射惯例,建议您与其充分沟通。您也可以为广告平台开放权限,让其自行映射事件。广告平台的事件映射请见下一章节

在文本字段中输入事件ID

  • AppsFlyer事件从应用事件的下拉列表中选择一个事件
  • 渠道映射事件:输入渠道侧的对应事件ID。

In-app_event_postbacks_en-us.png

从列表中选择事件ID

广告平台会在AppsFlyer后台预先定义一系列他们想要接收的事件。

  • AppsFlyer事件从应用事件的下拉列表中选择一个事件
  • 渠道映射事件从渠道事件列表中选择与该AppsFlyer事件ID对应的事件

In-app_event_postbacks_en-us.png

按原样发送事件(不映射)

有些广告平台更偏向按原样接收事件,即不做事件映射。这种情况下,事件的命名方式对事件的发送/接收没有任何影响。

在该场景中,您可以选用下列两种方式发送事件:

  • 上报所有事件
  • 手动选择要发送的事件

请注意:上报所有事件时不包含af_app_opened(应用打开)事件、卸载和session数据。

send_postbacsk_as_is_no_mapping.png

如需手动添加事件,请点击添加事件,并选择您要发送的事件。然后重复以上步骤,逐个添加所有需要发送的事件。

send_postbacks_as_is_en-us.png

详情请见对接渠道设置指南中的事件映射部分

回传中的事件来源选项

您可以设置回传到渠道的事件来源,共有以下两个选项:

  • 所有媒体渠道,包括自然流量:回传来自任何渠道的事件,包括自然量。
  • 仅该合作渠道:仅回传来自该渠道的事件

如果您选择“按原样”发送某类事件,则所有事件都会按原样发送。

回传内容

您可以选择回传到渠道的事件数据类型,共有以下三个选项:

  • 不发送值与收入:仅发送不带任何参数的事件本身(即没有值或收入)。
  • 仅发送值:发送收入以外的所有参数。
  • 值和收入 :发送所有事件参数,包括收入(若有)。

回传中的af_revenueaf_currency是跟event_value的JSON分开写入的,分别呈现为monetary(金额)及currency(货币),并且可以单独发送。

请注意:选择不发送值与收入仅发送值时,相关的参数会显示为N/A。

 示例

广告主发送带有以下event_value(事件值)的购买事件:
{af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}

以下是各“回传内容”选项对应的回传参数:
字段名称 event_value monetary currency
不发送值与收入  N/A N/A  N/A
仅发送值 {af_revenue: N/A, af_currency: N/A, af_level=2, af_receipt_id=57601333} N/A  N/A
发送值与收入 {af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333} 50.87 USD

带条件的应用内事件回传

您可以将应用内事件映射到多个渠道,然后使用多重条件筛选这些事件的回传,仅将符合条件的事件发送给相应的渠道,包括SRN和数据分析平台。这一功能主要用于:

  • 优化人群分组、内容个性化以及改善用户留存
  • 避免发送多余数据
  • 保护用户隐私

 示例

某游戏应用的广告主想要优化在某广告平台上投放的广告系列,同时需要使优化范围精确到已通关10级或50级的用户,或应用内购金额达3美金的用户。

in_app_event_condition__1_.png

该广告主应对相关事件及其条件做如下设置:

  • level等于10时,映射到fb_mobile_levle_acheived
  • level等于50时,映射到fb_mobile_levle_acheived
  • cost等于3时,映射到fb_mobile_purchase

请按以下步骤为事件设置发送条件:

  1. 在合作伙伴配置页中定义并映射所需的应用内事件,以将其发送到相关渠道。
  2. 点击指定事件右侧的添加条件图标image.png
  3. 按相关事件值的结构和内容填写条件字段:
    • 参数名称
    • 参数值
    • 满足条件时的渠道映射事件(从映射选项中选择任意一种)
  4. 完成现有条件中的所有字段后,您可以添加其他条件。
  5. 点击保存对接

注意事项

配置条件时,请确保回传给渠道的事件符合以下要求:

条件结构

  • 条件中的参数和参数值必须与事件数据一致
  • 目前只能使用“等于”逻辑来配置条件
  • 不支持数组等较为复杂的结构。

为一个事件配置多个条件

  • 每个事件最多可配5个条件。
  • 事件必须符合至少一个条件,AF才会向渠道发送其回传。
  • AF会按条件显示的顺序一一检查,并按首个匹配条件映射事件。
  • 各个条件的事件映射相互独立。渠道映射事件变为视条件而定(Based on conditions)。
  • 不同条件的参数和参数值不能完全重合。
  • 可以将多个条件映射到同一个事件。

 注意

  • 建议您在全面启用该功能前先通过测试应用或次要事件进行测试,了解其对投放优化的具体影响。
  • 如需查看回传内容,请下载原始数据回传报告。

批量编辑事件

映射事件时,您可以针对多个事件批量编辑事件来源回传内容字段。

请按以下步骤对事件进行批量编辑:

  1. 选择要编辑的事件。
  2. 选择批量操作
  3. 更新设置,使其对所有选定事件生效:
    • 事件来源(二选一)
      • 仅该合作渠道
      • 所有媒体渠道,包括自然流量
    • 回传内容(三选一)
      • 无数据(默认)
      • 仅发送值
      • 发送值与收入

In-app_event_postbacks_en-us.png

自定义事件

可映射的事件列表中仅显示SDK或S2S已经上报过的事件。如果下拉菜单中没有您想要映射的事件,可能是由下列情况造成的:

  • 尚无用户完成该事件。
  • 从最近一次有用户完成该事件到现在已经超过2周。
  • 您的活跃事件列表较长。

如果出现以上任一情况,您可以通过以下方式将相关事件关联到渠道侧对应的事件ID:

  1. 输入事件名称。
  2. 点击创建自定义事件

    In-app_event_postbacks_en-us.png

  3. 将该事件关联到该渠道中对应的事件标识符。
  4. 点击保存,确保将映射设置录入系统。

 注意

  • 在某个渠道下添加自定义条件后,该事件会出现在所有渠道的事件列表中。也就是说,您可以在任何一个渠道的事件下拉菜单中看到这个自定义事件。
  • 另请参阅有关事件名称和参数设置的建议限制

代理和广告平台:

  • 无法添加自定义事件
  • 仅在广告主添加事件并开放相关权限后才能查看和/或映射事件

广告平台的事件映射

广告主也可以为广告平台开放权限,让广告平台自己来完成事件映射并调整回传的使用状态。您可以按以下方式为广告平台开放相关权限:

  1. 合作伙伴配置页中找到您要授权的渠道。
  2. 打开“权限”选项卡中的允许配置应用内事件回传开关。

adnetwork-permissions-postbacks.png

广告平台获得权限后,就能按在文本字段中输入事件ID的方式进行事件映射。

代理的事件映射

向代理开放事件映射权限时后,他们也可以配置应用内事件回传条件。

请按以下步骤向代理开放应用内事件回传的配置权限:

  1. 在合作伙伴配置页中选择相关的代理。
  2. 选择该代理可共享的数据:所有事件或仅归因到指定渠道的事件。
  3. 选择代理的事件收入发送权限。
  4. 选择该代理可共享的具体事件。

agency-events.png