迁移期间别把埋点搞断
收录 2026-10
重构页面或换框架后老埋点失效，报表断档几个月才发现，需要兼容方案
这次改版会替换 [页面或客户端结构]，现有埋点由老框架自动采集。请列出迁移期间必须保持的埋点字段与事件名、新实现如何补齐这些采集点、以及哪些字段确实无法保留需要提前通知使用方。输出：埋点对照表（旧事件、新事件、字段映射）、验证方式、切换期的双上报安排、口径变更说明。
本站原创
中文原文
使用示例
示例输入
改版会替换整个商品详情页结构，现有埋点由老框架自动采集，帮我保住关键字段。
输出应包含
- 必须保留的字段与事件名列清
- 给新旧事件的字段映射对照表
- 切换期双上报与口径变更说明
复制前替换这些占位符 1
把方括号里的内容换成你的具体信息，替换后再粘贴给 AI。
[页面或客户端结构]
使用建议
报表口径一变历史数据就不可比，切换日期要在报表里标注清楚。
可以这样改
- 要求它先复述需求与约束，确认无误再写代码。
- 让它给出最小改动 + 回滚方式，而不是整文件重写。
交付物（这次应拿到什么）
- 可运行的最小改动（含直接可用的代码块）
- 影响面清单：改了哪些文件、哪些调用点要跟着改
常见错法
- 一次让它改十个文件，最后分不清哪处改动导致了新问题。
- 只贴报错不贴代码和版本，拿到无法落地的修法。
输出验收（怎么判断能用）
- 改动可运行、可回滚，且没顺手改无关代码。
- 边界条件（空值、超长、并发）有说明或测试。
适用场景与注意
- 适合：让它先复述需求和约束，再给最小可运行改动。
- 注意：贴报错时同时给版本号与最小复现，否则它容易给出看似合理但不适配的写法。