概要：您可以使用该API获取数据点更充足、维度更丰富的SKAN效果数据。这些数据与SKAdNetwork面板中的数据类似，按激活日期或回传送达日期进行汇总。
SKAN汇总效果报告API（SKAN aggregated performance report API）
该API可返回由Apple SKAdNetwork上报的归因指标等数据点（真实数据），按激活日期或回传送达日期汇总。返回的报告结构与SKAN面板中的数据结构相同。
使用SKAN汇总效果报告API
如需使用SKAN汇总效果报告API，请按以下方式操作：
- 获取API token。只有相关账户的管理员才能获取该token。
- 将该API token发送给您的开发人员，用于认证头（Authentication Header）中。
- 将下表所列的相关参数发送给您的开发人员，让其在调用API时输入这些参数。这些参数用于界定报告的重点内容、信息梳理方式以及报告覆盖的时间范围。
- 让您的开发人员按照开发者资源中心的SKAN汇总效果报告API指南进行操作。
参数
| 参数名称 | 格式 | 是否必须配置 |
|---|---|---|
|
|
日期范围中使用的日期类型取决于 可用值如下：
Google Ads数据：由于Google Ads数据上报机制的关系，Google Ads数据的激活日期和回传送达日期相同。 |
否 |
|
|
激活日期的范围通过start_date（起始日期）和end_date（截止日期）设置。请注意：激活日期区别于回传送达日期。
|
是 |
end_date |
|
是 |
view_type |
您可以按以下视图类型筛选激活数据：
|
否 |
modeled_conversion_values |
|
否 |
报告结构及示例
该API会返回一个CSV格式的文件。
- 下表列出了报告中可用的字段和指标。
- 部分指标（收入、广告交互、转化）取决于SKAN广告效果衡量的设置方式。
- 报告中仅包含用户在数据上报周期内完成的应用内事件，因此每个报告中应用内事件字段的数量和顺序可能有所不同。基于这个因素，请不要按照字段顺序来设计您的数据导入流程。
- 示例： V1 | V2
报告字段
| 字段名称 | 维度或指标 | API V1 token中是否可用 | API V2 token中是否可用 |
API V2 token中是否可用（针对SKAN 4） |
是否可使用“仅显示模型推算数据”的筛选条件 |
|---|---|---|---|---|---|
|
Date 根据选定的日期类型（date_type）呈现数据 |
维度 | N | Y | Y | Y |
| Media Source (pid) | 维度 | Y | Y | Y | Y |
| Campaign (c) |
维度 |
Y |
Y |
Y |
Y |
| Campaign ID | 维度 | Y | Y | Y | Y |
| Site ID | 维度 | Y | Y | Y | N |
| Adset | 维度 | N | Y | Y | Y |
| Adset ID | 维度 | N | Y | Y | Y |
| Ad | 维度 | N | Y | Y | N |
| Ad ID（广告ID） | 维度 | N | Y | Y | N |
| Country | 维度 | Y | Y | Y | N |
|
AF Attribution Flag 详情请见SSOT指南 |
维度 | N | Y | Y | Y |
|
Postback sequence index |
维度 | N | N | Y | Y |
|
Creative |
维度 | N | N | Y | N |
|
Channel |
维度 | N | N | Y | N |
| Impressions | 指标 | Y | Y | Y | Y |
| Clicks | 指标 | Y | Y | Y | Y |
| CTR | 指标 | Y | Y | Y | Y |
| Installs | 指标 | Y | Y | Y | Y |
|
Click Through Installs（fidelity_type = 1） |
指标 | Y | Y | Y | Y |
|
View Through Installs (fidelity_type = 0) |
指标 | Y | Y | Y | Y |
|
Null Conversion Value Rate 【2022年1月23日起可用】 |
指标 | N | Y | Y | Y |
| Conversion Rate | 指标 | Y | Y | Y | Y |
| Converted Users | 指标 | Y | Y | Y | Y |
| Converted Users/Installs | 指标 | Y | Y | Y | Y |
| Total Revenue | 收入指标 | Y | Y | Y | Y |
| Total Cost | 指标 | Y | Y | Y | Y |
| ROI | 收入指标 | Y | Y | Y | Y |
| ARPU | 收入指标 | Y | Y | Y | Y |
| Average eCPI | 指标 | Y | Y | Y | Y |
| {af_skad_revenue}（独立用户数） | 收入指标 | Y | Y | Y | Y |
| {af_skad_revenue}（事件数量） | 收入指标 | Y | Y | Y | Y |
|
{应用内事件名称}（独立用户数） |
指标 | Y | Y | Y | Y |
| {应用内事件名称}（事件数量） | 指标 | Y | Y | Y | Y |
特点与局限性
| 特点 | 说明 |
|---|---|
| 数据时效性 | 数据可用性取决于SKAN数据的更新频次。 |
| 日期范围 |
|
| 频次限制 |
|
| SRN |
|
| 渠道权限 | 如果贵司是数据分析平台，请让相关广告主为您开放权限。 |
| 代理访问权限 | 不可用 |
| 应用层级的指定时区 | 不支持，仅限UTC |
| 应用配置中的指定货币 | 不支持，仅限USD |
| 自然量数据 | 计算方式：由SDK直接上报给AF的总体数据减去由SKAN回传上报的非自然量数据 |
| 非自然量数据 | 根据AppsFlyer接收到的SKAN回传计算 |
| 历史数据 | 转化数据（激活或再营销）的最早可查询日期：2020年11月1日 |
| 相关账户下的用户权限 | 账户管理员可以在面板中获取授权token。 |
| 总成本 | 如果常规归因（即常规数据总览）中粒度最细的SKAN投放数据（如具体广告、国家或子渠道ID等）行数超过5万行，则SKAN API不返回总成本指标。 |