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

推荐用于

营销人员

最近更新： 2024年02月08日 11:41

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

该API会按回传数据的接收日期，返回汇总的SKAN回传数据。

注意：回传接收日期与SKAN面板和报告中的激活日期不同。

如需使用SKAN汇总效果报告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的二位国家代码筛选数据。如`US`、`CN`	否
`skad_redownload`	按`true`或`false`筛选数据	否
`skad_source_app_id`	按流量侧应用ID（Source App ID）筛选数据	否
`ad_network_campaign_id`	按广告平台的广告系列ID筛选数据。注意：这不是SKAN上报的广告系列ID。	否
`modeled_conversion_values`	仅V2及以上版本的API支持该参数可能出现的值为`true`或`false` 如果该参数的值为`true`，回传数据中的“count”列会显示模型推算的转化值。另请参见模型推算数据的可用字段如果该参数的值为`false`，回传数据中显示的转化值以及报告结构中所有可用字段（见下文）的值都是实际接收到的值，不包含模型推算数据。默认值为`false`。	否

API会返回一个CSV格式的文件。

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

示例：V1 | V2

SKAN汇总报告结构
字段名称	字段属性（分组维度或统计结果）	API V1 token中是否可用	API V2 token中是否可用	API V2 token中是否可用（针对SKAN 4）	是否可使用“仅显示模型推算数据”的筛选条件
skad_postback_sequence_index	分组维度	N	N	Y	Y
skad_conversion_value	分组维度	Y	Y	Y	Y
skad_coarse_conversion_value	分组维度	N	N	Y	Y
skad_ad_network_id 部分SRN不会将其ID分享给AF。在这种情况下，该字段为空，并会显示ad_network_name（广告平台名称）。	分组维度	Y	Y	Y	Y
ad_network_name 目前该字段一般为空，但在SRN不发送skad_ad_network_id时我们会填充这个字段。	分组维度	Y	Y	Y	Y
skad_source_identifier	分组维度	N	N	Y	Y
skad_campaign_id	分组维度	Y	Y	Y	Y
ad_network_campaign_id	分组维度	Y	Y	Y	Y
ad_network_campaign_name	分组维度	Y	Y	Y	Y
ad_network_adset_id	分组维度	N	Y	Y	Y
ad_network_adset_name	分组维度	N	Y	Y	Y
ad_network_ad_id	分组维度	N	Y	Y	N
ad_network_ad_name	分组维度	N	Y	Y	N
ad_network_creative	分组维度	N	N	Y	N
ad_network_channel	分组维度	N	N	Y	N
skad_version	分组维度	Y	Y	Y	N
skad_redownload	分组维度	Y	Y	Y	N
skad_source_app_id	分组维度	Y	Y	Y	N
skad_source_domain	分组维度	N	N	Y	Y
skad_fidelity_type	分组维度	N	Y	Y	N
geo	分组维度	Y	Y	Y	N
arrival_date	分组维度	Y	Y	Y	Y
count	统计结果	Y	Y	Y	Y

特点	说明
数据时效性	该报告每天更新一次。数据可用性取决于SKAN数据的更新频次。
日期范围	支持2020年11月1日之后的数据查询范围上限：60天
比率限制	最多可返回20万行数据每分钟最多可调用60次
SRN	Google Ads：回传接收日期是通过Google上报的末次点击时间推算得出的。
广告平台访问权限	在广告主开放相关权限的情况下，数据分析平台可以使用该API。
代理访问权限	不可用
应用配置中的指定时区	不支持，仅限UTC
应用配置中的指定货币	不支持，仅限USD
自然用户数据	该API中不可用
非自然用户数据	根据AppsFlyer接收到的SKAN回传计算
历史数据	支持2020年11月1日及之后的转化数据（激活或再营销）
AF用户的访问权限	账户管理员可以在面板中获取授权token。