Google Tag Manager预览调试工具：Tag Assistant

更新时间：2024年12月31号

在Google Tag Manager（GTM）的调试过程中，Tag Assistant Companion成为了一种新的调试方式。它是对原有Preview Model 的增强和替代，尤其是在浏览器逐步禁止第三方Cookie 后，Tag Assistant提供了一个更为稳健和灵活的解决方案。

为什么要推出新的调试方式

原有的Preview Model调试方式依赖于第三方Cookie，而随着浏览器的隐私保护政策日益严格，越来越多的浏览器（例如 Safari 和 Firefox）开始限制第三方Cookie 的使用，导致原有调试方式无法继续正常工作。为了应对这个问题，Google推出了Tag Assistant Companion，作为一种新的调试方式，它不再依赖第三方Cookie。

什么是Tag Assistant？

Tag Assistant是Google 推出的一款Chrome插件，主要用 Google Analytics 4（GA4） 和 Google Tag Manager（GTM） 的调试。它可以记录GA4跟踪事件，并帮助开发者分析是否成功地触发了事件和标签，确保数据准确无误。

• 2020年10月，谷歌推出Tag Assistant
• 2024年12月，谷歌推出Tag Assistant Companion，它是Tag Assistant的增强版，一般继续直接称为Tag Assistant

Preview Model VS  Tag Assistant

Tag Assistant的优势

• 支持Google Analytics 4的调试：Tag Assistant是专门为GA4设计的调试工具，能更准确地记录GA4跟踪事件。
• 能记录多个页面的或行为的测试结果：Tag Assistant 会在一个独立页面中记录所有测试结果，只要不关闭该页面，测试结果就会一直保留。这样，你可以轻松回顾和分析整个测试过程。
• 不需要Google Tag Manager授权也调试：与Preview Model是需要授权后才可以可以调试，而Tag Assistant可以通过分享测试连接实现第三方去测试，而不需要授权。
• 展示更多的信息：Tag Assistant不仅展示DataLayer信息，还可以展示API Call信息，帮助开发者进一步分析和解决问题。
• 支持服务端布署的调试，支持服务端部署的GTM配置，适合那些将GTM部署在服务端的情况，方便进行调试。

Tag Assistant的调试使用方法

这一部分主要是讲Tag Assistant的调试使用。

打开调试的两种方式

打开调试有两个入口：

• GTM 中点击右上角的 Preview（预览）：这是最常见的调试入口。
• 在版本管理中点击 Preview（预览），进入 Tag Assistant 页面。

设置测试页面

点击预览后后，会在打开一个新的页面，网址是https://tagassistant.google.com，这个页面是用于设置测试页面：

• 您网址的地址：填入需要测试的URL，http://www.ichdata.com
• 在网址中添加调试信号：这个是可选的，如果你勾选，那么会在测试的URL自动添加上gtm_debug=x的字段，如果你的网站对URL上的参数限制，那就不要勾选它，常见于移动端。

然后点击「连接」开始：

Tag Assistant会就打开到需要测试的页面。

判断是否进入测试状态

有三种方式可以判断进入测试状态：

• URL调试信号：如果你有勾选“在网址中添加调试信号”，在浏览器地址栏可以看到测试的URL是：https://www.ichdata.com?gtm_debug=x
• 页面右下角的弹框提示：提示有“已连接 Tag Assistant”
• Tag Assistant的页面：在页面顶部显示“已连接！”状态

Tag Assistant 调试界面说明

如Tag Assistant的界面如下：

• 左上角的“已连接”：表示成功进入调试状态。
• GTM-MQ8Z6H：表示目前测试的容器，可以是GTM容器，也可以是GA4测量ID，点击它就可以切换
• 概要：表示监测到行为，在调试页面的所有数据都是被记录，概要里有个标记的状态：
  • 带“ x”的灰色图标表示在页面上未找到代码
  • 如果找到有效的标签，绿色指示灯将显示。图标中的数字表示找到的标签数量
  • 蓝色指示器将显示有关改善整体标记健康的建议
  • 黄色指示器将表明已发现标签中存在少量实施问题
  • 红色指示器将表明已发现存在严重实施问题的标签
• output of GTM–MQ8Z6H：表示触发的具体代码、数据传递或错误。

调试过程

1、模拟行为：在测试页面上模拟用户行为（如点击按钮、提交表单等）。

2、查看 Tag Assistant 结果：Tag Assistant 会记录所有触发的标签。

3、确认标签是否成功触发：：

• 对应的「代码」促发，结束
• 对应的「代码」没有触发：找到该促发「代码」，看触发器哪个条件有问题，可以看到具体是触发器的哪个位置有错，对应对触发器做调整。

4、检查变量值：查看标签是否正确读取了DataLayer中的变量。如果变量为 undefined，说明未成功获取变量，需检查变量配置。

最后就是重复上面的过程，˙直到事件准确触发。

分享调试链接

对于需要外部专家参与测试但又不希望直接授权的情况，可以通过Tag Assistant分享调试链接：

在版本管理下点击「共享预览」：

就会弹出一个分享测试的设置界面：

目标网址：就是要测试的页面

复制生成的链接并分享给第三方进行调试。

关闭调试

在Tag Assistant页面右上角点击叉号，即可关闭调试并结束测试：

注意

由于调试的时候是Tag Assistant去连接打开测试URL，可以理解为是通过Tag Assistant跳转到测试页面的，所以测试流量会识别从tagassistant.google.com过来的referral，为了数据准确，请在referral exclusion list将其排除，延伸阅读：Google Analytics 4中排除特定引荐来源

如果你想用DebugView去调试，请看：GA4的内置调试方式——DebugView