SKAN转化值操作台

定义

• SKAN衡量窗口期：适用于SKAN 4+。用户激活应用后共有3个窗口期，用于衡量用户行为，分别是：
  • 窗口1：1-2天
  • 窗口2：3-7天
  • 窗口3：8-35天
  • 这3个窗口的时间段不能互相重叠。也就是说，窗口2衡量的是激活后3-7天内的数据，而不是0-7天内的数据。
• 用户行为窗口期：适用于SKAN 3及以下版本。该窗口期有固定的时长，默认为24小时，从应用首次启动开始计时。如果您启用了SKAN 4+，但用户设备或广告平台尚不支持SKAN 4，则用户行为窗口期自动设置为48小时。
• 转化值（CV）：在SKAN 4的窗口期或SKAN 3及以下的用户行为窗口期（Activity Window）结束后，基于iOS的回传数据得出的用户质量信息。您可以直接通过AppsFlyer SDK设置CV值，也可以手动设置CV值。如需手动设置，请使用Decode（解析）模式上传您的CV映射文件。
  • SKAN 4+中的CV值有精细值和粗略值两种。
    
• 转化值消耗度：映射您的设置所需要的CV值数量。您在设置中选择的衡量维度和衡量元素越多，需要消耗的转化值就越多。您每添加一个范围或设置元素，转化值消耗度就会随之变高（在单个维度中每添加一个设置单元，转化值消耗度就会呈指数增长）。具体请见转化值耗尽示例。
• 单一可信数据源（Single Source of Truth，简称SSOT）：该机制可标记由SKAN和非SKAN方式重复归因的用户，从而对SKAN原始数据中的激活数据进行去重，并计算出真实的效果指标。
• 衡量维度：
  
  • 收入：衡量应用带来的收入
  • 应用内事件：衡量转化（完成某事件的独立用户数）和/或
    互动（某事件的完成次数）
  • 漏斗：根据一系列有先后顺序的事件组成的漏斗，衡量多个应用内事件。漏斗维度的原理是当用户完成一个漏斗内事件时，即自动视其为完成了该事件之前的所有事件。
  • 优先级：该维度包含收入和/或应用内事件。
  • 预测分析（Predict）：通过先进的机器学习算法，呈现准确的LTV维度投放效果预测分析。我们会对用户级别的KPI预测数据（包括收入和留存率预测）进行加密，然后作为一个转化值发送到SKAN，SKAN会将其上报为一次回传，其中带有广告系列ID和归因来源信息。

原则

• 管理员权限：只有管理员可以保存转化值操作台的设置，账户用户只能查看该设置。
• 任何时刻的在用衡量模式都只有一个。
• 在具体的衡量模式中，AppsFlyer会把基于您的设置生成的衡量对象组合映射到CV值。您可以查看并下载映射表格。
• 在应用侧，AppsFlyer会在每次出现可衡量的用户行为时通过用户首次启动应用时使用的衡量模式设置CV值。
• iOS会先考量转化量是否达到了Apple的群组匿名性阈值（Crowd Anonymity），然后再填充回传里的CV值。
• 在窗口期结束后发生的用户行为不会被记录。
• SKAN面板和报告：

  • SKAN面板的版式和指标取决于具体的衡量模式和配置。

  • 面板版式会根据每天UTC时间凌晨时在用的衡量模式自动更新。一般情况下，您可以在UTC时间05:00前看到更新后的版式。

  • 在SKAN 4的自定义（Custom）和解析（Decode）模式下，应用内事件和总收入的自然量数据不可用。

S2S原理

可衡量的用户行为可以通过服务器到服务器（S2S） API上报。各个模式的S2S适配情况如下：

• SKAN 4及自定义模式（Custom）：S2S总是开启。
• 解析模式：S2S在这个模式下既不适用也不可用，因为该模式下的CV值不是由AppsFlyer设置的。
• 收入、转化和互动模式：在发送事件之前，您必须先打开S2S事件记录开关。

在SKAN 4中，您可以使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度，来设置三个衡量窗口内分别要衡量的对象。您的SKAN 4衡量模式是综合了各种维度后形成的。

如果您从将SKAN模式升级到SKAN 4，则窗口1的配置会沿用您当前使用CV值映射架构。AppsFlyer会自动映射窗口1-3的粗略值。

您可以先探索一下SKAN 4中的各种选项，再手动进行设置。您更改设置时，转化值额度总结会随之更新。您可以通过优化设置，以有限的转化值攫取最有价值的数据。具体请见转化值额度的计算方式。

注意：如果您从将SKAN模式升级到SKAN 4，则细粒度衡量配置会沿用您当前使用CV值映射架构。AppsFlyer会自动映射粗略值。如果您之前没有使用过SKAN，AppsFlyer会提供初始默认映射配置。

