ROI360中展示层级广告收入的SDK API对接指南

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

概要：广告主可使用AppsFlyer ad revenue SDK API获取广告平台上报的展示级别广告收入数据。

mceclip1__1_.png

通过SDK API上报展示级别的广告收入数据

广告收入的上报方式

广告收入可通过以下两种方式上报到AppsFlyer：1）通过API上报汇总级别的数据，或2）通过SDK上报展示级别的数据。通过SDK上报展示级别数据时：

  • 数据时效性更高，AppsFlyer可更快呈现数据
  • 支持SKAN归因。
  • 适用于已接入AppsFlyer SDK V6.15+的应用。如果您使用早前版本的SDK，则无法使用SDK API，但可以使用SDK connector（数据传输插件）。本文会在相关处提供开发人员专用的说明文档，供您参考。

请注意：

使用SDK API上报广告收入

SDK的作用原理

广告收入的SDK API用于向AppsFlyer SDK发送广告展示收入数据。AppsFlyer会收集并处理这些展示事件，并在本平台中生成广告收入事件af_ad_revenue，这些收入会归因到初始的UA渠道。 

数据呈现方式

af_ad_revenue事件用于识别广告收入，适用于整个AppsFlyer平台，包括面板和其他各种数据传输工具。

适配平台

下列适配的聚合平台和变现平台可通过广告收入SDK API向AppsFlyer发送相关数据：

  • Unity LevelPlay聚合平台（前身为ironSource）
  • Applovin Max
  • Google AdMob
  • Fyber
  • Appodeal
  • Admost 
  • Topon
  • Topon Pte.
  • Tradplus 
  • Yandex
  • Chartboost
  • customMediation：如果您使用的聚合平台不在此列表中，可以使用这个值作为聚合平台名称
  • directMonetizationNetwork：如果相关应用与变现平台直接对接（即不通过聚合平台对接），请使用这个值作为聚合平台名称

数据时效性

SDK API会在发生广告展示时向AppsFlyer平台发送相应的收入数据。 对于购买了ROI360高阶付费套餐的广告主，这些数据的时效性如下：

  • 在Data Locker展示级别的主题下，从1AM开始呈现数据，且每1小时更新一次；
  • 在AppsFlyer的活跃数据和群组报告中，从UTC时间5AM开始呈现数据，且每4小时更新一次。

AppsFlyer ad revenue SDK APII的部署方式

请按以下方式部署AppsFlyer ad revenue SDK API：

  1. 从AppsFlyer面板进入相关渠道的对接页面，启用SDK级别的广告收入对接。请注意：该操作需分应用单独完成。
  2. 让您的开发人员按照相关说明部署AppsFlyer ad revenue SDK API。
  3. 如需在SKAN面板中记录广告收入，请参照SKAN广告收入说明进行操作。

特点与局限性

特点 说明 
Admob
  • 如需启用Admob的iLTV功能（Impression-level Lifetime Value Pingback，可实时发送广告展示的价值），请参照此文档中的说明进行操作。
  • 在安卓和Unity中，Admob iLTV SDK使用微量单位（micro-units）上报展示收入。因此，为了确保AppsFlyer中以美元为单位的广告收入金额正确无误，请先将取自iLTV事件处理机制（handler）的金额除以1百万，然后再将结果发送到AppsFlyer。
广告收入价值 该SDK API不处理收入价值超过10美元（或其他货币的等价金额）的展示事件。
Channel 流量入口维度（Channel）对于第三方商店中的应用不可用（Amazon除外）。