Master API - 自定义集成报告API - Customizable Aggregated Data API

AppsFlyer新自定义集成报告API可以根据您自己的需求创建报告,无论您需要LTV、留存报告还是基于Activity的KPI,都可以自定义加入报告中。除此以外,您还可以对数据进行分组。数据格式为CSV或JSON。

使用该API,创建链接是关键。

API Endpoint

每一次调用Master Report API必须将以下endpoint作为开始:

https://hq.appsflyer.com/export/[app_id]/master_report/v4?

(数据默认形式为CSV。如果希望收取JSON格式,请使用:&format=json)

其他参数

参数

描述

示例

强制? 

api_token

控制页面左侧目录点击API Access,在开启的新页面中即可获取API token 

123510e9-1111-2222-3333-123bd8eeca9f

Yes

from

开始日期

2016-08-02

Yes

to

结束日期

2016-08-08

Yes

groupings

用逗号分开,代表分组依据

groupings=pid,geo

Yes

kpis

以逗号分隔开 

kpis=installs,click, impressions,sessions,retention_day_7

Yes

pid

用于筛选媒体平台名称,以逗号分隔开。支持多选项

pid=organic, applovin_int

No

c

用于筛选活动名称,以逗号分隔开。支持多选项

c=my_sample_campaign

No

af_prt

用于筛选代理商名称,以逗号分隔开。支持多选项

af_prt=moburst

No

af_channel

用于筛选渠道名称,以逗号分隔开。支持多选项

af_channel=Instagram

No

af_siteid

用于筛选publisher id名称,以逗号分隔开。支持多选项

af_siteid=12345678

No

geo

用于筛选国家名称,以逗号分隔开。支持多选项

geo=US,DE

No

 

分组项

您可以根据以下维度进行分组,以更加精准高效地分析数据。

维度

LTV KPIs 

Retention KPIs 

Activity KPIs 

pid

Yes

Yes

Yes

af_prt

Yes

No

Yes

c

Yes

Yes

Yes

af_adset

Yes

Yes

Yes

af_ad

Yes

No

Yes

af_channel

Yes

No

Yes

af_siteid

Yes

Yes

Yes

af_keywords

Yes

No

Yes

is_primary

Yes

No

Yes

af_c_id

Yes

No

Yes

af_adset_id

Yes

No

Yes

af_ad_id

Yes

No

Yes

install_day

Yes

Yes

Yes

attributed_touch_type 

Yes

No

Yes

geo

Yes

Yes

Yes

 

KPI列表

KPI

KPI Family

描述

impressions

LTV

所选时间段内impression数量

clicks

LTV

所选时间段内点击数量

installs

LTV

所选时间段内安装数量

cr

LTV

转换率

sessions

LTV

所选时间段内用户开启应用的session数量

loyal_users

LTV

在所选时间段内进行安装的忠实用户

loyal_users_rate

LTV

忠实用户 / 安装

cost

LTV

所选时间段内总花费

revenue

LTV

在所选时间断内安装的用户到目前为止带来的收益

roi

LTV

一段时间内的投资回收率

arpu_ltv

LTV

在所选时间段内安装的用户中每个用户带来的平均收益

average_ecpi

LTV

一段时间内每个安装的实际成本(eCPI)

uninstalls

LTV

所选时间段内安装的用户的卸载数量

uninstalls_rate

LTV

卸载率

event_counter_[event%20name]

LTV

选时间段内安装的用户带来的应用内事件数量

unique_users_[event%20name]

LTV

执行该应用内事件的用户数量

sales_in_usd_[event%20name]

LTV

作为应用内事件一部分的收益值

retention_day_[x]

Retention 

在X日的留存

retention_rate_day_[x]

Retention

在X日的留存除以在所选时间段内安装的用户总量

activity_average_dau

Activity

所选时间段内平均日活(DAU)

activity_sessions

Activity

所选时间段内的Session数量

activity_revenue

Activity

所选时间段内所报的收益值

activity_event_counter_[event%20name] 

Activity

所选时间段内的应用内事件发生的次数

activity_sales_in_usd_[event%20name]

Activity

在所选时间段内,作为应用内事件中一部分的收益值

示例

https://hq.appsflyer.com/export/[app_id]/master_report/v4?api_token=[api_token]&from=2016-08-02&to=2016-08-08&groupings=pid&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,retention_day_1,retention_day_2,retention_day_3,retention_day_4,retention_day_5 

https://hq.appsflyer.com/export/[app_id]//master_report/v4?api_token=[api_token]&from=2016-08-02&to=2016-08-08&groupings=pid&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,retention_day_1,retention_rate_day_1,retention_day_2,retention_rate_day_2,retention_day_3,retention_rate_day_3,retention_day_4,retention_rate_day_4,retention_day_5,retention_rate_day_5

https://hq.appsflyer.com/export/[app_id]//master_report/v4?api_token=[api_token]&from=2016-08-02&to=2016-08-08&groupings=pid,geo&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,ctr,cr,retention_day_1,retention_rate_day_1&pid=organic,facebook&geo=US,PR

注意:

  • Facebook和Google相关的花费、点击和impressions当前不支持。
  • 特殊分组只适用于LTV KPIs, Activity或Retention KPI. 当某一KPI不适用时,API将返还N/A。例如自定义retention_rate_day_7 并按照af_channel分组,您将得到“N/A”。
  • 数据基于GMT。
  • Master API Report不对代理商和媒体平台开放。
  • Data更新: 我们每天会对数据进行集成,前一天的数据12个小时后更新。
  • 最多行数: 200K
这篇文章有帮助吗?
1 人中有 1 人觉得有帮助