SKAN原始数据报告

推荐用于
营销人员
最近更新：

概要：AppsFlyer通过iOS回传以及SKAN原始数据回传接收到相关数据后，对其进行解析并生成设备级数据，然后将这些设备级数据呈现在SKAN原始数据报告中。您可以通过Data Locker和Push API获取相关数据。如果您订购的套餐中已包含原始数据权限，则无需再单独购买Data Locker。 

SKAN原始数据报告

原理： 

  • AppsFlyer通过以下工具提供SKAN原始数据：
    • Data Locker
      • 请注意：购买了原始数据产品的客户即可使用该功能，无需再另外购买Data Locker。如果您目前尚未使用Data Locker，必须让您账户的管理员配置Data Locker并启用SKAN报告。启用方法为：从AppsFlyer面板进入报告 > Data Locker，然后选择相关的SKAN报告。 
      • 数据时效性：每天更新一次， 数据存储位置：AppsFlyer回传接收日期下的h=23文件夹。 
    • Push API
  • 激活日期:由AppsFlyer根据回传接收时间判定，具体如下：
    • 根据SKAN 4的回传推算激活日期的方式如下：激活日期 = 回传送达时间 - [累计窗口期时长] - [平均回传延时]。
      • 第1次回传：激活日期 = 回传接收时间 - 48h - 36h
      • 第2次回传：激活日期 = 回传接收时间 - 168h - 84h
      • 第3次回传：激活日期 = 回传接收时间 - 840h - 84h
    • 根据SKAN 3的回传推算激活日期的方式如下：激活日期 = 回传送达时间 - 36小时 - [用户上次打开应用的时间距激活的平均小时数]。 
      • 上述公式中的平均激活后小时数默认为12小时。
      • 对于转化值为0的事件（即激活），则平均激活后小时数为0。
    • Google根据自己的逻辑来估算激活时间，AppsFlyer会取用Google得出的激活时间。请注意：Google上报激活最长需要45天时间。了解详情

可用的报告类型如下：

  • 设备回传：每次发生激活或重新下载（redownload）时AF会收到一次来自相关iOS设备的设备回传。
  • SKAN原始数据：
    • AppsFlyer会将设备回传解析为原始数据记录。
    • 每次回传都会生成一条激活或重新下载（redownload）记录以及应用内事件记录。
    • 应用内事件记录的数量取决于转化值（CV），具体如下：
      • CV = 0、空值或null值时：不生成应用内事件记录。 
      • CV值范围：
        • 1-63:适用于SKAN 3以及SKAN 4窗口1精细值，代表应用内事件记录的条数，具体取决于您的衡量设置。
        • Low、medium、high：适用于SKAN 4粗略值，代表应用内事件记录的条数，具体取决于您的衡量设置。

为什么有些字段是空的？以下任一情况都会导致字段出现空值：

  • 广告平台未提供campaign_name（广告系列名称）、ad_network_campaign_id（广告系列ID）、ip等非必要的数据扩充字段。
  • 受Apple的阈值规定限制，该数据不开放。受影响的字段包括source_app_id、skad_campaign_id、skad_conversion_value。 

SKAN原始数据报告格式及内容

原始数据报告类型

报告类型 报告名称 说明
回传 数据回传

iOS向广告平台发送回传，广告平台对该回传进行扩充后再发送给AppsFlyer。详情请见可下载的回传示例（CSV格式）。

请注意：did_win=false时不包含回传数据。

Data Locker中的主题名称：skad_postbacks
回传 回传备份（从Apple侧直接发送）

从iOS直接发送到AppsFlyer的回传。

对iOS 15及以上版本的系统可用，需要广告主进行相关的配置，让应用将获得归因的回传发送到AppsFlyer。详情请见可下载的回传示例（CSV格式）。

请注意：该主题仅包含获得归因的回传。 

Data Locker中的主题名称：skad_postbacks_copy
解析后的事件 激活假量

首次应用激活

SKAN上报redownload=false,代表该用户（以Apple ID表示）首次下载相关应用。
详情请见可下载的激活报告示例（CSV格式）。

Data Locker中的主题名称：skad_installs
解析后的事件 重新下载（Redownloads）

非首次激活的应用激活

