How can we help?

搜索

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

  • 更新

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

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

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

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

使用SKAN汇总效果报告API

如需使用SKAN汇总效果报告API，请按以下方式操作：

  1. 获取API token。请注意，该步骤必须由账户管理员完成。
  2. 将该API token发送给您的开发人员，在认证头（Authentication Header）中使用。
  3. 将下表所列的相关参数发送给您的开发人员，让其在调用API时输入这些参数。这些参数用于界定报告的重点内容、信息梳理方式以及报告覆盖的时间范围。
  4. 让您的开发人员按照开发者资源中心的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。

另请参见

关于

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: