Tag Not Found / 未找到标签
- 问题描述：Tag Assistant 未检测到页面上的 GA、GA4 或 GTM 标签。
- 可能原因：页面未正确安装 GTM 容器代码或 GA/GA4 标签未启用。
- 解决方法：检查页面是否正确嵌入容器代码，确认标签配置已发布。
- 注意事项：容器代码应放在
<head>或<body>合理位置。
Multiple Tags Fired / 多个标签触发
Missing Required Fields / 缺少必填字段
- 问题描述：GA4缺少必要字段，如 Measurement ID。
- 可能原因：配置不完整或变量未正确设置。
- 解决方法：补全 Measurement ID，确保事件参数完整。
- 注意事项：GA4 的 event_name 和 user_properties 等参数也需检查。
Tag Fired Too Early / 标签触发过早
- 问题描述：标签在 DOM 或 dataLayer 未准备好时触发。
- 可能原因：触发条件设置为 Page View，但页面是 SPA 或异步加载。
- 解决方法：调整触发器时机，如使用 DOM Ready 或 Window Loaded。
- 注意事项：对 SPA 页面尤其重要，避免 dataLayer 数据丢失。
Invalid Configuration / 配置无效
- 问题描述：标签参数拼写错误或格式非法。
- 可能原因：GA4 配置错误或事件名称不符合要求。
- 解决方法：检查 event_name、参数名和值格式，确保大小写和特殊字符正确。
- 注意事项：空格或特殊字符可能导致数据丢失。
Blocked by AdBlock / 拦截器拦截
- 问题描述：浏览器扩展或隐私模式阻止标签请求。
- 可能原因：AdBlock、隐私插件或 Safari ITP 拦截 GA/GA4 请求。
- 解决方法：关闭广告拦截器或使用无广告屏蔽浏览器进行测试。
- 注意事项：部分企业浏览器或防火墙也可能阻断请求。
Consent Not Granted / 用户未同意
- 问题描述：用户未授权 Cookie 同意，标签未触发。
- 可能原因：CMP（Consent Management Platform）未正确配置触发器。
- 解决方法：确保用户同意后触发标签，可使用 GTM 的 Consent Initialization 触发器。
- 注意事项：ATT 用户拒绝时，iOS IDFA 相关数据无法收集。
Duplicate Event / 事件重复
- 问题描述：同一事件在 dataLayer 或页面中重复触发。
- 可能原因：触发器设置不当或 SPA 页面路由变化导致重复推送。
- 解决方法：检查触发器条件，确保事件只触发一次。
- 注意事项：单页应用需特别注意 history change 或 route change。
Measurement Protocol Error / 请求错误
- 问题描述：GA4 Measurement Protocol 请求格式错误。
- 可能原因：event_name、user_properties 或参数类型不符合规范。
- 解决方法：检查请求 Payload 格式，确保参数正确。
- 注意事项：可在 Network 面板查看请求细节。
Network Error / 网络错误
- 问题描述：标签请求未发送或失败。
- 可能原因：网络中断、企业防火墙或 CSP 限制。
- 解决方法：确认网络畅通，排查防火墙或代理问题。
- 注意事项：企业内部环境可能需要配置白名单。
Cross-Domain / 跨域问题
- 问题描述：跨域数据未正确传递，导致用户无法关联。
- 可能原因：GA4跨域跟踪未配置或 Cookie 被限制。
- 解决方法：配置跨域跟踪，确保 cookie 域设置正确。
- 注意事项：Safari ITP 或 Chrome 隐私沙箱可能影响跨域 Cookie。
Event Not Sent / 事件未发送
- 问题描述：dataLayer 事件或标签触发失败，未发送请求。
- 可能原因：触发器条件未命中或 dataLayer 数据缺失。
- 解决方法：检查触发器设置与 dataLayer push 数据，确保事件名称一致。
Configuration Mismatch / 配置不匹配
- 问题描述：GTM 容器环境与页面实际标签不一致。
- 可能原因：发布环境与预览模式不一致，导致数据丢失。
- 解决方法：确认发布环境正确，避免 staging/production 混用。
Tag Timeout / 标签超时
- 问题描述：页面加载缓慢或 JS 阻塞导致标签超时。
- 可能原因：标签依赖 JS 或 DOM 未加载完成。
- 解决方法：优化标签加载顺序，使用 async / defer，或者延迟触发。
- 注意事项：SPA 或大量 JS 页面需特别关注。
如有疑问，可以在文章底部留言或邮件(haran.huang@ichdata.com) 我~