SKAN上报redownload=true。也就是说，该用户（以Apple ID表示）并非首次下载相关应用。该报告的结构与激活报告相同。

Data Locker中的主题名称：skad_redownloads
解析后的事件 应用内事件

应用内事件

2021年7月21日起，AF提供应用内事件原始数据的方式有所变化，具体请见下表。 

应用内事件记录的数量取决于具体的衡量设置。 

详情请见可下载的应用内事件报告示例（CSV格式）。

Data Locker中的主题名称：skad_inapps

对于2021年7月21日之后接收到的iOS回传：

衡量选项 说明
收入
  • 具体某个用户的收入。如果收入> 0，会生成一条带有skad_revenue和event_name字段的记录。
  • min_revenue和max_revenue字段根据您的自定义转化范围值填充。  
应用内转化以及漏斗事件
  • 用户每完成一个独立的转化事件即生成一条记录，并在event_name字段中填充相应的值。如果用户没有完成事件，则不生成记录。
  • min_event_counter = 0且max_event_counter = 1的转化事件。 
应用内互动  用于判断某用户完成特定应用内事件的次数，计算方法为[round up (min_event_counter + max_event_counter) / 2]

对于2021年7月20日及之前接收到的iOS回传：

衡量选项 记录条数 说明
收入 0-1 如果收入> 0，会生成一条带有skad_revenue和event_name字段的记录。
转化  0-6 用户每完成一个独立的转化事件即生成一条记录，并在event_name字段中填充相应的值。如果用户没有完成事件，则不生成记录。
广告交互 0-63 记录的条数代表用户完成互动事件的次数。如果用户没有互动，则不会生成互动记录。
自定义 0-无限 取决于您的自定义转化构架。 
解析后的事件 SRN广告维度 
  • 该报告中包含广告系列、广告组和广告维度的Meta ads事件。报告中的每一行代表一次激活或一个应用内事件。
  • Meta ads发送的SKAN回传中不包含广告组和广告维度的数据。该数据只在该报告中呈现，且不会出现在SKAN面板、Performance API或其他SKAN Data Locker报告中。
  • 该报告无固定结构（schemaless）。Data Locker字段选项不适用于此报告。
  • 推荐方法：请勿将本报告中的数据与其他SKAN报告合并或对比，因为本报告使用的数据由SRN解码，而其他报告数据可能由AppsFlyer解码，二者之间可能存在差异。这些差异可能源自时区、SRN架构差异，或SRN中应用内事件与CV的不准确映射等。
  • 详情请见可下载的SRN广告维度示例（CSV格式）。
Data Locker中的主题名称：skad_srn_advertising_dimensions

原始数据字段格式类别

字段格式

格式名称 说明
字符串 [n] 字符串的长度上限。AF接收数据时并不会对字段长度做出硬性限制，但超过上限的字段可能会被截断。
时间字符串 字符串的格式为yyyy-mm-dd hh:mm:ss。使用场景示例：2019-09-17 00:09:25 
枚举 [n] 枚举字段仅可包含特定的值。比如成本的货币单位只能由指定的3字符货币代码组成。
时间戳

10位UNIX时间戳。举例来说，

UTC时间2020年8月4日07:25的时间戳为：
布尔 这类字段的值只有TRUE或FALSE两种。
整数 整数
浮点数 浮点数（实型）中可以带小数点，且小数点后可以有值。

回传及回传备份报告中的可用字段

字段名称 来源或iOS SKAN起始版本 说明 格式 回传备份中是否可用 
ad_network_campaign_id 广告平台 广告平台上报给AppsFlyer的广告系列ID 字符串 否

ad_network_campaign

_name

 广告平台

广告平台上报给AppsFlyer的广告系列名称

 

 字符串 否
ad_network_timestamp 广告平台

广告平台接收到回传的时间

在Google Ads中，该时间信息是根据Google上报的末次点击时间得出的。

 时间戳 否
