用途:对 Google Tag Manager 追踪实现进行分层测试与调试,优先自动化。
主要能力:分四级验证。Tier 0 用 Playwright 无头测试,无需浏览器交互,可自动捕获 dataLayer.push 事件;Tier 1 在浏览器控制台手动校验 dataLayer;Tier 2 用 GTM 预览模式验证触发器与代码触发;Tier 3 用 GA4 DebugView 做端到端验证。还提供 GTM 容器 API 配置审计,检查基础 GA4 配置标签、事件标签参数、孤立触发器等。
使用方式:先检查 Playwright(npx playwright --version),未安装则 npm install --save-dev playwright && npx playwright install chromium;确认开发服务器运行(curl 检查 localhost:3000,否则 npm run dev)。编写 scripts/test-tracking.js,用 captureDataLayerEvents 包裹动作捕获事件,运行 node scripts/test-tracking.js,退出码 0 表示全部通过。对 Next.js Link 用 dispatchEvent 而非 page.click,外链用 page.route 阻断跳转。
适用场景:发布前验证 GTM/GA4 埋点、排查事件未触发或参数缺失。限制:GTM 容器与 GA4 校验仍需浏览器会话,属手动层级;元素选择器需按实际页面调整;资料未提供收费、价格等信息。