旺道推广：工具支持的对象格式变化时怎样改输入规范
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /e7f3418baeb0.html
📄
旺道推广：工具支持的对象格式变化时怎样改输入规范
当旺道推广类工具的输入对象从一种格式换成另一种格式时，先不要急着全量重录或放弃原有规范。更稳妥的做法是：先确认变化发生在哪一层（字段名称、字段层级、取值类型还是编码方式），再决定是保留旧规范做映射、改写输入模板，还是退出当前流程改用人工核对。缺少完整数据或权限时，最小动作是抽取少量样本做格式对照，而不是直接推断工具已经不支持原有对象。
先判断变化发生在哪一层，而不是先改模板
对象格式变化通常有四种表现，对应的处理方式完全不同：
- 字段名称变化：例如原来叫“投放区域”，现在叫“地域”。这类变化只需在输入规范里加一层别名映射，旧规范可以保留。
- 字段层级变化：原来平铺的“省份/城市”，现在嵌套在“地区”对象下。这类变化会破坏原有解析逻辑，需要改写输入结构。
- 取值类型变化：原来区域用文字，现在要求用编码。这时旧值不能直接沿用，必须补一层编码对照。
- 编码或分隔符变化：例如逗号改成竖线、UTF-8 改成其他编码。这类变化往往最容易误判为“工具坏了”，实际只需调整输入文件的写出方式。
判断方法：取三条旧输入和三条新格式输入，逐字段比对。如果只有名称不同、层级和取值类型一致，属于可映射；如果层级或类型不一致，属于需要改写；如果连字段含义都对不上，才考虑退出当前流程。
保留、改写、退出各自成立的前提
保留旧规范成立的前提是：字段含义未变，只是名称或顺序调整，且你能维护一份别名或映射表。此时动作是更新映射表并跑一遍样本，观察输出是否与旧结果一致。结果一致，说明可以继续沿用；结果出现缺项，说明映射不完整，需要回到字段对照。
改写输入规范成立的前提是：字段层级或取值类型发生变化，但业务含义仍可对应。此时动作是重写输入模板，并用同一批样本分别跑新旧模板，比较差异字段。如果差异只出现在被改写的字段上，说明改写方向正确；如果其他字段也开始异常，说明改写引入了副作用，应先回退再定位。
退出当前流程成立的前提是：新格式缺少旧规范依赖的关键字段，且无法通过映射补齐。这时不要强行用默认值填充，因为默认值会掩盖真实缺失。更合适的动作是把这类对象单独标记，转人工核对，并记录缺失字段清单，供后续判断是否需要调整上游数据源。
缺少完整数据或权限时的最小动作
没有全量数据或没有写入权限时，仍然可以做三件事：
- 用只读权限抽取少量样本，做旧格式与新格式的字段对照表。
- 在本地或沙箱里跑一次输入模板的试写，不写回真实对象。
- 记录哪些字段无法验证，并明确这些字段不能作为“格式已兼容”的证据。
需要说明的是，样本通过不等于全量通过。样本量小、抽样偏向某类对象、或编码在导出环节被改动，都会让样本结果偏离真实情况。因此样本只能用来排除明显错误，不能用来推断工具已完全支持新格式。
假设例子：一次区域字段格式变化的取舍
假设某次输入对象把“区域”从纯文本改成“编码+名称”的组合，而旧规范只接受文本。可以这样比较：
- 保留：若工具仍接受文本并自动匹配，则保留旧规范，只补一份编码对照表。
- 改写：若工具只接受组合格式，则把输入模板改为“编码+名称”，并保留文本字段作为备注。
- 退出：若组合格式里缺少旧规范依赖的层级信息，且无法从其他字段推导，则把这批对象转人工处理。
三种选择的判断依据不是“哪种更省事”，而是“新格式是否仍能表达旧规范所需的全部信息”。能表达就保留或改写，不能表达就退出。
改完之后，下一步看什么
改完输入规范后，下一步不是立刻扩大范围，而是先看三件事：改写后的字段是否在输出中稳定出现；旧字段是否被正确替换而不是重复出现；缺失字段是否被明确标记而不是被默认值填充。只有这三项都确认，才适合把改动推广到更多对象。否则，应先回到字段对照，重新判断是保留、改写还是退出。
