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

推荐用于

营销人员

最近更新： 2022年09月30日 10:38

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

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

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`授权`标头。账户管理员可从面板中获取V2 Token。获取方式：点击面板右上角的邮箱地址 > API token。
日期限制	支持2020年11月1日之后的数据查询范围上限：60天
频次限制	最多可返回20万行数据每分钟最多可调用60次
SRN相关说明	Google Ads：回传接收日期是通过Google上报的末次点击时间推算得出的。

查询参数
参数名称	说明	是否必须配置
`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的二位国家代码筛选数据。如`US`、`CN`	否
`skad_redownload`	按`true`或`false`筛选数据	否
`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 （请求次数过多）	拉取频次超过上限