概要: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中的拉取权限,请按以下方式操作:
- 相关渠道需要在Data Locker中完成以下操作:
- 在渠道账户中设置Data Locker,包括绑定云存储工具并设定报告的格式和内容。
- 启用ROI360 UA Signals报告。
- 广告主需要为渠道开放该报告的权限。
UA平台的ROI UA Signals报告
该报告功能可每天向UA渠道的S3存储桶发送完整且准确的收入记录(CSV/parquet格式),每条记录代表设备层级的汇总广告收入事件。
与广告收入回传不同,UA Signal报告不提供实时数据,但可确保数据的准确性和完整性。这是因为广告展示的收入金额可能会随时间变化,尤其是通过常规CPM竞价而非实时竞价(RTB)产生的展示级别广告收入。
报告数据的来源
报告数据的来源取决于广告主的对接类型,一般分为以下三种:
- AdRevenue SDK connector对接:广告主可以将渠道上传的展示级别收入数据共享到客户端设备,然后再以近乎实时的方式上报给AppsFlyer。
- 基于S2S API的设备级别对接:广告主可以在AppsFlyer面板的对接渠道部分配置渠道证书,允许ROI360广告收入功能代其收集设备级别的广告收入数据。
- 同时结合上述两种方式(即兼顾数据时效性和准确性的F2A)。
请注意:广告主是否能向AppsFlyer传输数据取决于广告主侧的授权状态及其ROI360高阶套餐的订阅情况。
该报告如何处理数据?
AppsFlyer的ROI360广告收入报告功能会完成下列数据处理工作:
- 数据规范化
- 将收入归因到带来激活的渠道,并进行数据扩充
- 生成广告收入事件
- 将事件汇总到设备级别
报告数据的发送方式
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功能会对我们接收到的每条展示级别数据进行以下处理:
- 数据标准化。
- 将收入归因到带来激活的渠道,并进行数据扩充。
- 生成af_ad_revenue事件。
回传数据的发送方式
相关事件会作为一个附加的参数,通过渠道和AppsFlyer之间的现有回传配置发送到渠道。
应用内购买(IAP)回传
ROI360的应用内事件回传会对每个交易进行验证、去重,然后再减去商店抽成和销售税,提供多层次的上报精度。
IAP回传数据的来源
IAP回传的数据来源如下:
- 由ROI360 Purchase SDK connector读取到的交易级别数据,每当用户设备上发生应用内购买或自动续费事件即会生成数据。
- 所有传入AppsFlyer的App Store和Google Play(RTDN)服务器通知都会按照我们的购买和订阅收入逻辑进行处理:
- 对于之前已经由SDK connector上报的交易,我们会对与其相关的通知进行验证和处理。
- 与未知交易相关的通知不会上报到AppsFlyer系统。
请注意:广告主是否能向AppsFlyer传输数据取决于广告主侧的授权状态及其ROI360高阶套餐的订阅情况。
IAP回传数据的处理方式
AppsFlyer的ROI360功能会对我们接收到的每条交易级别数据进行以下处理:
- AppsFlyer会与相关的商店验证购买或订阅,以确保交易信息的真实性。
- 验证成功后,AppsFlyer会记录该次购买或订阅。
- 如果收据验证失败,则该事件会显示在被拦截的应用内事件原始数据报告中(需购买Protect360)。
- AppsFlyer会对交易进行去重,包括iOS中的家人共享购买,以确保交易数据没有重复。
- AppsFlyer会根据商店抽成和税费计算净收入数据(真实收入)。
- 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 | 用户订阅的产品发生升级、降级或变更时记录该事件 |