广告收入归因指南

概览:通过对广告收入的归因,开发者可以获得所有用户完整的LTV表现。 

mceclip0.png

广告变现收入归因

  • 广告展示在app内的banner、offer walls、插页广告等广告位中,获取广告收益。为了展示广告,app中需要集成变现平台的SDK,即可向用户展示广告并产生变现收益。
  • 广告变现收入、应用内购买和订阅收入,结合起来构成了完整的用户LTV表现。通过将用户的LTV与渠道买量成本进行匹配,可以用来确定所投放广告系列的ROI,并将其用于投放渠道的进一步分析。 

广告收入数据

  • 通过变现平台的服务器API拉取,或通过嵌入应用中的SDK来上报数据。
  • 变现收入会归因给将用户带来的买量渠道。
  • 变现数据报告的颗粒度取决于变现渠道的对接。 
    • 整合颗粒度:变现数据会按照啊国家/地区进行细分,并展示在后台面板和Cohort群组报告中。
    • 用户层级颗粒度:可以将广告的层级细化到曝光层级。您可以通过 广告收入原始数据进一步进行用户价值的分析。
  • 历史数据不会被拉取。

变现收入数据更新

  • 每天UTC时间14点拉取前一天的广告变现收入。 如以下示例中所述,在第二天的16:00可以看到数据: 
    • An ad displays on Day 0. The data is pulled from the ad networks on Day 1 at 14:00 UTC. Processing begins Day 2 (midnight) 00:01 UTC. The data is available in the Dashboard on Day 2 from 16:00 UTC, and in Data Locker from 6:00 UTC. 
    • Data is reported under Day 0 (the day the ad displays). In Data Locker, it is reported in the Day 0 H=23 folder.

广告收益展示时间轴

Ad_revenue_display_timeline_3_en-us.jpg

用户层级颗粒度 vs. 整合层级颗粒度

广告收入归因支持不同的颗粒度层级,颗粒度取决于变现平台。

  • 汇总颗粒度
    • AppsFlyer按照国家/地区获取每日的变现数据。
    • 有效每操作收入(eRPA)是通过将收入除以实际触发事件数得出的。
    • 触发事件是应用打开或应用中设置的特定应用内事件。
  • 用户层级 (又称展示层级颗粒度)[推荐]:
    • 变现平台上报用户的展示层级变现收益。 不是所有的变现平台都支持用户层级颗粒度的对接。 
    • 变现收入归因给带来用户的媒体渠道。意味着AppsFlyer变现收入归因遵守广告平台的归因原则,包括再营销的归因原则。 
    • 如果您在使用聚合变现平台,请确保在开启用户层级颗粒度的广告收入API之前,关闭聚合下的所有变现渠道的广告收入API。

实现

API广告收入归因工作流程

要实现API广告收入归因,请参考下表中的不同层级颗粒度的步骤。 

广告收入归因流程
步骤 汇总颗粒度 用户层级(展示层级)颗粒度 
1 不适用
2

在应用实现里:

  • 变现平台的SDK
  • AppsFlyer应用内事件

在应用实现里:

  • 集成变现平台的SDK
3 在AppsFlyer上对接该变现聚合平台

对接用户级广告变现平台:

4 生成并归因广告收入 生成并归因广告收入

用应用打开或应用内事件颗粒度汇总

汇总颗粒度实现:

  • 该平台按地域分区上报每日总收入。
  • AppsFlyer的有效每操作收入(eRPA)定义是广告收入除以实际触发事件数。
  • AppsFlyer会给每个触发事件创建一个包含eRPA的 _monetized 事件。例如, ad_matched_monetized
  • 使用归因给媒体渠道的eRPA收入
  • 可以使用下列事件类型:
    • 特有变现事件要求对应用进行相应修改。
    • af_app_open_event 是默认的可用事件,
  • 不要在应用内事件里上报广告收入。这样做会导致面板上的广告收入重复,因为AppsFlyer已经通过集成取得变现平台的广告收入数据。
使用事件汇总广告收入
事件方法 如何实施 注意事项

特有变现事件

  • 在展示广告时设置应用内事件
  • 这提供了不同的用户操作计数,以用于高阶eRPA计算
  • This can be further refined by having a different in-app event for each monetization network doing so enables you to break the revenue down by monetization network
    See the table that follows for a full discussion. 
  • 需要开发人员修改应用
  • 在控制面板上可以按变现平台细分收入

af_app_open事件

  • 默认情况下,af_app_open事件由AppsFlyer SDK发送
  • 由用户的每次活跃(会话)触发 
  • 无需修改应用
  • 快速实施
  • 除非您每次会话仅显示一个应用,否则eRPA值会严重失真
  • 无法按变现平台细分收入
  • 该事件属于所有启动该应用的用户,没有任何信息提示该用户是否愿意观看广告
