概要:本文重点说明了如何通过SKAN转化值操作台设置您想要衡量的用户互动类型以及衡量时长。您可以在用户激活后的一定时间内衡量收入、转化、互动以及留存。您还可以通过单一可信数据源(SSOT)的衡量方式查看用户是否同时被AppsFlyer和SKAN归因。
SKAN转化值操作台基础操作指南
在SKAN的归因链路中,iOS设备会在每个衡量窗口结束后发送SKAN回传数据,其中包含最近更新的转化值(conversion value,简称CV)。
在SKAN 3及以下版本中,iOS会在最初的用户行为窗口期(Activity Window)结束后发送1次回传。用户行为窗口期的范围可为12小时-63天不等。CV值不能超过6比特,也就是说最多只能有64个CV值(即0-63)。
在SKAN 4中共有3次回传,对应3个窗口期,每个窗口期结束后即发送一次回传。这3个窗口期的时长依次为2天、7天和35天,其回传数据的规则如下:
- 窗口1的细粒度CV不超过6比特,也就是说最多可以有64个CV值(即0-63)。
- 窗口1-3的粗粒度CV值只能是low、medium或high。(窗口2和3没有细粒度CV)。
这些CV限制出台后,广告主不得不在衡量对象上做出一些取舍,以充分利用64个细粒度CV值和3个粗粒度CV值。
转化值操作台的可配置性极高,可细化到每一个值、每一位比特,便于广告主充分利用SKAN回传。您可以精确设置CV中需要对哪些数据进行加密以用于衡量,比如在激活后要衡量多长时间内的哪些用户行为。我们提供多个衡量模式,用于CV值的配置。
类型 | 衡量模式 | 说明 | 用户行为窗口期 |
---|---|---|---|
可配置 |
【推荐】 【默认】 |
针对3个可配置的衡量窗口期,分别设置收入、转化(应用内事件)和互动的衡量方式。 这3个窗口的时间段不能互相重叠。也就是说,窗口2衡量的是激活后3-7天内的数据,而不是0-7天内的数据。 |
|
可配置 | 自定义 | 在可配置的用户行为窗口期内设置收入、转化(应用内事件)和互动的衡量方式 | 12-1512小时(默认最长72小时,但可以延长) |
固定* |
收入 【历史版本】 |
在下列区间中任选一个,用以衡量收入:
|
24小时 |
固定* |
转化 【历史版本】 |
选择1-6个应用内事件 | 24小时 |
固定* |
广告交互 【历史版本】 |
用户完成某一事件的次数 | 24小时 |
可配置 | Decode(解析) |
|
12-1512小时(63天) |
*自2024年6月23日起,固定模式不再对新增应用开放。 AppsFlyer通过自定义模式和SKAN 4模式支持所有相关功能。
小贴士:您可以从AF后台进入配置 > SKAN转化值操作台,探索一下转化值操作台的界面和功能。
衡量原理及定义
定义
-
SKAN衡量窗口适用于SKAN 4+。用户激活应用后共有3个窗口期,用于衡量用户行为,分别是:
- 窗口1(Window 1):1-2天
- 窗口2(Window 2):3-7天
- 窗口3(Window 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值有精细值和粗略值两种。
- SKAN 4+中的CV值有精细值和粗略值两种。
- 转化值额度:映射您的设置所需要的CV值数量。您在设置中选择的衡量维度和衡量元素越多,需要消耗的转化值就越多。您每添加一个范围或设置元素,转化值额度的消耗量就会随之变高(在单个维度中每添加一个设置单元,转化值消耗度就会呈指数增长)。具体请见转化值耗尽示例。
- 单一可信数据源(SSOT):这是一种标识机制,用于说明相关流量的归因方式(即SKAN或其他匹配方式)。您可以使用这一机制对SKAN原始数据中的激活进行排重,并计算出真实的投放效果指标
-
衡量维度:
- 收入:用于衡量相关应用带来的收入
-
应用内事件:用于衡量转化(完成某一事件的独立用户数量)和/或
互动(某一事件的发生次数)。 - 漏斗:您可以根据一系列有先后顺序的事件组成的漏斗来衡量应用内事件。用户在漏斗中执行的任何事件都将被视为已执行该事件之前的所有事件。
- 优先级:该维度包含收入和/或应用内事件。
原理
-
管理员权限:只有管理员可以保存转化值操作台的设置,账户用户只能查看该设置。
- 任何时刻的在用衡量模式都只有一个。
- 在具体的衡量模式中,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总是开启。
- 解析模式(Decode):S2S在这个模式下既不适用也不可用,因为该模式下的CV值不是由AppsFlyer设置的。
- 【历史版本】收入、转化和互动模式:在发送事件之前,您必须先打开S2S事件记录开关。
在SKAN转化值操作台中设置转化值
SKAN转化值操作台提供多种衡量模式,用于设置转化值:
- SKAN 4:使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度,来设置三个衡量窗口内分别要衡量的对象。
- 自定义模式(Custom):使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度,来设置用户行为窗口期内的衡量对象。
- 【历史版本】固定模式:使用以下任一维度衡量用户价值:
- 收入
- 转化
- 广告交互
下文分章节介绍了各种不同的衡量模式。
重要提示!
只有AF账户的管理员或者在SKAN转化值操作台中具有管理权限的用户才能在SKAN转化值操作台中设置转化值。
请按以下步骤查看或更改用户权限:
- 进入AF后台,点击右上角的邮箱地址。
- 点击用户管理 > 选择具体用户。
- 根据实际需要向相关用户开放SKAN转化值操作台的管理权限。另请参考用户管理,了解其他的权限设置。
SKAN 4
在SKAN 4模式中,您可以使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度,来设置三个衡量窗口内分别要衡量的对象。您可以综合利用这些维度,创建适合自己的自定义衡量模式。
如果您从之前的SKAN模式升级到SKAN 4,则窗口1的配置会沿用您当前使用CV值映射架构。AppsFlyer会自动映射窗口1-3的粗略值。
如需手动配置SKAN 4,建议您先探索一下SKAN 4中的各种选项。您更改配置时,转化值额度总结也会随之更新。您可以通过优化设置,以有限的转化值攫取最有价值的数据。详情请见转化值额度的计算方式。
请注意:如果您从之前的SKAN模式升级到SKAN 4,则SKAN 4中的细粒度衡量配置会沿用您当前使用的CV值映射架构。AppsFlyer会自动映射粗略值。如果您之前没有使用过SKAN,AppsFlyer会提供初始默认映射配置。
请按以下步骤在转化值操作台中使用SKAN 4模式手动设置转化值:
- 从AppsFlyer面板进入配置 > SKAN转化值操作台。
- 点击选项按钮(⋮)查看选项菜单,确认SKAN衡量开关已打开。请注意:如果未打开该开关,则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
- 选择SKAN 4.0衡量模式。
- 点击继续,进入下一步。
界面打开窗口1(1-2天)细粒度CV的设置窗口。 - 【可选】打开单一可信数据源(SSOT)开关。
SSOT机制会标出由不同方式重复归因的激活并去重。了解详情
- 点击添加衡量维度,添加各种衡量维度。
以下章节详细说明了各个设置选项和维度,帮助您探索不同的SKAN衡量设置:- 收入
- 应用内事件
- 漏斗
- 优先级
- 点击粗略值并重复第6-7步,设置窗口1(1-2天)粗粒度CV。
请注意:- 仅支持收入和应用内事件衡量维度。
- Low值必须设置为应用打开(user session),以确保回传得以发送。
- 【可选】打开锁定窗口开关,并设置条件(事件或粗略值)锁定SKAN窗口,使其短于默认窗口。了解详情
- 点击窗口2(3-7天)并重复第6-8步,设置窗口2的CV值。
请注意:- 仅支持收入和应用内事件衡量维度。
- 【推荐】Low值必须设置为应用打开(user session)。
- 点击窗口3(8-35天)并重复第6-8步,设置窗口3的CV值。
请注意:- 仅支持收入和应用内事件衡量维度。
- 【推荐】Low值必须设置为应用打开(user session)。
- 点击保存。
- 确认您配置的事件能映射到渠道的应用内事件回传中。
自定义
在自定义模式(Custom)中,您可以使用收入、应用内事件、优先级和单一可信数据源等不同的衡量维度,来控制衡量的对象。您还可以设置用户行为窗口期,调整衡量的时长及间隔。您可以综合利用这些维度,创建适合自己的自定义衡量模式。
如需配置自定义模式(Custom),建议您先探索一下其中的各种选项。您更改配置时,转化值额度总结也会随之更新。您可以通过优化设置,以有限的转化值攫取最有价值的数据。详情请见转化值额度的计算方式。
请按以下步骤在转化值操作台中使用自定义模式(Custom)手动设置转化值:
- 从AppsFlyer面板进入配置 > SKAN转化值操作台。
- 点击选项按钮(⋮)查看选项菜单,确认SKAN衡量开关已打开。 请注意:如果未打开该开关,则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
- 选择自定义(Custom)衡量模式。
- 点击继续,进入下一步。
- 【可选】打开单一可信数据源(SSOT)开关。
SSOT机制会标出由不同方式重复归因的激活并去重。了解详情
- 点击添加衡量维度,添加各种衡量维度。
以下章节详细说明了各个设置选项和维度,帮助您探索不同的SKAN衡量设置:- 收入
- 应用内事件
- 漏斗
- 优先级
- 设置用户行为窗口期(Activity Window,可用范围为12小时-63天),以衡量在此期间发生的用户行为。
默认的用户行为计时器支持24-72小时的窗口期。默认的间隔设置有12小时和24小时两个选项。您可以使用自定义窗口设置延长用户行为窗口期(最长可达63天)并和间隔时间。 - 点击保存。
- 确认您配置的事件能映射到渠道的应用内事件回传中。
【历史版本】固定模式
注意
自2024年6月23日起,固定模式不再对新增应用开放。 AppsFlyer通过自定义模式和SKAN 4模式支持所有相关功能。
在固定模式中,您可以使用以下任一维度衡量用户价值:
-
- 收入
- 转化
- 广告交互
您更改配置时,转化值额度总结也会随之更新。您可以通过优化设置,以有限的转化值攫取最有价值的数据。详情请见转化值额度的计算方式。
请注意:
- 固定模式从用户首次打开应用开始,观测其24小时内的行为。
- 如果您想要通过S2S的方式发送事件数据,需要手动启用SKAN S2S。
请按以下步骤在转化值操作台中使用固定模式手动设置转化值:
- 从AppsFlyer面板进入配置 > SKAN转化值操作台。
- 点击(⋮
- 确认SKAN衡量开关已打开。 请注意:如果未打开该开关,则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
- 【可选】启用S2S事件发送功能。该功能在收入、转化或互动模式中可用。
- 选择一个固定衡量模式。
- 根据下表信息和说明完成选定固定衡量模式的设置。
- 点击保存。
- 确认您配置的事件能映射到渠道的应用内事件回传中。
固定衡量模式
衡量模式 | 说明 |
---|---|
[默认]收入 |
在24小时的窗口期内产生的收入 从以下三个收入范围(货币为美元,最小单位为低线值)中选择一个:
AppsFlyer会自动填充收入衡量范围中的63个值,确保将名为“ 可用指标:
|
转化 |
在24小时的用户行为窗口期内至少发生过一次的应用内事件 设置:
分应用内事件的指标:
可衡量的用户行为包括:
请注意: 转化衡量用于判断用户是否完成了某个事件,如果您需要了解某个事件的完成次数,请使用互动衡量。 |
广告交互 |
在用户行为窗口期内指定事件的发生次数 设定:
应用内事件指标:
如
|
Decode(解析)
在该模式中,您可以自己创建CV-事件映射构架,并在应用中设置CV。该方案适用于无法在应用中接入AppsFlyer SDK的广告主。
解析模式的使用方式如下:
- 从AppsFlyer面板进入配置 > SKAN转化值操作台。
- 点击(⋮
- 确认SKAN衡量开关已打开。 请注意:如果未打开该开关,则SDK不会调用registerAppForAdNetworkAttribution和updateConversionValue等SKAN功能。
- 上传您的解析映射文档。
- 点击保存。
- 确认您配置的事件能映射到渠道的应用内事件回传中。
衡量维度
单一可信数据源(SSOT)
Single Source of Truth(单一可信数据源,简称SSOT)机制会标出由不同方式重复归因的激活并去重。这里的“不同归因方式”分为SKAN及非SKAN方式。您可以在SKAN原始数据报告看到该标签,该标签也会用于计算总览面板SSOT视图中的指标。 | |
是否必须配置 | 否 |
能否设置多个 | 否 |
设置选项 |
如果您启用了SSOT,则可以通过CV值标记出由SKAN和非SKAN方式重复归因的用户。 SSOT标签用于以下场景:
|
应用内事件维度
是否必须配置 | 否 | ||||||||||||||||||||
能否设置多个 | 是 | ||||||||||||||||||||
设置选项 | 选择一个应用内事件,然后根据您的衡量目标设置范围,具体如下:
|
||||||||||||||||||||
用于衡量互动的范围 |
您必须先创建事件发生次数的范围,才能衡量互动。选定的互动事件发生时,SKAN会根据发生的次数将该事件与对应的范围相关联。 说明
通过范围衡量互动
举例来说, 上图显示了以下三个事件次数范围: 事件次数范围设置如下:
事件发生次数是根据这几个范围来记录的,具体如下:
|
||||||||||||||||||||
局限性 | 一个应用内事件只能与该维度关联一次。 |
收入维度
是否必须配置 | 否 | ||||||||||||||||||||
能否设置多个 | 是(即分收入来源记录应用内事件收入) | ||||||||||||||||||||
设置选项 |
您可以通过单个事件来记录收入,也可以按收入来源将收入关联到指定的应用内事件。 您可以使用的收入来源选项有以下几种:
|
||||||||||||||||||||
范围 |
您必须先创建收入范围才能衡量收入,因为在记录收入时,SKAN会将SDK上报的收入关联到对应的范围。 说明
按范围记录收入
举例来说, 上图显示了以下三个收入范围:
收入是根据这几个范围来记录的,具体如下:
|
漏斗维度
| |||||||||||||
是否必须配置 | 否 | ||||||||||||
能否设置多个 | 否 | ||||||||||||
设置选项 | 形成漏斗的一系列有先后顺序的事件。由于该逻辑将单个事件的发生次数视为漏斗内之前所有事件的发生次数,因此请务必认真谨慎地设置事件漏斗,具体请参考下表示例。 | ||||||||||||
示例 | 假设一个漏斗中包含a、f、b、k和z五个事件,如下所示。
|
优先级衡量维度
自定义模式中的优先级衡量维度能让您基于自己的业务逻辑对应用中的用户行为链路进行排列,让高优先级衡量覆盖低优先级衡量。这样,您就能为转化漏斗中的每一步都选择最合适的衡量对象。
每个优先级(共63个)都可包含收入和/或应用内事件。当用户完成应用内事件时,AppsFlyer会判断该用户行为对应到哪个优先级,并根据判定结果来设置CV值。
在自定义模式中,不包含优先级与包含优先级的区别如下:不包含优先级时,AppsFlyer会将所有可能的衡量组合映射到CV;包含优先级时,AppsFlyer仅将您明确设置的衡量组合映射到CV。
详情请见优先级示例说明。
优先级的主要原理
- 您可以设置1-63个优先级。可用的优先级个数取决于您的用户行为窗口期以及SSOT(单一可信数据源)设置。
- 优先级1是最高的优先级。优先级的序号数字越大,优先级就越低。
- 一个优先级由收入维度和/或应用内事件维度构成,其中可包含多个应用内事件和收入来源。
- 在优先级中无法使用漏斗维度。但您可以在一个优先级中设置多个应用内事件来衡量某个漏斗中的用户转化。
- 如需使用优先级衡量维度,则不能配置应用内事件或收入等其他维度。
请按以下步骤启用优先级衡量:
- 从AppsFlyer后台进入SKAN转化值操作台。
- 选择自定义模式,然后点击继续。
- 如有必要,请点击删除以清除当前设置。
- 点击+ 添加衡量维度。 选择优先级。
界面显示优先级1。 - 从以下衡量维度中选择一个:
- 收入
- 应用内事件
- 按界面提示填写相关字段。
- 请注意:一个优先级中可以包含收入和/或应用内事件。
- 事件发生次数以及收入的范围值可以设置为升序或降序,但各个区间之间必须是连续的,如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
- 点击验证。
界面显示消息“Priority is valid”(优先级有效)。如果没有显示该消息,请先更正您的优先级设置,然后再进行下一步操作。 - 此时可完成以下任一操作:
- 如需添加新的优先级,请点击+ 添加优先级。 当前的优先级1会下移至优先级2。请按上文所述步骤完成优先级设置。
- 如需删除一个优先级,请点击… > 删除。
- 如需更改优先级,请点击选项(⋮),然后选择更改顺序或改为最低优先级。
- 如需创建优先级副本,请点击选项(⋮),然后选择创建副本。
- 点击保存,完成优先级设置。
锁定窗口
请注意:锁定窗口功能仅适用于SKAN 4及以上版本。
使用 | 默认的SKAN窗口期指用户激活后特定的几段时间,在此期间iOS会衡量用户价值。您可以锁定这几个窗口期,使其短于默认窗口期,让iOS提前将当下所有可用数据的回传发送给您。如需锁定窗口,需要先设置锁定条件。 |
是否必须配置 | 否 |
能否设置多个 | 是的,每个SKAN窗口都可以锁定 |
条件选项 | SKAN窗口的锁定条件有两种选项:
|
锁定窗口后的影响 | SKAN回传不包含窗口期结束时间,所以计算激活时间时不考虑窗口的锁定状态,因此使窗口期提前结束会影响激活时间估算的准确性。 |
用户行为窗口期
请注意:
- 用户行为窗口期仅适用于SKAN 3及以下版本(即自定义模式和固定模式)。
- 如果您启用了SKAN 4+,但用户设备或广告平台尚不支持SKAN 4,则用户行为窗口期自动设置为48小时。
是否必须配置 | 是 |
能否设置多个 | 否 |
时间特征 |
|
时长 |
|
间隔 |
12或24小时。间隔会影响末次互动时间范围以及激活时间的准确性。其他选项请见本表中的可调节的衡量窗口部分。 您可以在原始数据报告的min_install_time和max_install_time这两列中查看末次互动时间范围,该指标用于确定激活时间(见下文)。 举例来说,
|
激活时间 |
激活时间的推算方法如下: 激活时间 = 回传数据接收时间 -[平均末次互动范围] - [iOS回传延时]
|
设置选项 | 用户行为窗口期的设置包含时长和间隔两个方面。
|
更改用户行为窗口期时长的影响 |
|
与广告平台相关的因素 |
|
范围设置要求示例 | 上图显示了以12小时为间隔、总时长为60小时的计时器。 |
可调用户行为窗口期选项 |
您可以使用可调衡量选项将用户行为窗口期设置得更长,且窗口期可以以小时为单位。间隔的设置也是如此。可调衡量设置具有以下特点:
请注意:用户行为窗口期必须可以被间隔时间整除。 推荐方法:间隔时间最好不要超过24小时,否则会影响激活时间推算的准确性。 |
其他相关信息
查看CV值映射
- 选择具体CV值后,您可以在表格下方看到映射到该CV值的事件。
- 点击下载映射文件,就能下载CSV格式的CV映射表。
- 您也可以使用广告主的SKAN CV映射构架API获取CV映射信息。
CV映射文件各列说明
栏位 | 说明 |
---|---|
app_id | |
conversion_value | CV值:
|
event_name | |
min_event_counter | 事件发生次数范围的低线值 |
max_event_counter |
|
min_event_revenue | 事件收入范围的低线值(单位为美元) |
max_event_revenue |
|
min_time_post_install | 激活后小时数(即用户最后一次与应用互动是在激活后的第几个小时)的低线值 |
max_time_post_install | 激活后小时数(即用户最后一次与应用互动是在激活后的第几个小时)的高线值 |
last_config_change | 您在SKAN转化值操作台中保存配置的日期 |
转化值消耗度的计算方式
如上文所述,您最多可以使用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)
请根据实际添加的衡量维度数量来调整公式。
自定义模式下CV值完全消耗示例
示例 1
组成部分 | 说明 |
---|---|
用户行为窗口期 |
|
收入 |
|
应用内事件 | 无 |
漏斗 | 3个应用内事件 |
示例 2
组成部分 | 说明 |
---|---|
用户行为窗口期 |
|
收入 |
|
转化事件 | 1个用于衡量转化的应用内事件,每个事件配有1个范围 |
漏斗 | 无 |
示例3
组成部分 | 说明 |
---|---|
用户行为窗口期 |
|
收入 |
|
互动事件 |
|
漏斗 | 无 |
示例4
组成部分 | 说明 |
---|---|
用户行为窗口期 |
|
收入 |
|
转化事件 | 1个用于衡量转化的应用内事件,需配置1个范围 |
漏斗 | 无 |
优先级衡量示例说明
广告主希望在自己的购物应用中重点衡量以下内容:
- 非付费用户的行为
- 付费用户的收入
这样,广告主就能利用CV更精准地记录收入。上述衡量目标可转化为下表所列的一系列衡量优先级。
这里需要注意以下几点:
- 最高的优先级永远是1。请注意:优先级的序号不直接对应到CV值。CV值的映射按界面显示为准。
- 您最多可以设置63个优先级。实际的优先级数量上限取决于用户行为窗口期以及SSOT的使用状态。
- 每个优先级可包含收入范围和/或应用内事件发生次数范围。
- 范围值:范围中不包含其最小值,但包含最大值。比如在$5-$10这个范围中,不包含5,但包含10。
优先级设置示例
优先级序号 | 收入范围 | 应用内事件 |
---|---|---|
1【最高优先级】 | $5-$10 | send_recommendation |
2 | $5-$10 | -- |
3 | $0-$5 | send_recommendation |
4 | $0-$5 | -- |
5 | -- | send_recommendation add_to_cart |
6 | -- | send_recommendation |
7【最低优先级】 | -- | add_to_cart |
-- 未设置值 |
下表列出了用户链路场景。每个场景都包含了在用户链路中发生的一系列行为以及由AppsFlyer判定的优先级。
表格说明:
- 用户行为之间以 > 隔开。
- 括号中的值指用户行为发生后由AppsFlyer判定的优先级。AppsFlyer会根据该优先级来更新应用中的CV。
用户链路场景
用户链路场景 | 用户行为及优先级 |
---|---|
A | add_to_cart (7) |
B | add_to_cart (7) > send_recommendation (5) |
C | Purchase $3 (4) |
D | Purchase $6 (2) |
E | Purchases $6 (2) > send_recommendation (1) |
【历史版本】固定模式示例
注意
自2024年6月23日起,固定模式不再对新增应用开放。AppsFlyer通过自定义模式和SKAN 4模式支持所有相关功能。
示例A:衡量收益
考量因素 | 说明 |
---|---|
场景 |
|
SKAN配置 |
|
指标选择 | 与收入相关的可用指标
|
各报告中的原始数据行数 |
您可以通过Data Locker拉取原始数据报告
|
开发侧注意事项 | 带着金额的事件会被记录到 |
示例B:衡量转化
考量因素 | 说明 | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
示例 |
各用户完成的应用内事件
|
|||||||||||||||||||||||||
SKAN归因配置 | 选择衡量类型:转化
|
|||||||||||||||||||||||||
指标选择 |
与应用内事件相关的可用指标
|
|||||||||||||||||||||||||
您可以通过Data Locker拉取原始数据报告
|
||||||||||||||||||||||||||
开发侧注意事项 |
|
示例C:衡量事件
考量因素 | 说明 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
示例 | 5个用户激活应用后分别打开应用若干次,具体如下: App opens(应用打开)
|
||||||||||||
SKAN归因配置 |
|
||||||||||||
指标选择 | 该场景中的可用指标:
|
||||||||||||
各报告中的原始数据行数 |
您可以通过Data Locker拉取原始数据报告
|
||||||||||||
开发侧注意事项 | 用户每次完成选定的互动事件后,应用侧都需要发送应用内事件,因为SKAN会记录事件发送的次数。 |
SKAN Conversion Studio API
如果您想要为多个应用配置相同的SKAN转化值映射,这时在转化值操作台中为每个应用分别设置映射构架不仅费时费力,而且操作起来也很麻烦。这种情况下,您可以使用SKAN Conversion Studio API来减轻相关的工作量。只需在转化值操作台的面板中完成一个SKAN映射构架的配置,然后即可通过该API让这个构架在多个应用中生效。请注意:该API仅支持通过转化值操作台面板的SKAN 4或自定义模式配置的映射构架。
SKAN Conversion Studio API的使用方法如下:
- 获取API token。只有账户管理员才能获取该token。
- 将该API token发送给您的开发人员,用于认证头(Authentication Header)中。
- 请将以下应用的ID发给您的开发人员:
- 已在面板中配置了SKAN映射构架的应用(后续要将这个应用的SKAN映射构架复制到其他应用)
- 需要使用这个SKAN映射构架的所有应用。
- 让您的开发人员按照开发者资源中心的SKAN Conversion Studio API使用指南
请注意:
- 调用该API时,一次仅可将相关映射构架复制到一个应用中。但您也可以让开发人员创建一个脚本,用于将所需的映射构架复制到多个应用中。
- 代理无法使用SKAN Conversion Studio API。
其他操作
切换SKAN衡量模式
这里需要注意以下几点:
- 启用SKAN 4衡量模式后,建议不要再切换到之前的模式。
- 更改后的设置会在UTC时间00:00 AM生效,此后有一段过渡期,在此期间AF会根据更改后的设置来解析转化值,但有时在更改后接收到的回传数据中实际包含的是更改前的激活。
- 更改设置不会影响上报的激活数量,该数据保持准确。
停用SKAN衡量
请按以下步骤关闭SKAN衡量:
- 从AF后台进入配置 > SKAN转化值操作台。
- 点击 ⋮ 图标。
- 关闭SKAN衡量。
SDK会停止调用registerAppForAdNetworkAttribution和updateConversionValue等函数。 - 点击保存更改。
通过S2S API上报事件
SDK和S2S API都可以向AppsFlyer服务器发送应用内事件。
S2S的数据发送链路如下:
- 广告主服务器中的用户完成了一个事件,此时的应用可以是打开的,也可以是关闭的。
- 广告主服务器通过S2S向AppsFlyer上报该事件。
- AppsFlyer计算更新后的转化值,然后:
- 如果应用在用户设备上处于打开状态:SDK会收到更新后的转化值,并更新设备的iOS转化值。
- 如果应用在用户设备上处于关闭状态:服务器会等到应用打开后再向SDK发送转化值,但应用必须在用户行为窗口期结束前打开,否则该事件会流失。
SDK版本要求
- 请在应用中接入最新版本的SDK。请注意:这里无需开发人员进行任何操作。
请按以下步骤启用S2S API的应用内事件发送:
- 此时可完成以下任一操作:
- 如果您选择了SKAN 4或自定义(Custom)衡量模式:
- 无需更改设置。
- 如果您选择了收入、转化或互动模式:
- 从AF后台进入配置 > SKAN转化值操作台。
- 点击(⋮)选项图标。
- 打开通过S2S API记录应用内事件的开关。
- 如果您选择了SKAN 4或自定义(Custom)衡量模式:
- 通过S2S发送事件。
局限性
- 如果您对用户启用了匿名化功能,则无法通过S2S发送该用户的事件。
在固定衡量模式中添加SSOT
注意
自2024年6月23日起,固定模式不再对新增应用开放。AppsFlyer通过自定义模式和SKAN 4模式支持所有相关功能。
如果您设置了收入或互动衡量模式,则单一可信数据源(即SSOT,该机制可对数据去重并准确地上报iOS数据)默认处于关闭状态。详情请见SSOT指南
如果您已设置了收入或互动模式,可以按以下方式启用SSOT:
- 从AF后台进入配置 > SKAN转化值操作台。
- 向下滚动到您正在使用中的衡量模式。
- 点击 + 添加单一可信数据源。
- 单一可信数据源开关自动打开。
- SSOT开启后衡量模式中的范围会自动调整,这是为了给SSOT留出一定的转化值空间。
- 点击保存。
转化值降低
在SKAN 4模式中,您可以选择让转化值(CV)升高或降低。默认设置下,CV值仅可升高。允许转化值降低后,发送负向的收入时,相关窗口期内的回传中会包含最新值(而非最高值),即使之前出现过更高的值。三个窗口期内产生的所有精细值和粗略值都会消耗转化值额度。
请注意:广告收入永远不会出现负值。
如需将转化值设置为允许降低,请按以下方式操作:
- 从AF后台进入配置 > SKAN转化值操作台。
- 选择SKAN 4.0衡量模式。
- 点击(⋮)选项图标,界面会显示选项菜单。
- 请确保允许转化值降低的开关已打开。
请注意!必须符合以下条件才能够使用该开关:- 进行操作之前,相关应用已保存在转化值操作台的SKAN 4模式中
- 进行操作的用户具有编辑权限
- 请确保允许转化值降低的开关已打开。
示例
负向收入示例
CV | 收入 | 应用内事件 |
---|---|---|
3 | $20 - $30 | |
2 | $10 - $20 | af_add_to_cart |
1 | $0 - $10 | |
0 | 不适用 | install |
示例1
用户完成了一个价值5美元的购买事件 - 这时CV 1会上升。
之后,该用户又完成了一个价值20美元的购买事件 - 这时CV 3会上升。
然后,该用户完成了一个价值为-10美元的购买事件 - 这时CV 1会下降。
然后,该用户完成了一个add_too_cart(加购)事件 - 这时CV 2会上升。
示例 2
用户完成了一个价值25美元的购买事件 - 这时CV 3会上升。
然后该用户触发了af_add_to_cart事件 - 该事件会留在CV 3中。
然后,该用户完成了一个价值为-20美元的购买事件 - 这时CV 1会下降。
应用内事件架构示例
CV | 应用内事件 |
---|---|
3 | af_purchase |
2 | af_add_to_cart |
1 | session |
0 | install |
示例
用户完成了一个session(应用打开) - 这时CV 1会上升
该用户随后完成了一个购买事件 - 这时CV 3会上升
然后,该用户又完成了一个session(应用打开) - 这时CV
支持匿名用户
打开支持匿名用户的开关后,可在保护匿名用户隐私的同时,确保其SKAN转化值得到准确的更新。
重要提示!
这一功能仅适用于通过用户匿名化方法对所有用户的身份识别信息进行移除和加密的应用。对于这类应用,如需确保SKAN数据的准确性,必须打开支持匿名用户开关。
该功能的必要性
SKAN根据激活后的用户行为,通过标识符来更新转化值。如果某个应用在调用start方法之后调用了用户匿名化方法,系统就无法将部分激活后事件关联到初始的激活,导致转化值更新不准确。
打开支持匿名用户开关后,系统就会在应用激活时创建加密的标识符,这样就能让相关应用准确地将用户行为关联到初始激活。即使该用户在后续的某个时间点进行了匿名化,仍能确保数据上报的准确性。
特点与局限性
特点 | 说明 |
---|---|
代理 | 代理对广告主SKAN转化值操作台的权限有限。 |
粗略值 |
|
自然应用内事件 | 在SKAN 4的自定义(Custom)和解析(Decode)模式下,应用内事件和总收入的自然量指标不可用。 |
模糊数据 | 更改SKAN配置后的48-72个小时内,面板和原始数据报告中的数据是模糊数据。这是由于iOS计时器的限制,AF无法判断用于解析回传的配置是否与之前对其进行编码的配置相匹配。 |