Pull APIs - Pulling AppsFlyer Reports by APIs - 用Pull API的方式从AppsFlyer拉取数据报告

原始数据报告提供安装和应用内事件的所有数据。

API 参数-必要

api_token

是用户对外的API授权密钥：“{使用帐户所有者的API密钥}"

from

报告开始日期的格式为“yyyy-mm-dd”或“yyyy-mm-dd hh:mm”。例如：2010-01-01或2010-01-01％2000％3A15 -（小时参数仅适用于原始数据报告）。

to

报告截止时间。与from格式相同

API筛选参数 - 可选

按媒体源筛选

通过在请求URL中添加Category和Media Source参数，可以筛选报告以列出特定的媒体源:

category

若想获取Facebook数据，那么设置category=facebook ；对于任何其他特定媒体源，设置category=standard 

media_source

提供AppsFlyer控制面板上显示的某个媒体源的名称(media_source=[SOURCE_NAME])

https://hq.appsflyer.com/export/com.greatapp/installs_report/v5?api_token=xxxx
&from=2018-04-09&to=2018-05-09&category=standard&media_source=googleadwords_int

https://hq.appsflyer.com/export/com.greatapp/installs_report/v5?api_token=xxxx
&from=2018-04-09&to=2018-05-09&category=facebook&media_source=facebook

按事件名称筛选

使用event_name参数筛选应用内事件原始数据报告，使其仅包含特定事件。要筛选多个事件，请使用逗号分隔各个事件。

举例来说：event_name=af_purchase,ftd

重定向相关报告

使用reattr=true可以得到重定向广告系列的结果

使用Pull API获取自定义报告

fields 

Pull API支持使用可选字段自定义原始数据报告（v5及更高版本）。这使营销人员能够只下载相关信息以满足他们的要求。

要指定请求的字段，请将以下字段字段参数附加到API Call中。

您请求的每个字段都应通过此处列出的API名称添加到fields参数中。Example: fields=country_code,city

&fields=API_Name_A,API_Name_B

完整的字段列表及其API名称可在此处找到。

附加字段

通过Pull API，您可以添加一些字段，有时可以得到更加完整的原始安装数据和应用内事件数据。

要添加新字段，请在跟踪链接中添加“&additional_fields=”，然后用逗号分隔想要添加的其他字段 。请参阅下面的Pull API示例。

通过Pull API拉取的是添加了字段的CSV报告，其中包含相关信息。

时区与货币

时区(可选)

您可以更改时区设置，获取相应时区下的Pull API原始数据

1. 在Pull API链接中添加&timezone=[Joda-Time] 以拉取相应时区的报告（请参阅下面的注释）

2. 在Pull API链接中添加&timezone=[Numerical value]以在指定的时区下接收报告。例如：对于时区UTC + 10:00添加链接&timezone=%2B10:00

3. 否则，将在默认的UTC时区中接收数据。

币别(可选)

用于接收所选币别的收入和成本数据，系统默认的是美元 。这是由帐户管理员进行设置的。

currency=preferred

 用于接收所选币别的收入和成本数据

API 政策

AppsFlyer的API 政策 通过限制每日请求的数量，防止滥用功能来确保为Pull API用户提供高质量的服务。

每个报告的最大记录数为200K。如果你得到一个有200K行的报告，那么你可能会遗漏一些结果。

API 安全性

所有Pull API链接都使用安全加密的https连接。

更多细节请查看此处。 

Pull API 链接示例

API Version (V5)

• 维持不变：

  • 现有的API（v4）仍可供使用

  • 该版本未对文件格式或标题进行任何更改

汇总报告提供广告活动成效的详细信息。

API 参数-必要

api_token

是用户对外的API授权密钥：“{使用帐户所有者的API密钥}”

from

报告开始日期的格式为“yyyy-mm-dd”或“yyyy-mm-dd hh:mm”。例如：2010-01-01或2010-01-01％2000％3A15 - （小时参数仅适用于原始数据报告）。

to

报告截止时间。与from格式相同

API筛选参数 - 可选

按媒体源筛选

通过在请求URL中添加Category和Media Source参数，可以筛选报告以列出特定的媒体源

category

若想获取Facebook数据，那么设置category=facebook；对于任何其他特定媒体源，设置category=standard 

media_source

提供AppsFlyer控制面板上显示的某个媒体源的名称(media_source=[SOURCE_NAME])

https://hq.appsflyer.com/export/com.greatapp/installs_report/v5?api_token=xxxx
&from=2018-04-09&to=2018-05-09&category=standard&media_source=googleadwords_int

https://hq.appsflyer.com/export/com.greatapp/installs_report/v5?api_token=xxxx
&from=2018-04-09&to=2018-05-09&category=facebook&media_source=facebook

时区和货币

时区(可选)

您可以通过Pull API以UTC或App设定的时区来获取汇总数据，该时区在“应用程序设置”页面中设置：

1. 在Pull API链接中添加&timezone=[selected Joda-Time]以在应用程序的设定时区接收报告（请参阅下面的注释）

2. 如果没有设置的话，将在默认的UTC时区中接收数据。

币别(可选)

用于接收所选币别的收入和成本数据，系统默认的是美元 。这是由帐户管理员进行设置的。

currency=preferred

 用于接收所选币别的收入和成本数据

API政策

AppsFlyer的API政策政策通过限制每日请求的数量，防止滥用功能来确保为pull API用户提供高质量的服务。

每个报告的最大记录数为200K。如果你得到一个有200K行的报告，那么你可能会遗漏一些结果。

API安全性

所有Pull API链接都使用安全加密的https连接。

更多细节请查看此处。

Pull API 链接示例

API Version (V5)

• 变动:

  • V5版本仅显示Facebook广告营销活动层级的数据，而不能显示广告系列和广告层级。


  • 导出数据页面的汇总报告使用V5的API 版本

• 保持不变:

  • 现有的API（v4）仍可供使用

  • 该版本未对文件格式或标题进行任何更改

P360汇总数据，在控制面板中是出现在“高级监测”这个版块中的。

API 参数-必要

api_token

是用户对外的API授权密钥：“{使用帐户所有者的API密钥}

from

报告开始日期的格式为“yyyy-mm-dd”或“yyyy-mm-dd hh:mm”。例如：2010-01-01或2010-01-01％2000％3A15 - （小时参数仅适用于原始数据报告）。

to

报告截止时间。与from格式相同

API筛选参数 - 可选

按媒体源筛选

通过在请求URL中添加
pid=media source name.，可以筛选报告以列出特定的媒体源

时区和货币

时区（可选）

您可以通过Pull API以UTC或App设定时区获取汇总数据，该时区在“应用程序设置”页面中设置：

1. 在Pull API链接中添加&timezone=preferred以在应用程序的设定时区下接收报告（请参阅下面的注释）

2. 否则，将在默认的UTC时区中接收数据。

币别（可选）

用于接收所选币别的收入和成本数据，系统默认的是美元 。这是由帐户管理员进行设置的。

currency=preferred

 用于接收所选币别的收入和成本数据

API 安全性

所有Pull API链接都使用安全加密的https连接。

更多细节请查看此处。

Pull API 链接示例

API Version (V5)

• 变动:

  • V5版本仅显示Facebook广告营销活动层级的数据，而不能显示广告系列和广告层级。

  • 
导出数据页面的汇总报告使用V5的API 版本。

• 保持不变:

  • 现有的API（v4）仍可供使用

  • 该版本未对文件格式或标题进行任何更改