在Google Tag Manager（GTM）的调试过程中，Tag Assistant Companion成为了一种新的调试方式。它是对原有Preview Model 的增强和替代，尤其是在浏览器逐步禁止第三方Cookie 后，Tag Assistant提供了一个更为稳健和灵活的解决方案。
背景：为什么推出新的调试方式？
GTM原有的Preview Mode调试方式依赖第三方Cookie 来维持调试状态。但随着浏览器隐私政策日趋严格（如 Safari、Firefox 及 Chrome 逐步限制第三方 Cookie），原有方式在许多场景下已无法正常工作。
为此，Google于2024年12月推出了 Tag Assistant Companion，作为Preview Mode的增强与替代方案。其核心改进在于：不再依赖第三方Cookie，通过第一方存储机制实现更稳健的调试体验。
什么是Tag Assistant？
Tag Assistant是Google推出的一款Chrome调试工具，主要用于GA4和GTM的标签调试。它可以记录事件触发情况，帮助开发者验证标签是否正确运行，确保数据采集的准确性。
发展历程：
- 2020年10月：Google推出 Tag Assistant（基础版）
- 2024年12月：推出Tag Assistant Companion（增强版），此后一般直接统称为Tag Assistant
Preview Model VS Tag Assistant核心对比
| 对比维度 | Preview Mode（旧版） | Tag Assistant（新版） |
|---|---|---|
| 测试结果展示方式 | 通过 iframe 嵌入在测试页面下方显示 | 在独立页面（tagassistant.google.com）中集中展示 |
| 调试状态维持机制 | 依赖第三方 Cookie（位于 googletagmanager.com 域下） | 通过第一方 Cookie / LocalStorage（生成 __TAG_ASSISTANT 标识），不受第三方 Cookie 限制影响 |
| 展示信息范围 | 主要展示 DataLayer 信息 | DataLayer + API Call 信息，便于深度排查 |
| 授权要求 | 调试者需拥有 GTM 容器的授权 | 可通过分享调试链接让第三方调试，无需授权 |
| 服务端部署支持 | 有限或不支持 | 原生支持服务端 GTM 部署调试 |
Tag Assistant的优势
相较于旧版Preview Mode，Tag Assistant在以下方面实现了显著提升：
- 专为GA4优化：能更准确地记录 GA4 跟踪事件，与新版分析体系更契合；
- 跨页面记录能力：在独立页面中持续记录整个测试会话，关闭测试页面前可随时回溯所有事件，便于全流程分析；
- 免授权协作调试：通过共享链接即可让外部专家参与调试，无需开放 GTM 容器权限，安全性更高；
- 信息维度更丰富：同时展示 DataLayer 和 API Call 信息，有助于定位标签配置与网络请求层面的问题；
- 服务端部署友好：完美兼容服务端 GTM 部署场景，调试体验一致。
Tag Assistant的调试使用指南
打开调试的两种方式
打开调试有两个入口：
- 方法一：在GTM工作区中，点击右上角 「预览」 按钮
- 方法二：进入 GTM 「版本」 管理页面，点击对应版本的 「预览」
两种方式均会跳转至https://tagassistant.google.com调试页面。
设置测试页面
进入Tag Assistant页面后，进行以下配置：
- 您网址的地址：填入需要测试的完整URL（如 https://www.ichdata.com）
- 在网址中添加调试信号：可选。勾选后会在测试 URL 自动追加 ?gtm_debug=x 参数。如网站对 URL 参数有特殊限制（常见于移动端），建议取消勾选
点击 「连接」 后，Tag Assistant 将自动打开您指定的测试页面。
判断是否进入调试状态
以下三种方式均可确认已成功进入调试模式：
- URL调试信号：若勾选了添加调试信号，地址栏显示 https://www.ichdata.com?gtm_debug=x
- 页面右下角的弹框：显示 “已连接 Tag Assistant” 提示
- Tag Assistant的页面：页面顶部显示 “已连接！” 绿色状态标识
Tag Assistant 调试界面说明
如Tag Assistant的界面如下：
Tag Assistant调试页面主要包含以下区域：
- 左上角的“已连接”：显示当前调试连接状态
- GTM-MQ8Z6H：当前测试的GTM容器或GA4测量ID，点击可切换
- 概要：汇总测试过程中监测到的所有行为。状态指示灯含义：
- 🟢 绿色（数字）：检测到有效标签及数量
- 🔵 蓝色：有优化建议
- 🟡 黄色：存在轻微实施问题
- 🔴 红色：存在严重实施问题
- ⚪ 灰色（带 ✕）：页面未找到任何标签代码
- output of GTM–MQ8Z6H：展示具体触发的标签、数据传递内容及错误信息，是核心排查面板
调试流程
Step 1：模拟用户行为
在测试页面上执行需要验证的操作（如页面加载、点击按钮、提交表单等）。
Step 2：观察Tag Assistant记录
切换至Tag Assistant页面，查看是否产生了对应的事件记录。
Step 3：确认标签触发情况
- 标签已触发：在输出面板中看到对应标签显示为绿色触发状态，完成验证；
- 标签未触发：在输出面板中定位到该标签，查看其触发器条件中具体哪个条件未满足，根据提示调整触发器配置。
Step 4：检查变量值
在输出面板中展开标签详情，检查 DataLayer 中的变量值是否正确读取。若变量显示为 undefined，说明变量获取失败，需检查 GTM 中的变量配置。
重复上述步骤，直至所有事件准确触发。
分享调试链接（免授权协作）
当需要外部专家协助调试，但不想授予 GTM 容器权限时，可使用此功能：
在 GTM 里点击 「版本」——「共享预览」：
在弹出的设置界面中确认目标测试URL
复制生成的链接并分享给第三方进行调试。
第三方打开链接后即可进入调试状态，无需登录 GTM 或获得任何授权。
关闭调试
在Tag Assistant页面右上角点击 「✕」 关闭按钮，即可结束当前调试会话。
注意事项
- 引荐来源排除：调试时，Tag Assistant 会通过 tagassistant.google.com 跳转至测试页面，因此测试流量会被识别为来自该域名的引荐来源。为确保 GA4 数据准确性，建议在 GA4 的引荐来源排除列表中将其排除。延伸阅读：Google Analytics 4中排除特定引荐来源
- 调试环境建议：调试时建议使用无痕模式或清空缓存，避免现有Cookie干扰测试结果
- DebugView 备选方案：如需使用 GA4 原生 DebugView 进行调试，可参考：GA4的内置调试方式——DebugView
总结
Tag Assistant（Companion）是 GTM 调试工具的一次重要升级，它从根本上解决了第三方 Cookie 限制带来的调试失效问题，同时在信息展示、协作便捷性和服务端支持等方面均有显著提升。建议所有 GTM 使用者尽快熟悉并切换至这一新的调试方式。