UA渠道的ROI360使用说明

概要:AppsFlyer可通过报告和回传向UA渠道提供完整精确的广告、应用内购买和自动续费数据。渠道可以将这些信息入库,将其用于UA投放的优化。

简介

AppsFlyer会同时从渠道和应用商店(Apple App Store和Google Play Store)接收收入信息,并对这些数据进行一系列处理,包括验证、标准化、归因,并会在其中加入额外的属性和维度,对数据进行扩充。完成这一流程后,AppsFlyer会将扩充并归因后的数据发送给相关的UA渠道,然后UA渠道就可以使用这些信息优化其拉新投放,并改善其为广告主提供的服务。

哪些类型的收入会上报给渠道?

应用侧会产生以下两类收入:

  • 广告变现收入:在相关应用内展示广告(包括横幅、插屏等样式)时就会产生广告收入。不管广告主使用何种投放计费方式,我们都可以计算这部分收入。
  • 应用内购买和自动续费式订阅:用户完成应用内购买或与订阅相关的交易时就会为产生商店收入。

AppsFlyer如何向UA渠道提供收入信息?

AppsFlyer会通过以下方式向渠道提供应用内广告、应用内购买和订阅的收入数据:

  • 广告收入UA Signals报告:该报告会列出汇总到设备级别的广告收入事件,每天更新一次,呈现前一天的数据。您可以通过Data Locker获取该报告。
  • 广告收入回传:客户端设备上每展示一次广告,AppsFlyer就会向相关渠道发送回传,其中包含该广告收入事件的详细信息。
  • 商店收入回传:每产生一次购买或订阅事件,AppsFlyer就会向相关渠道发送回传,其中包含该收入事件的详细信息。

渠道的ROI360设置说明

渠道如需接收UA Signals报告以及广告收入和商店收入回传,请参照本节说明完成相关配置。

ROI360 UA Signals报告的订阅方式

渠道如需开通该报告在Data Locker中的拉取权限,请按以下方式操作:

从AppsFlyer接收ROI360回传的方式

如需接收AppsFlyer的回传,渠道必须先与AppsFlyer渠道对接团队沟通,他们会在AppsFlyer平台中配置ROI应用内收入回传值。

如需联系AppsFlyer的渠道支持团队,请在您的面板中打开帮助菜单,然后选择联系我们的团队

alt

UA平台的ROI UA Signals报告

该报告功能可每天向UA渠道的S3存储桶发送完整且准确的收入记录(CSV/parquet格式),每条记录代表设备层级的汇总广告收入事件。

与广告收入回传不同,UA Signal报告不提供实时数据,但可确保数据的准确性和完整性。这是因为广告展示的收入金额可能会随时间变化,尤其是通过常规CPM竞价而非实时竞价(RTB)产生的展示级别广告收入。

报告数据的来源

报告数据的来源取决于广告主的对接类型,一般分为以下三种:

  1. AdRevenue SDK connector对接:广告主可以将渠道上传的展示级别收入数据共享到客户端设备,然后再以近乎实时的方式上报给AppsFlyer。
  2. 基于S2S API的设备级别对接:广告主可以在AppsFlyer面板的对接渠道部分配置渠道证书,允许ROI360广告收入功能代其收集设备级别的广告收入数据。
  3. 同时结合上述两种方式(即兼顾数据时效性和准确性的F2A)。

    请注意:广告主是否能向AppsFlyer传输数据取决于广告主侧的授权状态及其ROI360高阶套餐的订阅情况。

该报告如何处理数据?

AppsFlyer的ROI360广告收入报告功能会完成下列数据处理工作:

  1. 数据规范化
  2. 将收入归因到带来激活的渠道,并进行数据扩充
  3. 生成广告收入事件
  4. 将事件汇总到设备级别

报告数据的发送方式

AppsFlyer会将设备级别的数据写入Data Locker的报告中,每天写入一次。

报告数据的时效性

数据会在每天UTC时间21:00写入Data Locker存储桶的h=23文件夹中。

报告中的数据字段

字段 备注说明
Version 以秒为单位的Unix时间戳,如:1661315124
app_id AppsFlyer后台显示的App ID
install_time • 激活时间戳:格式为YYYY-MM-DD HH:MM:SSE,如:2020-08-16 11:22:33
• 如果用户使用iOS 14+设备并拒绝在ATT弹窗中授权,或广告主启用了高级隐私保护(Advanced Privacy),则激活时间取整到最近的小时数。
campaign、campaign_id、adset_name、adset_id、ad_name、ad_name、ad_id、site_id 仅当新增激活归因到数据接收渠道时才会填充这些参数值。
idfa、idfv、advertising_id • 若存在多个广告收入变现事件,则同一个设备ID(如IDFA、IDFV或advertiser_id)会在报告中分多行多次出现。
• 如果用户使用iOS 14+设备并拒绝在ATT弹窗中授权,或广告主启用了高级隐私保护(Advanced Privacy),报告中不会显示这些字段。
platform 设备系统:iOS、Android或Windows Mobile
country ISO 3166(alpha-2)中的国家代码,如US、CN
original_url • 如果用户使用iOS 14+设备并拒绝在ATT弹窗中授权,或广告主启用了高级隐私保护(Advanced Privacy),报告中不会显示这些字段。
• 仅当新增激活归因到数据接收渠道时才会填充这些字段。
mediation_network 与展示相关联的聚合平台。请参考此文档了解所有适配平台。
ad_unit 将在2023年Q3上线:与展示相关联的变现广告单元ad_unit
placement 将在2023年Q3上线:与展示相关联的变现广告位

