概要：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文件分隔符）。
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.