app_id AppsFlyer 以“ID”开头的App ID（广告主应用）。 字符串 是
city AppsFlyer 从2021年8月30日开始，该值总是为null  字符串 否
country_code 广告平台   字符串 否
dma   从2021年8月30日开始，该值总是为null  字符串 否
postal_code   从2021年8月30日开始，该值总是为null   字符串 否
region AppsFlyer 基于上报的country_code得出 字符串 否
skad_ad_network_id 1.0  X Ads等一部分SRN不共享其ID，这时该字段显示为空。例如，X Ads。  字符串 是 
skad_attribution_signature 1.0   字符串 是
skad_campaign_id 1.0 用于发布该则广告的广告系列ID，范围为0-100。 字符串 是
skad_conversion_value 2.0 

iOS上报的转化值，范围为0-63。

若该字段的值为null，则表示iOS未填充该字段** 

 整数 是
skad_redownload 2.0 如果该参数的值为true，则表示用户重新下载（redownload）了相关应用 布尔 是
skad_source_app_id 2.0

子渠道ID，即发布该广告的应用。该字段与source_app_id完全一致。

字段填充方式取决于隐私阈值**

 字符串 是
skad_transaction_id 1.0   字符串 是
skad_version 2.0   字符串 是
timestamp 广告平台 AppsFlyer接收到SKAN回传的时间  时间字符串 是
ad_network_name 广告平台 广告平台向AppsFlyer上报的广告平台名称。 
  • 如果该字段为空，则表示广告平台没有（无法）填充该字段。
  • 您可以通过skad_ad_network_id来解析广告平台的名称。请使用此处表格进行解析。 
 字符串 否
ip  

发送回传的iOS设备的HTTP消息中的IP地址

如果广告平台向AF提供该地址，则该字段中会填充相应的值。

请注意：该地址信息的获取与SDK无关。

 字符串 否
skad_app_id 1.0   字符串 否
source_app_id AppsFlyer 子渠道ID，即发布该广告的应用。该字段与skad_source_app_id完全一致。 字符串 否
ad_network_adset_id 广告平台   字符串 否
ad_network_adset_name 广告平台   字符串 否
ad_network_ad_name 广告平台   字符串 否
ad_network_ad_id 广告平台   字符串 否
did_win 3.0（iOS 14.6） 用于区分助攻和获得激活归因的广告系列。 
  • 如果该字段值为true，则表示该广告系列获得了此次激活的归因
  • 如果该字段值为false，则表示该广告系列在此次激活中形成助攻，但不会呈现在任何SKAN面板或报告中。
  • 如果该字段值为null，则表示iOS或SKAN版本过低，因此iOS未填充该字段。
 布尔 是
fidelity_type 2.2（iOS 14.5）

用于区分广告呈现方式，这会影响到归因结果。通过0和1来表达，具体如下： 

  • 浏览型广告（View-though Ads）：0
  • 渲染型广告（StoreKit-rendered Ads）：1

如果SKAN版本低于2.2，请忽略该字段值。

 整数 是
ad_network_source_app_id 广告平台 广告平台上报的流量侧应用（Publisher App）ID，用于核对成本。该数据基于流量侧应用提供的信息得出。 字符串 否
ad_network_channel 广告平台   字符串 否
af_prt 广告平台   字符串 否
skad_postback_sequence_index 4.0（iOS 16.2）
  • 该字段代表SKAN窗口，可能出现的值为0、1或2。
  • 在SKAN 3中，该字段的值为0。
整数 是
skad_coarse_conversion_value

4.0（iOS 16.2）

 
  • 值可以是low、medium、或high。
  • 在SKAN 3中，该字段的值为null。
 字符串 是
skad_source_identifier 4.0（iOS 16.2）
  • 该字段的值最多可有四位数
  • 在SKAN 3中，该字段的值为null。 
 字符串 是
skad_source_domain 4.0（iOS 16.2）
  • 该字段的值代表可归因的网页广告来源
  • 在SKAN 3中，该字段的值为null。
 字符串 是
ad_network_creative 广告平台
  • 该字段的值基于广告平台提供的扩充数据得出
  • 在SKAN 3中，该字段的值为null。
 字符串 否
** Apple通过隐私阈值机制来判断是否填充该字段   

解析后的事件报告中可用的字段

字段名称 流量来源 说明 格式 SRN广告维度报告中是否呈现
ad_network_campaign_id 广告平台 广告平台上报给AppsFlyer的广告系列ID 字符串 是
ad_network_campaign
_name		 广告平台 广告平台上包给AppsFlyer的广告系列名称 字符串 是
ad_network_timestamp 广告平台

