https://hq.appsflyer.com/export/master_report/v4?api_token=api_token &app_id=app_id&from=yyyy-mm-dd&to=yyyy-mm-dd&groupings=groupings&kpis=kpis

调用参数

参数	值	是否必须配置
api_token	需要由管理员获取token。该API token的获取方式为：点击面板右上角的邮箱地址 > API Tokens。	是
app_id	即AppsFlyer后台显示的应用ID。 请将此应用ID复制粘贴到路径中。 对于iOS应用，请添加前缀id 如需查询所有应用的数据，请使用app_id=all	是
from	用于指定日期范围中的起始日期（LTV维度） 格式：yyyy-mm-dd 示例：from: 2020-01-02	是
to	用于指定日期范围中的截止日期（LTV维度） 可用的日期范围天数：1-31天 拉取单天数据：from和to须设为同一个值。 格式：yyyy-mm-dd 示例：from: 2021-01-01, to: 2021-01-31即为31天的数据。	是
groupings	用于将数据按参数分组，以逗号区隔。可用参数请见下一节中的分组维度表。 示例：groupings=pid,geo	是
kpis	用于配置您想要拉取的KPI，各KPI之间以逗号区隔。可用的KPI列表请见后文表格。 示例：kpis=installs,clicks, impressions,sessions,retention_day_7	是
filters	您可以使用一个或多个筛选条件来筛选数据。	否
currency	如需按应用配置中的指定货币拉取数据，请将该参数设置为currency=preferred	否
timezone	如需按应用配置中的指定时区拉取数据，请将该参数设置为timezone=preferred。详情请见数据本地化规则。	否
format	默认情况下，该API会以CSV格式返回数据。如果您想要获取JSON格式的数据，请在URI中添加参数&format=json	否

您可以使用以下维度对收集到的数据进行分组，以便更快捷准确地分析相关信息。这些字段的详细说明请见此文档。

KPI即用于说明应用使用情况的指标。您可以使用下表所列维度对KPI进行分组。

推算KPI

除上文所述的KPI之外，您也可以在Master API报告中添加推算KPI，这样您就能在Master API报告中配置自定义的推算报告。

您可以在KPI计算公式中添加各种预定义KPI，数量不限。

Master API支持标准的算术运算符，包括转码为%2b的加号（+）、减号（-）、乘号（*）和转码为%2f的除号（/）。

推算KPI的字段名称必须以“calculated_kpi_”开头，后接任意有效字符串，如“calculated_kpi_purchaserate”。

kpis=installs,loyal_users_rate&calculated_kpi_3days_retention=
retention_day_1%2Bretention_day_2%2Bretention_day_3

kpis=installs&calculated_kpi_rev_per_impression=revenue%2Fimpression

kpis=installs,roi,arpu_ltv,cost,revenue&calculated_kpi_roi_day_7=
(cohort_day_7_total_revenue_per_user-average_ecpi)%2Faverage_ecpi

Master API中的时间范围可精确到天。

To和From为时间范围字段，用于界定数据拉取的时间段。

本地货币和应用层级指定时区是在AF后台的应用配置页中设置的。Master API数据可以使用系统默认货币和时区拉取数据，也可以按应用层级的指定货币和时区拉取。

数据本地化遵循以下规则：

• 如需按应用层级的指定时区/货币来拉取数据，请确保所有应用都配置了相同的时区/货币，否则只能按UTC和USD来拉取数据。时区和货币是分开设置的，也就是说，如果您为所有应用配置了相同的货币和不同的时区，那么您可以用指定货币来拉取数据，但不能用指定时区拉取。
• 如果您在选定时间范围内更改了面板应用配置中的时区，则报告会呈现最近一次时区更改后的相关值。

您可以使用以下参数来选择应用层级设置。注意：如果您不使用应用层级设置参数，则会拉取到以USD为货币、以UTC为时区的数据。

如需使用Master API拉取指定时区的数据，必须使用timezone=preferred参数。

对比Facebook广告的投放效果：

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&pid=facebook
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&pid=googleadwords_int
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=geo,pid,c&kpis=
installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,
roi&geo=us,ca	

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_keywords
&kpis=roi,arpu_ltv,average_ecpi,installs,loyal_users_rate,cost,revenue

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=af_prt,pid,c&kpis=installs,
loyal_users_rate

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_siteid&pid=affiliates
&kpis=installs,loyal_users_rate,arpu_ltv,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_30,retention_rate_day_30

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=attributed_touch_type
&kpis=installs,sessions,loyal_users_rate,arpu_ltv

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=pid,c
&kpis=installs,loyal_users_rate,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_22,retention_rate_day_22,retention_day_30,retention_rate_day_30

• 成本数据：
  • 不同成本维度的可用性（即广告组、广告素材、地理位置、流量入口和子渠道）取决于具体的广告平台。
  • 如需拉取eCPI数据，请在URL中同时加入激活和成本参数。
  • 总体而言，无论您查询的是什么维度的数据，所有流量来源，包括自有媒体（只要您使用带成本参数的AppsFlyer链接进行投放），都能全面支持成本数据。部分自归因平台会使用他们自己的API，这类API通常仅支持某些特定维度的成本数据。比如Facebook不支持在一次调用中同时按地理位置和流量入口分组，但可以分两次单独调用这两个维度的数据。
  • 对于近期（约最近7天内）有成本数据但无激活数据的广告系列，Master API无法拉取其相关数据。
• 分组：指定的分组维度仅适用于LTV、活跃和留存KPI。如某个KPI的数据不可用，则API会返回N/A。举例来说，假设您请求了retention_rate_day_7（第7天的留存率）数据，并以af_channel（流量入口）分组，这时API返回N/A，则表示该数据不可用。
• 报告行数上限：20万行
• 事件名称：Master API目前不支持带有正斜杠“/”的事件名称。为避免出现数据拉取不到的情况，请勿在事件名称中使用“/”。
• 处理时间：您选择的应用越多，处理时间就越长，等待响应的时间也就越长。