应用内事件回传配置

推荐用于
营销人员 开发商
最近更新：

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

 相关文档

如需全方位了解如何使用应用内事件，请参考以下文章：

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

选择要回传的应用内事件

广告主可以通过本文所述的回传设置，选择向广告平台发送哪些事件的回传。

 注意

  • 应用内事件也包括被拦截的事件，即被Protect360屏蔽的应用内事件，或不符合指定验证规则的事件。
  • 如果对接选项卡中不存在应用内事件回传部分，说明该渠道尚未在其初步配置中设置AppsFlyer应用内事件记录。有此情况的渠道可以通过渠道支持微件联系AppsFlyer渠道团队，从而完成对接。

应用内事件回传窗口期

投放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”（购买），有的可能以更为晦涩的ID来命名，如“event5”，而渠道可能会称之为“purchase_event”（购买事件）。

因此，您必须对事件名称进行映射，这样才能确保广告主侧的事件能正确地匹配到对应的渠道事件。

 注意

在具体渠道配置页面的对接选项卡中设置的事件映射对标准回传和SKAN回传都生效。

映射方式

应用内事件的映射方式取决于渠道，共有以下三种方式：

您也可以为渠道开通权限，让渠道来完成事件映射。

输入渠道事件ID

  • AppsFlyer事件：从应用事件的下拉列表中选择一个事件。
  • 渠道映射事件：在文本字段中输入与您的应用事件（即AppsFlyer事件）对应的渠道侧事件ID。

 注意

  • 事件名称区分大小写。为避免出现数据差异，请确保所有媒体渠道和应用程序的各个版本中使用的事件名称完全一致。
  • 手动输入的事件名称名称前后可以带下划线，但必须与AppsFlyer发送的事件名称一致。
enter_event_name.png

从列表中选择相关事件ID

  • AppsFlyer事件：从应用事件的下拉列表中选择一个事件。
  • 渠道映射事件：从预定义的渠道事件列表中选择与相关应用事件（即AppsFlyer事件）对应的事件。

In-app_event_postbacks_en-us.png

按原样发送事件（不映射）

有些渠道更偏向接收未映射的应用内事件回传，即相关事件在应用代码中的名称。这个事件可以叫做purchase、acquisition、event5或其他任何名称，事件的命名方式对事件的发送/接收没有任何影响。

您可以选择向相关渠道发送哪些未映射事件：

  • 手动添加：选择具体的事件。
  • 发送所有事件（卸载和session除外）：将您的所有事件都发送给渠道，但这不包括卸载、session（即应用打开）和af_app_opened事件。

 注意

为了防止广告主无意中与第三方分析平台分享过多信息, 我们已从2019年3月起移除了这些平台的发送所有事件（卸载和session除外）选项。在此之前配置的分析平台仍保留此设置选项。

如需手动添加事件，请完成以下操作：

  1. 点击添加事件。
  2. 选择回传方式：
    • AppsFlyer事件：从应用事件的下拉列表中选择一个事件。
    • 事件来源：选择相关事件的发送方式。
    • 回传内容：选择要发送的回传数据。
  3. 然后重复以上步骤，逐个添加所有需要发送的事件。

send_postbacks_as_is_en-us.png

如需发送所有事件，请完成以下操作：

  1. 选择发送所有事件（卸载和session除外）。
  2. 选择回传方式：

send_postbacsk_as_is_no_mapping.png

如需进一步了解事件映射，请参考应用内事件回传说明文档。

回传中的事件来源选项

您可以为每个事件设置回传发送对象（在回传窗口内），共有以下两个选项：

  • 仅该合作渠道：仅回传归因到该渠道的事件，也就是说完成这些事件的用户来自该渠道。
  • 所有媒体渠道，包括自然流量：回传来自任何渠道以及自然量的事件，也就是说完成这些事件的用户来自各个渠道。

回传内容

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

  • 不发送值与收入：仅发送不带任何参数的事件本身（即没有值或收入）。
  • 仅发送值：发送除收入以外的所有参数。
  • 值和收入 ：发送所有事件参数，包括收入（若有）。

收入共享并不是必须配置的内容，但如果您想让广告平台帮助您优化投放并提升投放效果，建议您与其共享收入数据。 请确保仅为事件值中带有af_revenue的事件开放收入共享，否则广告平台会收到收入值为空的事件。

回传中的af_revenue和af_currency是跟event_value的JSON分开写入的，分别呈现为monetary（金额）及currency（货币），并且可以单独发送。回传结构示例：https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

请注意：选择不发送值与收入或仅发送值时，相关的参数会显示为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_currency":"N/A","af_content_id":"1234567",

"af_revenue":"N/A","af_content_type":"category_a"}

&monetary=N/A&content_id=1234567

 N/A  N/A
发送值与收入

"af_currency":"JPY","af_content_id":"1234567",

"af_revenue":200,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

 50.87 USD

带条件的应用内事件回传

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

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

 示例

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

in_app_event_condition__1_.png

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

  • 当level等于10时，映射到fb_mobile_levle_achieved
    或（OR），
  • 当level等于50时，映射到fb_mobile_levle_achieved
    或（OR），
  • 当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已经上报过的事件。如果下拉菜单中没有您想要映射的事件，可能是由下列情况造成的：

  • 尚无用户完成该事件。
  • 该事件的最近一次发生时间是两周前
  • 您的活跃事件较多

如果出现以上任一情况，您可以通过以下方式将相关事件关联到渠道侧对应的事件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