请按以下步骤在转化值操作台中使用SKAN 4模式手动设置转化值：

1. 从AppsFlyer面板进入配置 > SKAN 转化值操作台。
2. 点击选项按钮（⋮）查看选项菜单，确认SKAN衡量开关已打开。请注意：如果未打开该开关，则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
3. 选择SKAN 4.0衡量模式。
4. 点击继续。
   界面打开窗口1（1-2天）细粒度CV的设置窗口。
5. 【可选】打开单一可信数据源（SSOT）开关。
   SSOT机制会标出由不同方式重复归因的激活并去重。了解详情
   
6. 点击添加衡量维度，添加各种衡量维度。
   以下章节详细说明了各个设置选项和维度，帮助您探索不同的SKAN衡量设置。
   • 收入
   • 应用内事件
   • 漏斗
   • 优先级
   • 预测
7. 点击粗略值并重复第6-7步，设置窗口1（1-2天）粗粒度CV。
   注意：
   • 仅支持收入和应用内事件衡量维度。
   • Low值必须设置为应用打开（user session），以确保回传得以发送。
8. 【可选】打开锁定窗口开关，并设置条件（事件或粗略值）锁定SKAN窗口，使其短于默认窗口。了解详情
9. 点击窗口2（3-7天）并重复第6-8步，设置窗口2的CV。
   注意：
   • 仅支持收入和应用内事件衡量维度。
   • 【推荐】Low值必须为应用打开（user session）。
10. 点击窗口3（8-35天）并重复第6-8步，设置窗口3的CV。
    注意：
    • 仅支持收入和应用内事件衡量维度。
    • 【推荐】Low值必须为应用打开（user session）。
11. 点击保存。
12. 确认您配置的事件能映射到渠道的应用内事件回传中。

在自定义模式（Custom）中，您可以使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度，来控制衡量的对象。您还可以设置用户行为窗口期，调整衡量的时长及间隔。您可以综合利用这些维度，创建适合自己的自定义衡量模式。

您可以先探索一下自定义模式中的各种选项，再进行设置。您更改设置时，转化值额度总结会随之更新。您可以通过优化设置，以有限的转化值攫取最有价值的数据。具体请见转化值额度的计算方式。

请按以下步骤在转化值操作台中使用自定义模式（Custom）手动设置转化值：

1. 从AppsFlyer面板进入配置 > SKAN 转化值操作台。
2. 点击选项按钮（⋮）查看选项菜单，确认SKAN衡量开关已打开。请注意：如果未打开该开关，则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
3. 选择自定义（Custom）衡量模式。
4. 点击下一步。
   
5. 【可选】打开单一可信数据源（SSOT）开关。
   SSOT机制会标出由不同方式重复归因的激活并去重。了解详情
   
6. 点击添加衡量维度，添加各种衡量维度。
   以下章节详细说明了各个设置选项和维度，帮助您探索不同的SKAN衡量设置。
   • 收入
   • 应用内事件
   • 漏斗
   • 优先级
   • 预测
7. 设置用户行为窗口期（Activity Window，可用范围为12小时-63天），以衡量在此期间发生的用户行为。
   默认的用户行为计时器支持24-72小时的窗口期。默认的间隔设置有12小时和24小时两个选项。您可以使用自定义窗口设置延长用户行为窗口期（最长可达63天）并和间隔时间。
8. 点击保存。
9. 确认您配置的事件能映射到渠道的应用内事件回传中。

在固定模式中，您可以使用以下任一维度衡量用户价值：

• • 收入
  • 转化
  • 互动

您更改衡量模式时，转化值额度总结会随之更新。您可以根据需求调整衡量模式，以有限的转化值攫取最有价值的数据。具体请见转化值额度的计算方式。

请注意：

• 固定模式从用户首次打开应用开始，观测其24小时内的行为。
• 如果您想要通过S2S的方式发送事件数据，需要手动启用SKAN S2S。

请按以下步骤在转化值操作台中使用固定模式手动设置转化值：

1. 从AppsFlyer面板进入配置 > SKAN 转化值操作台。
2. 点击（⋮
   • 确认SKAN衡量开关已打开。请注意：如果未打开该开关，则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
   • 【可选】启用S2S事件发送功能。该功能在收入、转化或互动模式中可用。
3. 选择一个固定衡量模式。
4. 根据下表信息和说明完成选定固定衡量模式的设置。
5. 点击保存。
6. 确认您配置的事件能映射到渠道的应用内事件回传中。

固定衡量模式

在该模式中，您可以自己创建CV-事件映射构架，并在应用中设置CV。该方案适用于无法在应用中接入AppsFlyer SDK的广告主。

解析模式的使用方式如下：

