概要：AppsFlyer可将您配置的转化值解析为具体事件，并将这些事件信息填充到SKAN面板、原始数据报告以及渠道回传中。
解析SKAN转换值
如果广告主不想使用转化值操作台中提供的选项，可以将转化值解析作为一种替代方案。若您选择使用解析模式（Decode），须自行负责updatePostbackConversionValue的设置，使其符合相关应用的业务逻辑。
除了应用中的转化值（CV）配置之外的其他流程、功能以及数据上报方式都与SKAN解决方案指南中所述一致。也就是说，由广告主设定的用户行为窗口期结束后，iOS会向广告平台发送回传，并由平台转发给AppsFlyer。AppsFlyer会根据您的映射配置将转化值解析为事件，与SDK解析CV值的处理方式相同。
自定义CV值解析（Decode）
启用自定义的CV解析时，您需要上传一个CSV文件，其中包含针对AppsFlyer的CV值映射配置。
解析映射原理
- 您需要为第1-3个窗口期设置精细转化值（1-63）和粗略转化值（Low, Medium和High）的解析映射方式。不要求必须映射所有转化值，比如可以仅映射1、2、10和43。
- 0值的CV总是映射到激活，无法更改。
- 您需要将映射配置表以CSV文件的方式上传到AppsFlyer。您可以按实际需求编辑并上传映射配置表。
- 收到iOS的回传后，AppsFlyer会将CV值解析为事件，详见下文示例说明。
- 激活日期根据回传送达的时间推算得出。
- 事件时间与激活时间相同。
- 为了便于您更好地理解映射构架的配置方式，下文列出了映射场景说明，供您参考。
-
您可以使用自定义的应用内事件名称。
- 包括SDK从未发送过的全新事件名称。
- 您可以将这些应用内事件映射到广告平台侧对应的事件。
- Meta ads对接也支持自定义事件名称，但须遵循下文所述的Meta对接要求。
解析模式中的映射配置要求
注意事项：
- 可用的精细转化值：1-63
- 可用的粗略转化值：Low（低）、Medium（中）、High（高）
- 某个具体转化值可对应到您指定的一个或多个应用内事件。您可以选择为应用内事件添加参数。
- 在下文示例中，假设激活日期为2月1日08:00。
- 请参考下文的解析模式映射表示例。该表格的结构与您需要上传的CSV文件相同。表格下方展示了解析完成后得到的事件。
- 无论您配置了怎样的映射关系，解析后总是会生成一个激活事件。
- 收入衡量：
- 收入金额以美元（USD）计算。
- 某个具体转化值所代表的收入范围通过min_revenue和max_revenue表达。
- 汇总报告和面板按此范围的平均值计算收入。举例来说，假设min_revenue=4，且max_revenue=10，则计算出得出的收入为7。
- 原始数据报告中包含计算后得出的收入（skad_revenue）、min_revenue以及max_revenue。
针对Meta ads对接的要求
如果您对接了Meta ads，请按以下要求配置映射架构：
- 某个具体转化值所对应的收入范围中，最小值和最大值不能相等，必须使用不同的值。
- 收入范围之间不能有重叠，并且必须依次构成连续的数值。请参考下表中conversion_value为1、2和62时对应的收入范围。
- event_counter：Meta ads不会计算该参数值。【最佳配置】：用1值填充该参数。
示例：解析模式下的映射配置
| conversion_ value |
event_ name |
event_ value |
min_revenue （不含） |
max_revenue（含） | event_ counter |
hours_from_ install |
|---|---|---|---|---|---|---|
| 1 | af_purchase | {abc} | 0 | 3 | 1 | 24 |
| 2 | af_purchase | {def} | 3 | 10 | 3 | 36 |
| 21 | event_a | 1 | 24 | |||
| 21 | event_b | 3 | 24 | |||
| 21 | event_c | {xyz} | 2 | 24 | ||
| 21 | event_d | 1 | 24 | |||
| 21 | event_e | 1 | 24 | |||
| 21 | event_f | 1 | 24 | |||
| 21 | event_g | 1 | 24 | |||
| 62 | af_purchase | {fgh) | 10 | 17 | 2 | 72 |
| 62 | event_a | {klm} | 3 | 72 |
示例A：精细转化值为1
| event_name | skad_revenue |
min_revenue |
max_revenue |
event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 1.5 | 0 | 3 | {abc} |
示例B：精细转化值为2
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 65 | 3 | 10 | {def} |
| af_purchase | 65 | 3 | 10 | {def} |
| af_purchase | 65 | 3 | 10 | {def} |
示例C：精细转化值为21
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| event_a | ||||
| event_b | ||||
| event_b | ||||
| event_b | ||||
| event_c | {xyz} | |||
| event_c | {xyz} | |||
| event_d | ||||
| event_e | ||||
| event_f | ||||
| event_g |
示例D：精细转化值为62
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| event_a | {klm} | |||
| event_a | {klm} | |||
| event_a | {klm} |
解析模式中的CSV文件内容及格式要求
CSV文件的内容须反映转化值的映射方式，一个转化值可以映射到一个或多个应用内事件。
文件内容及格式要求
- 格式：CSV文件
- 行数上限：640 + 标题行；共641行。
- 标题行中的栏位必须与下表所列的栏位完全一致。建议您使用超链接中的CSV示例文件作为模板，完成SKAN 3和SKAN 4的解析模式映射配置。
- 栏位字段切勿以下列字符开头：
=、+、-和@。
解析模式中的CSV文件内容及格式要求
| 栏位 | 是否必须配置 | 内容 | 说明 |
|---|---|---|---|
| conversion_value |
在下列场景中必须配置：
|
1–63的整数值 |
同一个精细转化值可对应多个事件。详见示例说明。 |
| coarse_conversion_value |
仅适用于SKAN 4 |
字符串：
|
同一个粗略转化值可对应多个事件。 |
| event_name | 是 | 字符串 |
即应用内事件的名称。可以是AppsFlyer SDK从未上报过的事件。 请注意：应用内事件名称区分大小写。 【推荐方式】：建议将收入事件的名称设置为af_skad_revenue。 |
| event_value | 否 | 字符串 | 由开发人员设置的字符串，其中的数据需由广告主侧的内部系统解析。这些字符串一般为JSON格式。 |
| min_revenue |
否
|
整数或浮点数 |
请使用min_revenue和max_revenue来设置以美元为单位的收入范围。
请注意：如果您使用Excel编辑文件，请先在列格式中设置逗号分隔符，然后再保存。切勿使用货币格式，否则Excel会自动在生成的CSV文件中添加$符号。 |
| max_revenue | 否 |
如果您设置了非空值的min_revenue，则max_revenue的值必须大于 0。 详见min_revenue部分的说明。 |
|
| 否 |
自2021年6月7日起已弃用。请使用min_revenue和max_revenue
|
||
| event_counter | 是 |
整数
|
示例：如果用户完成某事件共5次，则会生成5个事件。 注意事项：如果您发送收入，则最终上报的总收入是事件收入乘以 event_counter值得出的金额（以美元计）。举例来说，假设min_revenue = 0、max_revenue = 3且event_counter = 4，则上报的总收入为1.5 X 4 = 6。 详见示例说明。 |
| hours_from_install | 是 | 整数 |
AppsFlyer会使用该信息来推算并设置激活日期，具体如下：
|
| postback_sequence_index |
仅在SKAN 4中是必须配置的参数 |
整数：
|
对于精细转化值，该参数的值只能为0。 |
上传转化值映射架构文件
前期准备 ：
- 制备CSV格式的转化值映射架构文件。
- 如果您对接了Meta ads且需要衡量收入，请确保您的映射架构符合Meta ads的配置要求，否则Meta ads无法使用该架构解析映射关系。
请按以下方式启用解析模式（Decode）进行SKAN衡量：
- 从AF后台进入配置 > SKAN转化值操作台。
- 点击选项图标（⋮），选择上传自定义解析规则文件。
- 如果您尚未升级到SKAN 4，可以选择上传适用于SKAN 4或之前版本的文件。升级到SKAN 4后将无法选择适用于其他版本的文件。
- 完成以下任一操作：
- 点击拖放文件。
- 上传最新的映射架构文件。
- 按面板中显示的提示说明上传文件。
- 打开SKAN衡量开关。
- 点击保存更改。
请注意：在接下来的48-72小时内，面板板会显示不明确的过渡期数据。这是因为受到iOS计时器的限制，AppsFlyer无法确认用于解析的映射架构与您使用的编码架构是否一致。 - 请确保您已将应用内事件映射到渠道侧的对应事件，以便相关渠道能正常利用回传数据。
CSV文件上传中的问题排查
上传时报错
文件中有一个或多个值不符合格式要求：文件格式要求自2021年6月7日起发生了一些变化，请确保您的文件格式与本文所提供的示例文件格式一致。
使用Excel调整event_revenue_usd一列的格式
如果您使用Excel/Google Sheets创建CSV文件，请务必先确认event_revenue_usd一列的格式正确无误，然后再将文件保存为CSV格式。
保存CSV文件之后，请再次检查其格式是否正确无误。请注意：请勿使用Excel来检查文件格式，而须在编辑器中检查。
在Excel调整event_revenue_usd单元格的格式
如下图所示，Excel对数值单元格进行格式化时，通常使用逗号作为千位分隔符。此格式不适用于CSV文件上传。 此外，您还需要删除$符号。
您可以在Excel中对这些单元格进行格式化，便可更正此问题。
请按以下方式对金额进行格式化，确保其中没有千位分隔符（逗号）或$符号：
- 选中需要调整格式的单元格。
- 右击Format cells（调整单元格格式）。
界面会打开单元格格式调整窗口。 - 选择Number。
- 取消Use 1000 separator (,)（使用逗号为千位分隔符）的勾选。
- 【可选】设置数值的小数点后位数，默认值为2，最多可精确到小数点后5位。
- 点击OK。
单元格格式化完毕。
请勿使用Excel来检查CSV文件
如需检查CSV文件的内容，请务必在编辑器中查看该文件。
- Windows：Notepad、Notepad++
- MacOS：TextEdit
下图为CSV示例文件在编辑器中的截屏。
编辑器视图
在编辑器中检查CSV文件时请特别注意以下几点：
- 空格：请确保字段分隔符（即逗号）的前后没有空格。您可以在Excel中使用@trim命令来删除空格。
-
event_revenue_usd：确保event_revenue_usd一列中没有逗号或$符号。
Excel生成CSV文件时不使用逗号作为分隔符
如果Excel生成CSV文件时使用分号“;”等非逗号的字符作为分隔符：
- 这可能是因为您电脑的区域设置为非英语语言/地区。
- 当区域设置为德语时，此问题尤其普遍。
- 在不同的计算机操作系统（macOS或Windows）中解决此问题的方法不同。
- 如需解决此问题，请在Microsoft或其他论坛中搜索相关指南。您可以在搜索中使用以下关键词：Operating system (macOS or Windows) Excel change delimiter for CSV files（在macOS或Windows中通过Excel更改CSV文件分隔符）。