广告平台接收到回传的时间

在Google Ads的投放场景中，该字段不填充。 

时间戳

(时间字符串，用于SRN投放维度报告）

 是
app_id iOS App ID（广告主应用） 字符串 是
city   从2021年8月30日开始，该值总是为null  字符串 否
country_code 广告平台   字符串 否
dma   从2021年8月30日开始，该值总是为null  字符串 否
event_name AppsFlyer

在AppsFlyer中配置的应用内事件名称

在SRN ___report中，该字段为Meta ads中配置的应用内事件。

 字符串 是
event_uuid AppsFlyer 具有唯一性的随机标识符，便于渠道识别重复的回传 字符串 否
install_date iOS 由AppsFlyer根据回传接收时间估算得出 时间字符串 否
install_type iOS 新增激活 字符串 否
ip iOS

发送回传的iOS设备的HTTP消息中的IP地址。

如果广告平台向AF提供该地址，则该字段中会填充相应的值。

请注意：该地址信息的获取与SDK无关。 

 字符串 否
media_source iOS 通过AppsFlyer平台名称获得归因的广告平台 字符串 是
postal_code   从2021年8月30日开始，该值总是为null  字符串 否
region AppsFlyer 根据country_code（国家代码）判定 字符串 否
skad_ad_network_id iOS 接收回传的广告平台的ID 字符串 否
skad_ambiguous_event（SKAN 4+已弃用） AppsFlyer 如果该参数的值为true，则表示iOS回传的接收时间在广告主在面板中更改SKAN设置后的最初72小时内。由于SKAN使用的计时器过多，因此AppsFlyer无法准确地映射该事件。
  • 在SKAN 4以上版本中不可用
 布尔 否
skad_attribution_signature iOS   字符串 否
skad_campaign_id iOS 用于发布该则广告的广告系列ID，范围为0-100。 整数 否
skad_conversion_value iOS

iOS上报的转化值，范围为0-63。

若该字段的值为null，则表示iOS未填充该字段**

 整数 否
skad_mode AppsFlyer 用于解析iOS回传的转化衡量模式，可用值包括：
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
 字符串 否
skad_redownload iOS 如果该字段的值为true，则表示用户重新下载了相关应用 布尔 否
skad_revenue iOS 以USD为单位的事件收入金额。 浮点数 否
skad_source_app_id iOS

子渠道ID，即发布相关广告的应用。

字段填充方式取决于隐私阈值**

 字符串 否
skad_transaction_id iOS - 字符串 否
skad_version iOS - 字符串 否
timestamp iOS

AppsFlyer接收到SKAN回传的时间

在Google Ads和Meta ads投放场景中，该字段代表AppsFlyer从Google和Meta ads API接收到数据的时间

时间戳

(时间字符串，用于SRN投放维度报告）

 是
event_value S2S

默认值为null

包含一个字符串。该字符串的设置取决于使用自定义解析（custom decode）模式的应用。

该数据供广告主在其内部系统中使用，AppsFlyer不会使用该数据。 

 字符串（JSON） 否
ad_network_adset_id 广告平台   字符串 是
ad_network_adset_name 广告平台   字符串 是
ad_network_ad_name 广告平台   字符串 是
ad_network_ad_id 广告平台   字符串 是
skad_did_win (1) 3.0（iOS 14.6） 用于区分助攻和获得激活归因的广告系列。 
  • 如果该字段值为true，则表示该广告系列获得了此次激活的归因
  • 如果该字段值为false，则表示该广告系列在此次激活中形成助攻，但不会呈现在任何SKAN面板或报告中。
  • 如果该字段值为null，则表示iOS或SKAN版本过低，因此iOS未填充该字段。
 布尔 否
skad_fidelity_type (1) 2.2（iOS 14.5）

用于区分广告呈现方式，这会影响到归因结果。通过0和1来表达，具体如下： 

  • 浏览型广告（View-though Ads）：0
  • 渲染型广告（StoreKit-rendered Ads）：1

如果SKAN版本低于2.2，请忽略该字段值。

 整数 是
ad_network_source_app_id (1) 广告平台 广告平台上报的流量侧应用（Publisher App）ID，用于核对成本。该数据基于流量侧应用提供的信息得出。 字符串 否
ad_network_channel (1) 广告平台   字符串 否
af_prt (1) 广告平台   字符串 否
min_revenue  AppsFlyer 参见脚注（4） 实数 否
max_revenue   AppsFlyer 参见脚注（4） 实数 否
event_revenue AppsFlyer 计算方式：[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量] 浮点数 是
min_event_counter AppsFlyer 用于计算用户完成某一事件的次数。参见脚注（3） 整数 否
max_event_counter AppsFlyer 参见脚注（3） 整数 否
min_time_post_install AppsFlyer 参见脚注（5） 整数 否
max_time_post_install AppsFlyer 参见脚注（5） 整数 否
af_attribution_flag AppsFlyer 单一可信数据源（SSOT）机制启用时：如果该字段的值为true，则表示该次激活同时被AppsFlyer和SKAN归因。如果该值为false，则表示该次激活没有被AppsFlyer归因。即使skad_conversion_value的值为null，该参数的值仍为true或false（取决于模型推算）。 布尔 否
measurement_window AppsFlyer 用户行为窗口期的时长。默认情况下，该字段的值为24h（即窗口期默认为24小时）。  整数 否
interval AppsFlyer 用户行为窗口期间隔时长。  整数 否
user_agent AppsFlyer 设备用户代理（User Agent） 字符串 否
skad_postback_sequence_index 4.0（iOS 16.2）
  • 该字段代表SKAN窗口，可能出现的值为0、1或2。
  • 在SKAN 3中，该字段的值为0。
整数 是
skad_coarse_conversion_value

 

4.0（iOS 16.2）
  • 值可以是low、medium、或high。
  • 在SKAN 3中，该字段的值为null。
 字符串 是
skad_source_identifier 4.0（iOS 16.2）
  • 该字段的值最多可有四位数
  • 在SKAN 3中，该字段的值为null。 
 字符串 是
skad_source_domain 4.0（iOS 16.2）
  • 该字段的值代表可归因的网页广告来源
  • 在SKAN 3中，该字段的值为null。
 字符串 是
ad_network_creative 广告平台
  • 该字段的值基于广告平台提供的扩充数据得出
  • 在SKAN 3中，该字段的值为null。
 字符串 否

** Apple通过隐私阈值机制来判断是否填充该字段

（1）从2021年6月2日开始，报告中增加了这个字段。但不一定带有值。

（3）用于判断某用户完成特定应用内事件的次数，计算方法为：[round up (min_event_counter + max_event_counter) / 2]请注意： 必须四舍五入取整。
举例来说，
A. 如果min = 0，max = 1，则平均值为0.5；取整后得到的结果为1。
B. 如果min = 5，max = 10，则平均值为7.5；取整后得到的结果为8。

(4) 收入数据总是呈现在字段skad_revenue中。如果您使用SKAN 4或自定义模式（Custom Mode），则用于计算skad_revenue的范围（即关联到相关事件的范围）通过min_revenue 和max_revenue表达。

（5）

  • 在自定义模式（Custom）中：AppsFlyer对于激活时间的计算方式为回传接收时间 - 36h - (min_time_post_install + max_time_post_install)的平均值。但如果CV = 0，则(min_time_post_install + max_time_post_install)的平均值视为0。 
  • 在解析模式（Decode）中：min_time_post_install比max_time_post_install中设置的值少一小时，max值等于您在解析模式的转化映射中设置的hours_from_install。 
  

其他相关信息

特点与局限性

特点 说明 
渠道权限 向广告平台提供回传数据
代理访问权限 不可用
代理数据透明化 不适用
时区 UTC
货币  USD
自然量数据 基于SDK事件数据得出。比如，自然激活指标的计算方式如下：由SDK上报的所有激活减去由SKAN上报的非自然激活。
非自然量数据 基于SKAN回传得出
数据时效性 每天更新一次，SKAN时效：iOS会在窗口期结束后的24-28小时内上报相关激活。
历史数据 受Data Locker数据可用期限的限制。 
相关账户下的用户权限 可用。具体取决于账户授权。

 相关文档