1. 从AppsFlyer面板进入配置 > SKAN 转化值操作台。
2. 点击（⋮
   • 确认SKAN衡量开关已打开。请注意：如果未打开该开关，则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
   • 上传您的解析映射文档。
3. 点击保存。
4. 确认您配置的事件能映射到渠道的应用内事件回传中。

自定义模式中的优先级衡量维度能让您基于自己的业务逻辑对应用中的用户行为链路进行排列，让高优先级衡量覆盖低优先级衡量。这样，您就能为转化漏斗中的每一步都选择最合适的衡量对象。

每个优先级（共63个）都可包含收入和/或应用内事件。当用户完成应用内事件时，AppsFlyer会判断该用户行为对应到哪个优先级，并根据判定结果来设置CV值。

在自定义模式中，不包含优先级与包含优先级的区别如下：不包含优先级时，AppsFlyer会将所有可能的衡量组合映射到CV；包含优先级时，AppsFlyer仅将您明确设置的衡量组合映射到CV。

详情请见优先级示例说明。

优先级的主要原理

• 您可以设置1-63个优先级。可用的优先级个数取决于您的用户行为窗口期以及SSOT（单一可信数据源）设置。
• 优先级1是最高的优先级。优先级的序号数字越大，优先级就越低。
• 一个优先级由收入维度和/或应用内事件维度构成，其中可包含多个应用内事件和收入来源。
• 在优先级中无法使用漏斗维度。但您可以在一个优先级中设置多个应用内事件来衡量某个漏斗中的用户转化。
• 如需使用优先级衡量维度，则不能配置应用内事件或收入等其他维度。

请按以下步骤启用优先级衡量：

1. 从AppsFlyer后台进入SKAN转化值操作台。
2. 选择自定义模式，然后点击继续。
3. 如有必要，请点击删除以清除当前设置。
4. 点击+ 添加衡量维度。选择优先级。
   界面显示优先级1。
   

   

5. 从以下衡量维度中选择一个：
   • 收入
   • 应用内事件
6. 按界面提示填写相关字段。
   • 请注意：一个优先级中可以包含收入和/或应用内事件。
   • 事件发生次数以及收入的范围值可以设置为升序或降序，但各个区间之间必须是连续的，如1-5、5-8、8-10等等。同一个收入范围可以重复使用，但第二次使用时必须与上一个优先级中的范围相同，且其所在优先级必须是一个独立的事件组合。如1-5、1-5 + add to cart（加购）。
     另请参考升序和降序收入范围示例。

     事件	发生次数	收入
     P1 event_a	2-3	$5 - $50
     P2 event_a	2-3	$0-$5
     P3 event_a	1-2	$5 - $50
     P4 event_a	1-2	$0-$5
     P5 event_a	0-1	$5 - $50
     P6 event_a	0-1	$0-$5

7. 点击验证。
   界面显示消息“Priority is valid”（优先级有效）。如果没有显示该消息，请先更正您的优先级设置，然后再进行下一步操作。
8. 请执行以下任一操作：
   
   • 如需添加新的优先级，请点击+ 添加优先级。当前的优先级1会下移至优先级2。请按上文所述步骤完成优先级设置。
   • 如需删除一个优先级，请点击… > 删除。
   • 如需更改优先级，请点击选项（⋮），然后选择更改顺序或改为最低优先级。
   • 如需创建优先级副本，请点击选项（⋮），然后选择创建副本。
   • 点击保存，完成优先级设置。

请注意：锁定窗口功能仅适用于SKAN 4及以上版本。

注意：

• 用户行为窗口期仅适用于SKAN 3及以下版本（即自定义模式和固定模式）。
• 如果您启用了SKAN 4+，但用户设备或广告平台尚不支持SKAN 4，则用户行为窗口期自动设置为48小时。

• 选择具体CV值后，您可以在表格下方看到映射到该CV值的事件。
• 点击下载映射文件，就能下载CSV格式的CV映射表。
• 您也可以使用广告主的SKAN CV映射构架API获取CV映射信息。

CV映射文件各列说明

如上文所述，您最多可以使用64个转化值。您可以使用以下公式来计算某个衡量模式下的转化值消耗数量。

(activity time duration in hours / interval size in hours) * 
(number of revenue ranges + 1 ) * 
(number of in-app event ranges + 1 ) * 
(number of steps in a funnel + 1)

请根据实际添加的衡量维度数量来调整公式。

示例 1

示例 2

示例3

示例4

广告主希望在自己的购物应用中重点衡量以下内容：

• 非付费用户的行为
• 付费用户的收入

这样，广告主就能利用CV更精准地记录收入。上述衡量目标可转化为下表所列的一系列衡量优先级。

这里需要注意以下几点：