应用内事件方法的比较
方法 优点 缺点 注意事项
所有平台使用相同事件例如, ad_watched。 这会自动生成包含变现细节的 ad_watched_monetized 事件 最容易实现 没有质量信息,例如每个平台的点击次数和广告收入
  • 如果主要目标是找到最能够使用户点击广告的渠道/广告系列,则最适合。
  • 不适合比较变现平台的综合表现。

(最佳做法) 给每个平台分配一个唯一的广告观看事件。例如: ad_watch_admob,

ad_watch_vungle

除原始数据外,还可以在面板上比较变现平台的完整可视度和能力。 广告收入不是在一个事件中累积的。事件数等于广告平台数 可在控制面板上比较变现平台。可通过下列方式细分广告收入

用广告收入API获取用户级颗粒度

Export_Ad_Revenue.png

用户层级(展示层级)颗粒度对接:

这个方法是最好的。这个方法提供了最大程度的颗粒度,且无需修改应用即可归因广告收入。广告收入被准确归因给获客渠道。

用户层级变现数据:归因信息包括在 原始数据中。我们暂时不会将 用户层级的数据发送postback给媒体合作伙伴。 

来自在AppsFlyer中没有归因记录的用户所产生的变现收益,会被归因为自然量变现收入。例如,在Facebook删除用户层级数据之后,可能会发生这种情况。 

注意

如果您已经启用了聚合变现平台的用户层级广告收入API,则必须禁用聚合下的其它变现平台的广告收入API。

用户级别的颗粒度(最佳做法)
方法 如何实施 注意事项

用广告收入API的用户级数据

  • 配置面板的已对接合作伙伴参数。注意:无需实施应用内事件。
  • 数据在面板上显示为 af_ad_revenue 事件
不适用

 

从汇总颗粒度到用户级颗粒度迁移说明

  • 迁移不会影响广告收入历史数据。该数据保持不变。
  • 用户级颗粒度不需要应用内事件。您可以继续发送这些事件,它们不会影响AppsFlyer的用户级颗粒度报告。
  • 广告收入数据每天拉取一次,拉取时间为UTC时间14点,颗粒度为当时选择的颗粒度。
  • 如果已经实施了触发广告浏览的应用内事件,则这些设定会继续执行。它们不影响用户级别颗粒度的操作。

对接广告收入的合作伙伴

AdRevenueAPI_us-en.jpg

开始之前

  • 准备好可以发布广告的app。 
  • 要求广告收入合作伙伴给您提供API证书。
  • 如果要对接变现聚合平台的用户级广告收入数据,请先禁用通过该平台聚合下的变现平台对接。

要启用变现平台的对接:

  1. In Appsflyer, go to Configuration > Integrated Partners.
    The Integrated Partner window opens. 
  2. Select a partner. Tip: Select Active and Ad revenue to display your existing partners having Ad revenue capabilities. 
    The integrated partner's configuration window opens.
  3. 广告收入 标签,启用 获取广告收入数据。
    显示API证书字段。
  4. 有些合作伙伴同时支持用户层级颗粒度和整合颗粒度请选择其一。 
  5. 填写已对接合作伙伴提供的API证书。
  6. 如果您选择整合层级颗粒度 请选择一个触发广告变现的代表性应用内事件。这个事件通常在每次曝光发送。例如,ad watched或者video watches。 
  7. 点击 保存广告收入
  8. 如果 测试连接 按钮有显示,如图所示, 请点击 测试连接:
  9. 如果没有测试连接 的按钮,则说明您已经完成对接步骤。 

广告变现API的状态与测试

  • API状态信息提供了有关广告收入API的详细操作信息。查看状态消息列表。 
  • 一些合作伙伴允许测试广告变现API的连接状态。如果可用, 测试连接 的按钮将会显示。 mceclip0.png
  • 验证API连接是否正常运行:
    • 点击 测试连接 
      显示消息API密钥已验证如果不是这种情况,请遵循以下列表中信息指南进行修正。 
状态 含义 备注/需采取的行动
API密钥已验证  无
无效证书

一个或一个以上的证书是错误的

从变现合作伙伴那里获取到正确的证书
缺少配置的详细信息 一个或多个证书字段不完整 在变现合作伙伴的后台获取证书,或与变现平台联系并渠道证书。 
广告收入API连接状态

对接变现聚合平台

应用所有者可以直接或通过变现聚合平台与一个或多个变现平台合作,例如:IronSource,Admob,DoubleClick(DFP)等。

如果在应用中接入变现聚合平台SDK,则可能导致重复上报收入。为避免重复,请使用以下流程图甄选合适的变现平台或聚合平台对接方式。

