我们能为您提供什么帮助?

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

  • 更新

概要:这些数据是按回传接收日期来汇总的。 

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

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

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

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

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

  1. 获取API token。只有相关账户的管理员才能获取该token。
  2. 将该API token发送给您的开发人员,用于认证头(Authentication Header)中。
  3. 将下表所列的相关参数发送给您的开发人员,让其在调用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比如

否

skad_redownload

否

skad_source_app_id

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

否

ad_network_campaign_id

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

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

否

modeled_conversion_values
  • 仅V2及以上版本的API支持该参数
  • 可用值为true或false
  •  
  • 如果该参数的值为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 Ads:回传接收日期是通过Google上报的末次点击时间推算得出的。 

渠道权限  在广告主开放相关权限的情况下,数据分析平台可以使用该API。 
代理访问权限 不可用
应用层级的指定时区 不支持,仅限UTC
应用配置中的指定货币  不支持,仅限USD
自然量数据 该API中不可用
非自然量数据 根据AppsFlyer接收到的SKAN回传计算
历史数据 转化数据(激活或再营销)的最早可查询日期:2020年11月1日
相关账户下的用户权限 账户管理员可以在面板中获取授权token。