本文面向使用 Google 代码或跟踪代码管理器且需要对代码植入设置进行问题排查的用户。
Tag Assistant 这款工具可帮助您对代码植入设置进行问题排查。借助 Tag Assistant，您可以：
- 查看网站上有哪些代码。
- 查看触发了哪些事件。
- 查看正传递到数据层的数据。
- 导出调试会话，以便与其他人共享，例如 Google 支持团队。
- 导入他人的调试会话。
- 分享调试网址，以便他人为您调试。
如果您的网站包含 Google 代码，Tag Assistant 会将已植入和未植入代码的网页添加到代码覆盖率摘要中，因此您可以简要了解网站的整体代码植入状态。
本文包含的主题：安装 Tag Assistant Companion Chrome 扩展程序
Tag Assistant Companion Chrome 扩展程序可与无扩展程序的调试程序配合使用。为获得最理想的调试结果，请安装 Tag Assistant Companion Chrome 扩展程序。如果已安装 Chrome 扩展程序，则可使用以下功能：
- 检测 iframe 内部的 Google 代码。
- 调试从当前窗口打开的弹出式窗口或新标签页。
- 调试窗口会在新的浏览器标签页中打开，而不是以弹出式窗口的形式打开。因此，用户可以对浏览器网址栏进行操作，且可方便对引荐来源网址进行调试。
- 可在同一个调试会话中对多个窗口进行调试。在事件树中，系统会使用符号标记每个窗口，便于轻松识别。
调试参数简介
Tag Assistant 可为已发送到“应用 + 网站”衡量 ID 的命中自动设置“调试”参数 (_dbg)。因此，您可轻松查看其他调试界面（例如，“应用 + 网站”的 DebugView）上显示的命中。为便于您分别检查每个命中，“应用 + 网站”命中不支持批量发送。
启动新的调试会话
如需启动新的调试会话，请执行以下操作：
- 打开 Tag Assistant
- 点击 Add domain（添加域名）。
- 输入要调试的网页的网址。
- 点击 Start（开始）。Tag Assistant 会在新标签页中加载要调试的网站。
- 部分网站可能会因网址中添加了调试参数而发生异常。出现这种情况时，请取消选中 Include debug signal in the URL（在网址中添加调试信号）复选框。
要继续查看处于活动状态或已关闭的调试会话，请打开 Tag Assistant 首页，从 Active Domains（处于活动状态的网域）或 History（历史记录）中点击相应域名。
启用后，系统会在新窗口中打开您输入的网址所对应的页面，并在现有的 Tag Assistant 浏览器窗口中打开调试界面。Tag Assistant 窗口中的调试界面会显示有关您的 gtag() 命令和事件的详细信息，包括代码是如何触发的以及正在处理哪些数据。调试信息不向普通的网站访问者显示。当您在同一网域中浏览时，只要相应网页上有 Google 代码，调试窗口就会保持打开状态并显示调试信息。
点击进入您的网站后，调试窗口会更新与代码触发方式相关的信息。您可通过这些信息了解某个代码是否成功触发、触发（或不触发）其触发状态的原因，以及触发代码后发出的网络请求。
Tag Assistant 界面简介
首次打开 Tag Assistant 时，您会看到默认的 Summary（摘要）数据视图，其中包含所请求网页的事件和代码信息的概览。如果系统检测到多个 Google 代码或跟踪代码管理器容器，请选择一个容器以查看该特定 Google 代码或容器的所有命中。
注意：浏览器事件可能会应用于所有容器，但命中会按所选容器进行过滤。
屏幕左侧显示的是事件列表。Output（输出）部分会以卡片形式显示检测到的所选 ID 的每个命中。
系统会按事件发生时所在的网页对其进行分组。点击左侧导航栏中的网页标题即可查看网页级摘要。用户转到网站上已植入 Google 代码的其他网页时，系统会将新的网页组添加到列表顶部。
系统会按照事件的触发顺序显示事件，并对其进行编号。标有 
API Call（API 调用）显示的是为所选事件配置数据的 JavaScript，可能是 gtag() 调用，也可能是 datalayer.push() 调用。
Output（输出）会显示命中的发送位置、数据层的最新信息及所有错误。
命中详细信息
Hits Sent（发送的命中）会显示特定命中的发送位置及命中所属的类型：
点击该命中时，系统会显示详细信息窗口。以下视图会显示随每次命中所发送参数的详细信息。
数据层
Data Layer（数据层）标签页会显示从 dataLayer 对象中发现的值。点击 Summary（摘要）后，系统会显示数据层的当前状态，以及已发送到每个事件的数据层的数据。
导出调试会话
当需要获得代码调试方面的帮助时，导出 Tag Assistant 会话非常有用。导出的文件会存储您的调试历史记录，其他用户可以将其导入到自己的 Tag Assistant 浏览器窗口中。
如需导出调试会话，请执行以下操作：
- 打开 Tag Assistant
- 浏览您的网站，以在 Tag Assistant 中填充调试信息。
- 准备好导出调试会话后，依次点击溢出菜单
Export session（导出会话）。
- 仔细阅读免责声明，然后点击 Export（导出）。系统会将导出的文件保存到计算机上。请勿修改文件名或文件内容，否则可能会损坏文件内容。
- 将此文件分享给帮助您调试代码植入的人员，以便他们能够导入调试会话。
Export session（导出会话）。导入调试会话
您可以导入 Tag Assistant 调试会话，以了解他人测试代码植入设置所采取的步骤。导入的调试会话会在只读模式下打开，这意味着您无法继续调试。新的命中或代码不会在导入的会话中触发。如果您需要代表他人测试网站，请让他们分享调试权限。
如需导入调试会话，请执行以下操作：
- 打开 Tag Assistant
- 在溢出菜单
中，选择 Import session（导入会话）
- 上传调试会话文件。导入的会话会在只读模式下打开。
与他人分享调试权限
如果您需要代码植入设置调试方面的帮助，可以向其他人授予 Tag Assistant 访问权限。
如需分享调试权限，请执行以下操作：
- 打开 Tag Assistant
- 启动新的调试会话。
- 在溢出菜单
- 查看调试设置，然后点击 Copy Link（复制链接）。
- 将调试链接分享给能够为您提供帮助的人。
退出调试模式
如需退出调试模式，请执行以下操作：
- 切换到已启用调试模式的网络浏览器标签页。
- 点击浮动窗口或首页上的 Stop Debugging（停止调试），或点击调试窗口左上角的“X”。
使用 Tag Assistant 验证 Google Ads 转化操作
Tag Assistant 与 Google Ads 的集成提供一种引导模式，以帮助完成转化操作验证。
Google Ads 转化摘要页面包含一些链接，供您对未经验证的转化操作进行问题排查。这会启动 Tag Assistant，以便您如上所述进入调试模式。
该页面中的 Tag Assistant 叠加层会显示验证转化操作的指南。完成后，点击完成会在 Tag Assistant 窗口中显示一则摘要，具体说明完成测试的转化操作。这些结果会在短暂延迟后反映在 Google Ads“转化摘要”页面中。了解详情。
排查连接问题
如果调试窗口未成功连接到您的网页，请尝试以下解决方案：
- 您输入的网址所对应的网页可能未植入 Google 代码。请尝试使用您的网站上已植入 Google 代码的其他网页所对应的网址。
- 添加到网页网址的调试参数可能会干扰网页行为。要解决该问题，请修改您为调试模式输入的域名，然后取消选中 Include debug signal in the URL（在网址中添加调试信号）复选框。
- 系统会在 Tag Assistant 尝试连接到相应网页后加载 Google 代码脚本。点击 Retry（重试）可重新连接。
- 您的网页是 AMP 网页。Tag Assistant 目前不支持 AMP 网页。
- 相应网页在 iframe 中加载 Google 代码。只有在同时安装了 Tag Assistant Companion Chrome 扩展程序时才能对通过 iframe 加载的代码配置进行调试。
- 多次浏览器重定向会导致调试窗口无法加载。
- 您的网络浏览器中安装的广告拦截器可能会阻止 Google 代码的运行。针对需要测试的网页停用广告拦截器。
- 如果您已安装 Tag Assistant Companion，请确保此扩展程序有权限读取和更改您需要测试的网页的网站数据。
- 意见征求管理工具可能会屏蔽 Google 代码。请将您使用的任何意见征求管理工具配置为允许与 Google 的 Consent API 交互。