AppsFlyer要求这些平台进行对接以便记录广告变现。您可以查看所使用的广告变现平台是否已经与AppsFlyer对接。

广告收入数据

变现数据在后台的展示

广告收入展示了不同渠道获取到的用户持续的表现和质量。随着用户不断打开应用并与广告互动,用户LTV会持续增加。  

可通过下列方式查看广告收入:

  • LTV维度:
    • 面板展示:数据总览、事件报告
    • Cohort群组分析
    • Master API
  • 活跃维度:
    • 面板展示:活跃数据报告
    • 广告收入原始数据

数据总览面板-综合表现报告

数据总览面板:

  • 含有收入的值都是LTV值,详情请查看LTV与活跃数据
  • 收入 列包含所有收入,包括广告收入和应用内购买
  • 深入到广告层级(媒体渠道、广告系列、广告集、地理位置)查看报告中的 变现 事件。
事件报告面板

活跃度面板:

  • 含有收入的值是基于活跃数据的。详情请查看LTV与活跃数据
  •  用户平均操作次数 显示了用户与app中所展示广告的互动趋势。 

示例

三名用户于2017年12月31日安装了一个应用。他们的归因如下:

  • 用户A:广告平台A
  • 用户B:广告平台B
  • 用户C:自然用户

这个app集成了5个不同的变现平台。每个变现平台通过AppsFlyer的SDK使用一个独立的应用内事件,如下:

  • Facebook受众平台:fb_ad_view
  • Chartboost:chartboost_ad_view
  • Admob: admob_ad_view
  • Applovin: applovin_ad_view
  • IronSource: is_ad_view

安装四天后,将向用户显示广告,如下所示:

用户

拉新平台

fb_
ad_view

chartboost_
ad_view

admob_
ad_view

applovin_
ad_view

is_ad_view

总计

A

广告平台 A

2017-12-31

2018-01-01

$1

2018-01-02

$1

2018-01-02

$1

2018-01-04

$1

 

$4
 B

广告平台 B

2017-12-31

2018-01-02

$1

 

2018-01-04

$1

 

  $2
 C

自然

2017-12-31

2018-01-01

$1

     

2018-01-02

$1

$2

从这些数据中可以总结出每个用户,每天(每个应用内事件)所带来的广告收益:

用户生命周期价值(LTV)

用户

2018-01-01

2018-01-02

2018-01-03

2018-01-04

用户生命周期总价值

A

$1

$1

$1

$1

$4

B   $1   $1 $2
C $1 $1     $2
总计 $2 $3 $1 $2 $8

关于报告:

如前所述,广告收入与用户LTV相关。因此,您在面板上选择的时间段表示这段时间内安装的用户从安装之日到此时此刻为止的累积收入。让我们选两个不同的时段来理解一下这个报告:

汇总报告:选择日期为2017-12-31至2018-01-05

广告平台

LTV收入

自然

$2

广告平台 A

$4

广告平台 B

$2

广告平台C

$2

在这种情况下,群组的用户是从2017-12-31到2018-01-05期间激活app的用户。这些用户产生的所有收入都将归因给用户拉新渠道,显示为用户的LTV。

广告收入原始数据

PremiumFeature.jpg

广告收入原始数据包括由与AppsFlyer完成用户层级颗粒度对接的变现平台提供的数据。 

广告收入原始数据的原则

  • 数据是基于每个用户的唯一曝光数来汇总的。唯一曝光数是来自广告变现平台、广告单元和广告位的组合。 
  • 原始数据更新与活跃数据报告中的用户层级广告收入一致。
报告

Export
data page

Pull API Data Locker
归因广告收入(非自然)
自然广告收入
再营销广告收入 
 

数据特征和字段

广告收入报告中的填充字段:

  • 按照广告收入事件及下列列表中列出,这些字段分为:
    • 特定字段:广告收入的特定字段。例如,曝光次数和广告位注意!这些字段会因不同的变现平台而异,在下列广告平台列表中有详细列出。
    • 内容字段: 与其他原始数据具有相似含义的字段。例如,事件名称,事件值,货币。 
  • 变现的广告收入事件归因给将用户带来的媒体渠道,意味着这些字段来自将用户带来的转化事件,例如,媒体来源和广告系列,这些字段在下列列表中未详细列出。 
广告收入填充字段
api_name 字段名称 字段类型 描述
event_time 事件时间 Context 变现收入归因到的日期
event_name eventName Context 一律设定为 af_ad_revenue
event_revenue 事件收入货币 Context
  •  revenue currency事件的收入金额。 
  • 零值表示没有收入的曝光  
event_revenue_currency Event Currency Context 事件收入货币
 event_revenue_XXX 事件收入XXX Context
  • 在导出页面中:收入已经转化为应用在后台设定好的货币 
  • 在Data Locker中始终为USD
  • Pull API根据选择的货币来展示收入。 
