SKAN回传接收日期汇总报告API

概要:您可以通过API获取汇总的SKAN回传数据,这些数据是按回传接收日期来汇总的。

SKAN回传接收日期汇总报告API

API简介

核心功能

该API会按回传数据的接收日期,返回汇总的SKAN回传数据。注意:回传接收日期与SKAN面板和报告中的激活日期不同。

相关文档:激活日期汇总报告API

数据时效性

该报告每天更新一次。

数据可用性取决于SKAN数据的更新频次。

Path V1

https://hq1.appsflyer.com/api/skadnetworks-postbacks/v1/data/app/<app_id>

V1已弃用。正式下线日期将于日后公布。

Path V2

https://hq1.appsflyer.com/api/skadnetworks-postbacks/v2/data/app/<app_id>

路径参数(必须配置)

<app_id>:即AppsFlyer面板中的应用标识符。请将面板中的ID按原样粘贴到路径参数中。示例:id123456789

查询参数

见下表。
HTTP方法 GET
响应内容类型 text/plain
授权

必须设置包含API V2.0认证密钥(Bearer Token)的HTTP授权标头。

AppsFlyerAdmin_us-en.png账户管理员可从面板中获取V2 Token。获取方式:点击面板右上角的邮箱地址 > API token。

日期限制
  • 支持2020年11月1日之后的数据
  • 查询范围上限:60天
频次限制
  • 最多可返回20万行数据
  • 每分钟最多可调用60次
SRN相关说明

Google Ads:回传接收日期是通过Google上报的末次点击时间推算得出的。

API要点
查询参数
参数名称 说明 是否必须配置

start_date

回传接收日期的范围是通过start_date(开始日期)和end_date(截止日期)来设置的。请注意:回传接收日期与SKAN面板和报告中的激活日期不同。

  • YYYY-MM-DD 
  • 可用日期:2020-11-01及以后
    示例:2020-11-05
end_date
  • YYYY-MM-DD
  • 每次调用最多可查询的天数:60天
  • 示例:2020-11-12
ad_network_name

按媒体渠道筛选数据

geo 按ISO 3166的二位国家代码筛选数据。如USCN

skad_redownload

truefalse筛选数据

skad_source_app_id

按流量侧应用ID(Source App ID)筛选数据

ad_network_campaign_id

按广告平台的广告系列ID筛选数据。

注意:这不是SKAN上报的广告系列ID。

请求示例(cURL)

curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks-postbacks/v2/data/app/<app_id>?start_date=2020-09-10&end_date=2020-09-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'

报告结构及示例

示例:V1 | V2

该API会返回一个CSV文件,文件的命名结构如下:

<app_id>_skadnetworks_postbacks_report_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv

可用字段

下表列出了可用的字段和指标

SKAN汇总报告结构
字段名称 字段属性
(分组维度或统计结果)
在API V1中是否可用 在API V2中是否可用

skad_conversion_value

分组维度 Y Y

skad_ad_network_id

部分SRN不会将其ID分享给AF。在这种情况下,该字段为空,并会显示ad_network_name(广告平台名称)。

分组维度

Y

Y

ad_network_name

目前该字段一般为空,但在SRN不发送skad_ad_network_id时我们会填充这个字段。

分组维度 Y Y

skad_campaign_id

分组维度 Y Y

ad_network_campaign_id

分组维度 Y Y

ad_network_campaign_name

分组维度 Y Y

ad_network_adset_id

分组维度 N Y

ad_network_adset_name

分组维度 N Y

ad_network_ad_id

分组维度 N Y

ad_network_ad_name

分组维度 N Y

skad_version

分组维度 Y Y

skad_redownload

分组维度 Y Y

skad_source_app_id

分组维度 Y Y

skad_fidelity_type

分组维度 N Y

geo

分组维度 Y Y

arrival_date

分组维度 Y Y

count

统计结果 Y Y

 

特点与局限性

特点
特点 说明
广告平台访问权限 在广告主开放相关权限的情况下,数据分析平台可以使用该API。
代理访问权限 不可用
应用配置中的指定时区 不支持,仅限UTC
应用配置中的指定货币 不支持,仅限USD
自然用户数据 计算方式:由SDK直接上报给AF的总体数据减去由SKAN回传上报的非自然量数据
非自然用户数据 根据AppsFlyer接收到的SKAN回传计算
历史数据 支持2020年11月1日及之后的转化数据(激活或再营销)
AF用户的访问权限 账户管理员可以在面板中获取授权token。

HTTP响应码及问题排查

响应码及问题排查指南
HTTP 响应消息

说明

200 OK

返回有效数据(CSV文件)

200 OK

报告为空——在指定的日期范围内未找到数据(CSV文件,仅返回字段名称)。

  • 请在SKAN面板中检查该时段内是否有可用数据。
  • 请检查start_date的日期早于当前日期的之前一天。
400 Bad request
(请求无效)

查询参数缺失或无效

401 Unauthorized
(未授权)

授权token缺失或无效

请检查您使用的token是否正确无误

403 No permission
(无权限)
您没有该报告的访问权限。如果您是数据分析平台侧的人员,可以让广告主为您开通此权限。
404 Not found
(未找到)
  • 请确保所有的网络或防火墙相关问题都已解决。
  • 请确保AppsFlyer的IP地址已加白
429 Too many requests
(请求次数过多)

拉取频次超过上限