概要:您可以通过API获取汇总的SKAN回传数据,这些数据是按回传接收日期来汇总的。
SKAN回传接收日期汇总报告API
API简介
核心功能 |
该API会按回传数据的接收日期,返回汇总的SKAN回传数据。注意:回传接收日期与SKAN面板和报告中的激活日期不同。 相关文档:激活日期汇总报告API |
数据时效性 |
该报告每天更新一次。 数据可用性取决于SKAN数据的更新频次。 |
Path V1 |
V1已弃用。正式下线日期将于日后公布。 |
Path V2 |
|
路径参数(必须配置) |
|
查询参数 |
见下表。 |
HTTP方法 | GET |
响应内容类型 | text/plain |
授权 |
必须设置包含API V2.0认证密钥(Bearer Token)的HTTP
|
日期限制 |
|
频次限制 |
|
SRN相关说明 |
Google Ads:回传接收日期是通过Google上报的末次点击时间推算得出的。 |
参数名称 | 说明 | 是否必须配置 |
---|---|---|
|
回传接收日期的范围是通过start_date(开始日期)和end_date(截止日期)来设置的。请注意:回传接收日期与SKAN面板和报告中的激活日期不同。
|
是 |
end_date |
|
是 |
ad_network_name |
按媒体渠道筛选数据 |
否 |
geo |
按ISO 3166的二位国家代码筛选数据。如US 、CN
|
否 |
skad_redownload |
按 |
否 |
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)>'
报告结构及示例
该API会返回一个CSV文件,文件的命名结构如下:
<app_id>_skadnetworks_postbacks_report_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv
可用字段
下表列出了可用的字段和指标
字段名称 | 字段属性 (分组维度或统计结果) |
在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文件,仅返回字段名称)。
|
400 | Bad request (请求无效) |
查询参数缺失或无效 |
401 | Unauthorized (未授权) |
授权token缺失或无效 请检查您使用的token是否正确无误 |
403 | No permission (无权限) |
您没有该报告的访问权限。如果您是数据分析平台侧的人员,可以让广告主为您开通此权限。 |
404 | Not found (未找到) |
|
429 | Too many requests (请求次数过多) |
拉取频次超过上限 |