如何调试 Google Analytics 和 Tag Manager 跟踪
如果通过结账小组件完成的预订没有显示在 Google Analytics 中，小组件内置的调试日志可以帮助您找出数据在哪个环节停止。
1. 首先，了解小组件如何发送事件
在小组件设置的 Analytics 下，Send events via 选项决定跟踪的工作方式。这两个选项的行为差异很大，也会影响您在调试时应当看到的内容。
Google Analytics 4 — 小组件会将每个预订事件直接发送到您的 Analytics 媒体资源。使用 Use existing tag（默认选项）时，它会使用页面上已有的 Google Analytics 标签；使用 Use custom tag 时，它会使用您输入的衡量 ID 加载自己的标签。无论采用哪种方式，都是小组件直接与 Google 通信，因此您可以在浏览器的 Network 标签页中看到预订数据发出的请求。
Google Tag Manager — 小组件不会向 Google Analytics 发送任何内容，而是将每个事件交给您的 Tag Manager 容器，由容器决定如何处理。使用 Use existing container（默认选项）时，它会使用页面上已有的容器；使用 Use custom container 时，它会加载您输入的容器 ID。无论采用哪种方式，除非您已在 Tag Manager 中设置用于发送数据的标签，否则任何内容都不会到达 Google Analytics。这是预订缺失最常见的原因：小组件完全正常运行，但没有标签接收这些事件。请参阅第 5 节。
同一部分顶部还有一个总开关 Enable Google Analytics。它会同时为这两种选项启用或停用跟踪——如果该开关关闭，即使已启用 Tag Manager，也不会跟踪任何内容。
2. 启用调试日志
- 在 TicketingHub 控制面板中，打开您要测试的结账小组件的设置。
- 在 Analytics 部分中，启用 Enable analytics debug logging，然后保存设置。
启用后，小组件会针对每个事件在您网站的浏览器控制台中写入一行日志。选择 Google Analytics 4 时，这也会为该标签启用 Google 的调试模式。使用 Google Tag Manager 时，请使用 Preview，或在 GA4 标签中启用调试模式，以便在 DebugView 中查看事件。控制台日志只反映小组件这一端的情况——它无法看到 Google 接下来执行的操作，因此不能替代 GA4 DebugView 或 GTM Preview。
3. 在您的网站上打开浏览器控制台
- 打开嵌入了小组件的您的网站页面（而不是 TicketingHub 控制面板）。
- 打开浏览器的开发者工具（按 F12，或右键点击 → 检查），然后切换到 Console 标签页。
- 如果浏览器在控制台中显示框架选择器，请确保选中顶层框架——小组件会向您的页面报告事件，而不是在自己的框架内部报告。
- 在控制台设置中启用 Preserve log——如果小组件在预订后重定向到其他页面，最终购买事件的相关消息会在重定向前写入，否则这些消息会在您读取之前被清除。
- 完成一次测试预订。请确保在页面加载前已打开控制台（或在控制台打开的情况下重新加载页面），这样您也能看到页面启动期间产生的消息。
4. 控制台消息的含义
| 消息 | 含义 |
|---|---|
Triggering GA event … / Triggering GTM event … | 小组件已将事件发送到 Google Analytics，或已将事件交给您的 Tag Manager 容器。 |
… event … processed | 事件已被接收并处理，该消息通常会指出处理它的标签或容器。**对于 Tag Manager，这表示您的容器已收到事件，并不表示任何内容已发送到 Google。**请参阅第 5 节。 |
… event … was not confirmed within …ms | 在几秒钟内，没有任何内容向小组件表明该事件已被处理。这不一定表示事件已丢失——请检查 GA4 DebugView，确认事件是否已到达。常见原因请参阅第 6 节。 |
… event … was still waiting for confirmation when the page navigated away | 在检查完成前，您的小组件已重定向到其他页面；如果您使用购买后重定向，这是正常现象。这不表示事件失败——请在 GA4 DebugView 中确认。 |
… failed to load … | 无法加载 Google 的脚本，通常是因为被广告拦截器或网络过滤器阻止。 |
… event … dropped … | 事件完全无法发送。消息会说明原因：页面上尚未提供 Google Analytics 或 Tag Manager，或者小组件设置中已关闭 Tag Manager。 |
小组件有意只报告它能够确定的情况。它知道 Google 的脚本是否已加载，也知道您的标签是否确认处理了某个事件，但无法知道 Google 是否接受了这些数据，因此它会引导您使用 DebugView，而不是自行推测。
5. 如果您使用 Google Tag Manager，请设置您的标签
Tag Manager 是一个容器，而不是跟踪工具。当小组件将预订事件交给它时，您的容器会检查触发器，并运行所有匹配的标签。如果没有标签匹配，事件就会在那里停止——控制台仍会显示 processed，因为您的容器确实收到了该事件。
全新的容器不会自动接收这些事件。大多数 Analytics 标签都设置为在“Initialization”或“All Pages”时触发，而这些触发条件与小组件的预订事件不匹配。
要将小组件中的预订发送到 Google Analytics，您需要在 Tag Manager 容器中设置：
- 一个包含衡量 ID（
G-…）的 Google tag（或 GA4 Configuration 标签）。 - 针对您关注的每个预订事件设置一个 GA4 Event 标签，并使用 Custom Event 触发器，其事件名称要与小组件的某个事件名称相匹配。
小组件会发送以下事件名称：
| 事件 | 发生时机 |
|---|---|
page_view | 访客转到小组件的另一个步骤时 |
select_item | 从产品/活动列表中选择产品或套餐时 |
add_to_cart | 商品添加到购物篮时 |
view_cart | 显示订单摘要时 |
begin_checkout | 显示客户信息步骤时 |
add_payment_info | 显示付款步骤、但尚未提交详细信息时 |
purchase | 付款成功，或确认无需再付款的订单时 |
对于购物相关事件，请将标签设置为从 Data Layer 发送电子商务数据。小组件会按照 Google 所需的格式发送标准 Google Analytics 电子商务字段，例如币种、价值、商品和交易 ID，因此无需进行自定义映射。
使用 GTM Preview（Tag Assistant）检查设置：它会显示从小组件传入的每个事件，以及具体哪些标签已触发或未触发。如果事件已到达但没有标签触发，说明您的触发器不匹配；如果标签已触发但 Analytics 没有收到任何内容，请检查标签上的衡量 ID。
请注意，使用 Tag Manager 时，您不会在小组件自身的 Network 标签页中看到预订数据发送到 Google Analytics。小组件可能会加载 Tag Manager 容器脚本，但承载预订数据的请求来自您自己的标签，并且只有在这些标签触发后才会发出。
6. 常见原因和解决方法
- 广告拦截器和隐私扩展 — 几乎所有拦截列表都会阻止 Google 的跟踪脚本。请在停用扩展的隐私/无痕窗口中测试，或使用全新的浏览器配置文件。请注意，使用广告拦截器的访客也不会被跟踪，因此部分预订缺失属于正常情况。
- 事件已处理，但 Analytics 中没有任何显示 — 对于 Tag Manager，这几乎总是意味着没有标签设置为在小组件事件上触发。请参阅第 5 节。
- 控制台中完全没有任何内容 — 跟踪可能已被完全关闭。请确认 Enable Google Analytics 已开启，并记住它也会控制 Tag Manager。同时确保页面加载时控制台已经打开。
- 每个事件都显示因 Tag Manager 已关闭而被丢弃 — 在小组件设置中启用 Enable Google Tag Manager。要使 Tag Manager 选项正常工作，Enable Google Analytics 和此选项都必须开启。
- 没有 Tag Manager 消息，只有 Google Analytics 消息 — 您的小组件设置为通过 Google Analytics 4 发送事件，因此 Tag Manager 设置会被忽略。请将 Send events via 更改为 Google Tag Manager。小组件只能使用其中一种方式，不会同时使用两种方式。
- 衡量 ID 或容器 ID 错误 — 请检查小组件设置中的 ID 是否与您的 Analytics 媒体资源（
G-…）或 Tag Manager 容器（GTM-…）一致。 - 同意横幅 — 如果访客尚未接受分析 Cookie，Google Consent Mode 可能会有意暂缓事件。请先在测试页面上接受分析 Cookie，再得出结论。
- 缓存或优化插件 — 某些 WordPress 缓存或优化插件会干扰分析脚本。请尝试暂时停用这些插件，或将相关脚本添加到排除列表中。
7. 在 Google 工具中确认
控制台可以告诉您小组件已完成自己的工作。要确认数据是否已到达：
- GA4 DebugView（Analytics → Admin → DebugView）会实时显示到达您媒体资源的事件。
- GTM Preview（Tag Assistant）会显示小组件发送的每个事件触发了哪些标签。