国家 国家

Context

激活转化的国家/地区
ad_unit

 广告单元

特定字段

广告类型

Segment Segment 特定字段 广告位置名称
monetization_network 变现平台 特定字段 发送广告的广告平台
展示 展示 特定字段 用户看到广告的次数
mediation_network 聚合平台 特定字段 将事件发送给AppsFlyer的聚合变现平台
广告平台提供字段
显示名称 MoPub Ironsource AppLovin MAX Appodeal Fyber
广告单元
Segment - (1) - - -
广告植入
变现平台 - -
展示 - -
聚合平台 -
(1)广告主需要在ironSource中进行配置

常见问题解答

如何获得每个平台的广告总收入?

  • 广告收入归因给拉新渠道并展示在该渠道下。
  • 这提供了ROI和其他KPI的LTV视图。
  • 要查看变现总收入,请为每个平台设置一个不同的应用内事件,并使用以下流程:
    1. 转到数据总览面板的 综合表现报告表。
    2. 最多可以选择4个 monetized 事件,这些事件代表您要查询的平台。

      selecting_monetized_events.png

    3. 单击 导出CSV 下载报告。

    4. 收入这一栏请求到的各平台的收入事件加总

      revenue_sum_up.png

    请注意,这个加总的广告收入是LTV数据。也就是说这里的收入是在指定日期范围内安装的app的新增用户,通过您的变现渠道所产生的全部收入。

在活跃数据报告中是否展示广告收入?

是的!

活跃数据报告中的收入是应用内购买事件和广告收入的总收益。请注意 广告收入数据每天在事件发生的第二天发送给AppsFlyer。

需要在对接选项卡中激活该合作伙伴吗?

  • 如果该合作伙伴仅用于广告变现,则无需在对接选项卡中激活该合作伙伴
  • 只需打开广告收入选项卡的获取广告收入开关。

如果用户的app版本是未集成AppsFlyer的SDK的,那么用户层级变现收益将如何归因?

  • 广告收入会归因为自然量收入。

特性与局限性

广告收入的特征和局限性
特征 是  / 否 x 备注
广告平台访问群组报告  x  
代理访问权限  x 代理目前无法访问变现收入的配置。
代理数据透明化  x  
应用设定的时区 广告后入的原始数据的时间戳为世界标准时间UTC 00:00。 
应用设定的货币  
限制

广告收入事件目前不适用于:

  • 应用内事件回传 
  • Push API
  • 再营销面板

用户层级颗粒度的限制:

自然用户数据  
非自然用户数据  
数据新鲜度    
历史数据 当天数据会被拉取
团队成员访问  

已对接广告收入的合作伙伴列表

合作伙伴 标识 需要凭证参数 数据颗粒度

AdColony

  • API密钥
  • App ID
带有地理位置信息的汇总等级

AppLovin

  • 报告密钥
  • App包名
带有地理位置信息的汇总等级

AppLovin MAX

  • 报告密钥
  • App包名
 
 带有地址位置的用户层级数据

Appodeal

  • Application key
  • API密钥
  • 用户ID
带有地理位置的用户层级数据
Bytedance Ads - 中国本地流量c 
  • 安全密钥
  • App ID
  • 帐户ID
带有地理位置信息的汇总等级
Chartboost
  • 用户ID
  • 用户签名
  • App ID
带有地理位置信息的汇总等级
Facebook Facebook_Audience_Network.png
  • 登录Facebook
带有地理位置信息的汇总等级
Fyber The Fyber's logo
  • Client secret
  • API ID
  • Client ID

 带有位置的用户层级数据

Google 营销平台 -DV360/CM (DoubleClick)
  • 登录到Google 营销平台 -DV360/CM
带有地理位置信息的汇总等级
Google Admob
  • AdMob app ID
带有地理位置信息的汇总等级
Google Ads
  • 通过OAuth进行API验证
带有地理位置信息的汇总等级
Ironsource
  • 密钥
  • 用户名
  • App ID
  • 带有地理位置信息的汇总等级
  • 用户层级

Mintegral

mintegral.png
  • App ID
  • 密钥
  • API密钥 
带有地理位置信息的汇总等级

MoPub

mopub.png
  • API密钥
  • 库存报告ID
  • App ID

TikTok for Business

  • 安全密钥
  • App ID
  • 帐户ID

带有地理位置信息的汇总等级

 

Unity Ads

  • API密钥
  • App ID
带有地理位置信息的汇总等级
Voodoo广告  voodoo.png
  •  Bundle ID
  • 访问密钥
带有地理位置信息的汇总等级

Vungle

Vungle_logo.png
  • API密钥
  • App ID
带有地理位置信息的汇总等级

 

这篇文章有帮助吗?