gtag('event', 'add_to_cart', { currency: 'CNY', value: 199 });
# 事件名不要出现大写和连字符
前端埋了 AddToCart 事件，调试工具里能看到请求，GA4 后台按事件名搜索是 0 条，换成全小写 add_to_cart 立刻就有了。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。
原因不复杂，GA4 事件名只接受字母、数字和下划线，首字符必须是字母，大写会被静默丢弃，不报错也不进报表。团队按驼峰命名写的十几个事件全都落空。
「GA4 事件名规范」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。动手前把原文件复制一份带时间戳，出问题立刻换回去，比现场分析快得多。
一次只改一处，改完立刻验证，几个改动叠在一起，出问题就说不清是谁导致的。
处理上按这个顺序：统一改成小写下划线命名，和 GA4 推荐事件对齐；在构建时加一层事件名校验，不合规直接报错；调试工具里逐个确认事件真的进了报表；把命名规范写进埋点文档，别靠口头约定。
改完只确认一件事：后台事件列表里出现 add_to_cart，参数 currency 和 value 都能看到。