• 最高的优先级永远是1。注意：优先级的序号不直接对应到CV值。CV值的映射按界面显示为准。
• 您最多可以设置63个优先级。实际的优先级数量上限取决于用户行为窗口期以及SSOT的使用状态。
• 每个优先级可包含收入范围和/或应用内事件发生次数范围。
• 范围值：范围中不包含其最小值，但包含最大值。比如在$5-$10这个范围中，不包含5，但包含10。

优先级设置示例

下表列出了用户链路场景。每个场景都包含了在用户链路中发生的一系列行为以及由AppsFlyer判定的优先级。

表格说明：

• 用户行为之间以 > 隔开。
• 括号中的值指用户行为发生后由AppsFlyer判定的优先级。AppsFlyer会根据该优先级来更新应用中的CV。

用户链路场景

示例A：收入模式

示例B：转化模式

示例C：互动模式

如果您想要为多个应用配置相同的SKAN转化值映射，这时在转化值操作台中为每个应用分别设置映射构架不仅费时费力，而且操作起来也很麻烦。这种情况下，您可以使用SKAN Conversion Studio API来减轻相关的工作量。只需在转化值操作台的面板中完成一个SKAN映射构架的配置，然后即可通过该API让这个构架在多个应用中生效。请注意：该API仅支持通过转化值操作台面板的SKAN 4或自定义模式配置的映射构架（但不支持这两个模式中的预测维度）。

SKAN Conversion Studio API的使用方法如下：

1. 获取API token。请注意，该步骤必须由账户管理员完成。
2. 将该API token发送给您的开发人员，在认证头（Authentication Header）中使用。
3. 请将以下应用的ID发给您的开发人员：
   • 已在面板中配置了SKAN映射构架的应用（后续要将这个应用的SKAN映射构架复制到其他应用）
   • 需要使用这个SKAN映射构架的所有应用。
4. 让您的开发人员按照开发者资源中心的SKAN Conversion Studio API使用指南

注意：

• 调用该API时，一次仅可将相关映射构架复制到一个应用中。但您也可以让开发人员创建一个脚本，用于将所需的映射构架复制到多个应用中。
• 代理无法使用SKAN Conversion Studio API。

注意事项：

• 启用SKAN 4衡量模式后，就无法再恢复到之前的模式。
• 更改后的设置会在UTC时间00:00 AM生效，此后有一段过渡期，在此期间AF会根据更改后的设置来解析转化值，但有时在更改后接收到的回传数据中实际包含的是更改前的激活。
• 更改设置不会影响上报的激活数量，该数据保持准确。

请按以下步骤关闭SKAN衡量：

1. 从AF后台进入配置 > SKAN转化值操作台。
2. 点击 ⋮ 图标。
3. 关闭SKAN衡量。
   SDK会停止调用registerAppForAdNetworkAttribution和updateConversionValue等功能。
4. 点击保存更改。

SDK和S2S API都可以向AppsFlyer服务器发送应用内事件。

S2S的数据发送链路如下：

• 广告主服务器中的用户完成了一个事件。此时的应用可能是打开的，也可能是关闭的。
• 广告主服务器通过S2S向AppsFlyer上报该事件。
• AppsFlyer计算更新后的转化值，然后：
  • 如果应用在用户设备上处于打开状态：SDK会收到更新后的转化值，并更新设备的iOS转化值。
  • 如果应用在用户设备上处于关闭状态：服务器会等到应用打开后再向SDK发送转化值，但应用必须在用户行为窗口期结束前打开，否则该事件会流失。

SDK版本要求

• 请在应用中接入最新版本的SDK。请注意：这里无需开发人员进行任何操作。

请按以下步骤启用S2S API的应用内事件发送：

1. 请执行以下任一操作：
   
   • 如果您选择了SKAN 4或自定义（Custom）衡量模式：
     • 无需更改设置。
   • 如果您选择了收入、转化或互动模式：
     1. 从AF后台进入配置 > SKAN转化值操作台。
     2. 点击（⋮）选项图标。
     3. 打开通过S2S API记录应用内事件的开关。
2. 通过S2S发送事件。

限制

• 如果您对用户启用了匿名化功能，则无法通过S2S发送该用户的事件。

如果您设置了收入或互动衡量模式，则单一可信数据源（即SSOT，该机制可对数据去重并准确地上报iOS数据）默认处于关闭状态。详情请见SSOT指南

如果您已设置了收入或互动模式，可以按以下方式启用SSOT：

1. 从AF后台进入配置 > SKAN转化值操作台。
2. 向下滚动到您正在使用中的衡量模式。
3. 点击 + 添加单一可信数据源。
   • 单一可信数据源开关自动打开。
   • SSOT开启后衡量模式中的范围会自动调整，这是为了给SSOT留出一定的转化值空间。
4. 点击保存。