应用内事件回传配置

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

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

选择要回传的应用内事件

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

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

应用内事件回传窗口期

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

举例来说,假设您使用的广告平台按用户激活后15天内的事件收取费用,那么您可以按下图所示方式来配置这个窗口期:

15天的应用内事件回传窗口期

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

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

1月1日

窗口期设为15天。

用户激活应用。

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

用户完成一个购买事件。

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

1月15日

窗口期更改为20天。

1月18日

用户再次完成购买事件。

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

默认设置

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

如果您的回传是近期设置的,则窗口期默认为180天。

回传窗口期配置权限

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

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

事件映射

应用代码中对某类事件的称法因广告主而异,而且广告主与渠道的事件命名方式也不尽相同。例如,对于通过应用购买商品这样的用户行为,有的广告主称之为“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_revenue和af_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: N/A
    • monetary: N/A
    • currency: N/A
  • 仅发送值

    • event_value: {af_revenue: N/A, af_currency: N/A, af_level=2, af_receipt_id=57601333}
    • monetary: N/A
    • currency: N/A
  • 发送值与收入

    • event_value: {af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}
    • monetary: 50.87
    • currency: USD

带条件的应用内事件回传

您可以筛选应用内事件回传,仅将符合条件的事件发送给渠道。筛选条件中可设置的内容包括事件名称、属性和值。这个功能可帮助广告主优化人群细分、个性化和留存。

注意事项

  • AppsFlyer会在下列情况下向相关渠道发送事件:
    • 广告主所设条件中的属性和值都与事件数据相匹配。
    • 广告主未对该事件配置发送条件。
  • 如果所设条件中的属性或值与事件数据不匹配,则AF不会发送该事件。举例来说,假设事件数据为"event_value": "{\"level\":\"5\"}",而条件中的属性为“af_level”,则由于属性与事件数据不匹配(事件数据为“level”,而配置条件为“af_level”),因此AF不发送事件。此外,如果事件数据为"event_value": "{\"level\":\"6\"}",而条件中的值为5,则该值与事件数据不匹配,因此AF也不会发送事件。
  • 您可以为所有渠道配置带条件的应用内事件回传,包括SRN和数据分析平台。
  • 代理也可以配置应用内事件的回传条件。
  • 每个事件最多可配置5个条件,每个条件最多可包含一个属性和一个值。
  • 目前只能使用“等于”逻辑配置条件,如果您为某个事件配置了多个条件,则该事件至少需符合一个条件,才能发送回传。
  • 不支持数组等较为复杂的结构。
  • 建议您在全面启用该功能前先通过测试应用或次要事件进行测试,了解其对投放优化的具体影响。

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

  1. 在合作伙伴配置页中定义并映射所需的应用内事件,以将其发送到相关渠道。
  2. 点击指定事件右侧的添加条件图标。
    In-app_event_postbacks_en-us.png
  3. 在“属性”和“值”字段中输入用于筛选的属性和值。
  4. 点击保存对接

 示例

某广告主正在推广其游戏应用,并希望仅针对已通过第5关的用户优化广告平台X上的投放。为此,该广告主进入广告平台X的配置页,并在应用内事件回传部分中为“level_up”(通关)事件设置条件,属性设为“level”(关卡),值设为“5”。这样,AppsFlyer就会仅向广告平台X发送通过第5关的用户所完成的“level_up”事件。回传中的条件会显示为:"event_value": "{\"level\":\"5\"}"。如果该广告主想要添加更多条件,则需发送以下event_value(事件值):"{\"property1\":\"value1\",\"property2\":\"value2\"}"。

批量编辑事件

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

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

  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

这篇文章有帮助吗?