应用内广告收入(IAA)回传

IAA回传是AppsFlyer用来向渠道发送收入信息的一种数据传输方式。IAA回传能够以近乎实时的方式与渠道共享IAA收入数据,而广告收入UA Signal报告的数据共享时间为第X+1天(即事件发生次日),因此在时效性方面,IAA回传要优于广告收入UA Signal报告。

但在准确性方面,实时数据略差于X+1天的数据,具体如下:

  • 与UA Signal报告的X+1天数据相比,IAA实时回传数据的准确性平均会低±5%。
  • 与UA Signal报告的X+1天数据相比,IAA实时回传数据的完整性平均会低±7%。

IAA回传数据的来源

IAA回传的数据来自渠道向客户端设备上传的展示级别数据,上传完毕后AppsFlyer会通过ROI360 Ad Revenue SDK connector接收到该数据。该connector需要由广告主安装到相关设备上。广告主能够通过这个connector上报展示事件,并在其中加入特定的参数,如ILRD(展示级别的收入数据)、货币单位、聚合平台和变现来源等。

广告主的客户端设备是否能向AppsFlyer传输数据取决于广告主侧的授权状态及其ROI360高阶套餐的订阅情况。

IAA回传数据的处理方式

AppsFlyer的ROI360功能会对我们接收到的每条展示级别数据进行以下处理:

  1. 数据标准化。
  2. 将收入归因到带来激活的渠道,并进行数据扩充。
  3. 生成af_ad_revenue事件。

回传数据的发送方式

相关事件会作为一个附加的参数,通过渠道和AppsFlyer之间的现有回传配置发送到渠道。

应用内购买(IAP)回传

ROI360的应用内事件回传会对每个交易进行验证、去重,然后再减去商店抽成和销售税,提供多层次的上报精度。

IAP回传数据的来源

IAP回传的数据来源如下:

  1. 由ROI360 Purchase SDK connector读取到的交易级别数据,每当用户设备上发生应用内购买或自动续费事件即会生成数据。
  2. 所有传入AppsFlyer的App Store和Google Play(RTDN)服务器通知都会按照我们的购买和订阅收入逻辑进行处理:
    • 对于之前已经由SDK connector上报的交易,我们会对与其相关的通知进行验证和处理。
    • 与未知交易相关的通知不会上报到AppsFlyer系统。

    请注意:广告主是否能向AppsFlyer传输数据取决于广告主侧的授权状态及其ROI360高阶套餐的订阅情况。

IAP回传数据的处理方式

AppsFlyer的ROI360功能会对我们接收到的每条交易级别数据进行以下处理:

  1. AppsFlyer会与相关的商店验证购买或订阅,以确保交易信息的真实性。
    • 验证成功后,AppsFlyer会记录该次购买或订阅。
    • 如果收据验证失败,则该事件会显示在被拦截的应用内事件原始数据报告中(需购买Protect360)。
  2. AppsFlyer会对交易进行去重,包括iOS中的家人共享购买,以确保交易数据没有重复
  3. AppsFlyer会根据商店抽成和税费计算净收入数据(真实收入)。
  4. AppsFlyer会针对已验证并处理的交易生成一个内部的购买或生命周期事件

回传数据的发送方式

IAP事件会通过渠道与AppsFlyer之间的现行回传对接发送到渠道。

IAP事件的界定

购买了ROI360的客户可以共享下列含有收入信息的事件:

事件名称

事件名称 说明
af_purchase 用户完成购买时记录该事件
af_purchase_refund 购买交易退款时记录该事件
af_ars_trial_converted 用户在试用期后全价续订时记录该事件
af_ars_subscription_started 折扣或全价的订阅周期开始时记录该事件
af_ars_subscription_resumed 用户停止续订或退款后重新已全价订阅时记录该事件
af_ars_subscription_refunded 向订阅用户退款发出时记录该事件
af_ars_subscription_renewed 订阅自动续费时记录该事件
af_ars_subscription_xgraded 用户订阅的产品发生升级、降级或变更时记录该事件