跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

HubSpot 跟踪代码的故障排除

上次更新时间: 2026年7月23日

可与以下任何订阅一起使用,除非另有说明:

HubSpot 跟踪代码可让 HubSpot 跟踪您网站的访问者,并在您的账户中收集流量分析数据。如果您未看到任何网站流量数据,请按照以下步骤操作,确保跟踪代码已正确安装且运行正常。

请注意:如果跟踪代码未安装或无法正常运行,HubSpot 将无法从该页面可靠地接收跟踪数据。 因此,任何依赖跟踪的数据(例如页面浏览量或访客事件)可能会不完整或无法获取。此外,依赖于被跟踪会话的功能(例如聊天小工具或基于规则的聊天机器人)可能无法按预期运行。HubSpot 无法恢复代码处于非活动状态期间遗漏的跟踪数据。

验证跟踪代码是否已安装

有两种方法可以测试跟踪代码的安装情况:自动验证和手动验证。HubSpot 提供了一个自动工具来验证您的安装情况。

要对您的网页运行自动检查程序:
  1. 点击顶部导航栏中的 settings ”设置图标
  2. 进入“跟踪与分析”设置:
    • 对于仅拥有Marketing Hub Starter或 HubSpot 免费工具访问权限的账户,请在左侧边栏菜单中导航至“跟踪代码”
    • 对于所有其他订阅计划,请在左侧边栏菜单中导航至“跟踪与分析” >“跟踪代码”
  1. “验证您的跟踪代码”部分中输入您的网页网址。HubSpot 将自动测试您的网页,并通过电子邮件将结果发送给您。

Tracking code validator

某些网站可能无法通过自动工具进行测试,或者可能会显示错误的失败结果。如果您怀疑存在这种情况,可以手动验证您的安装。

  1. 点击账户右上角的账户名称,验证您的 Hub ID。
  2. 打开您网站上的一个页面,并在页面任意位置右键单击。
  3. 在下拉菜单中,选择“查看页面源代码”或“查看源代码”。
  4. 使用Ctrl + FCmd + F 搜索[您的 Hub ID].js(例如 401264.js

请注意:您 可能会看到 HubSpot 嵌入代码或异步 HubSpot 分析代码。这两者都是 HubSpot 跟踪代码,表明您的跟踪代码已安装。

如果您使用的是 Google 标签管理器或其他脚本加载器,跟踪代码将不会出现在页面源代码中。如果您使用的是WordPress 插件,只要未安装与其他插件冲突的插件,跟踪代码就会显示出来。

如果通过 Google 标签管理器安装了跟踪代码, 使用“预览 ”模式连接到该页面,选择第一个“页面 浏览”事件,并确认 HubSpot 跟踪标签是否出现在“已触发的标签”下

  • 如果跟踪代码显示出来,请确认该代码已从您的账户设置中正确复制并粘贴。
    要在 HubSpot 账户中检查跟踪代码:
    1. 点击顶部导航栏中的settings 设置图标
    2. 进入“跟踪与分析”设置:
      • 对于仅拥有Marketing Hub Starter或 HubSpot 免费工具访问权限的账户,请在左侧边栏菜单中导航至“跟踪代码”
      • 对于所有其他订阅计划,请在左侧边栏菜单中导航至“跟踪与分析” >“跟踪代码”
      • 跟踪代码位于“嵌入代码”部分。
  • 如果显示跟踪代码,请安装跟踪代码

请确认跟踪代码是否加载正确

如果您的跟踪代码已正确安装且显示在页面上,您需要验证跟踪代码是否正在加载:

  1. 在浏览器中打开您网站上的一个页面,然后在页面任意位置右键单击。
  2. 在下拉菜单中,选择“检查元素”或 “检查”。屏幕底部或侧边将出现一个工具栏。
  3. 点击“网络”选项卡 ,然后刷新页面。
  4. 点击“名称”列 按字母顺序对元素进行排序,然后滚动到列表顶部。
  5. “名称”列中,查找[您的 Hub ID].js(例如 401264.js)。在名称下方,您可能会看到来自 js.hs-scripts.com 的内容以及/或来自 js.hs-analytics.com 的该 .js 元素的实例。
  6. [您的 Hub ID].js旁边,“状态”列中应显示304 Not Modified200 OK
network-tab-trakcing-code-item
如果您看到其他状态,或者未找到 JavaScript 代码,则您的跟踪代码可能未正确触发。请检查浏览器 控制台中的 JavaScript 错误或阻塞因素,包括 Cookie 同意工具、广告或脚本拦截器、内容安全策略 (CSP) 限制,或标签管理器规则。
请联系 HubSpot 支持团队以获取进一步的故障排除和协助。

请注意: 在“网络”选项卡中,预计会同时看到来自 js.hs-scripts.com(脚本加载器)的 hubid.js 以及来自 js.hs-analytics.net(跟踪脚本)的 hubid.js。 如果您在网站上使用了 聊天流程,您还可能会看到第三个脚本,即来自 api.usemessages.com/messages 的 hubid.js

此外,即使您未使用HubSpot 的 Cookie 同意横幅应在“网络”选项卡中看到 js.hs-banner 脚本正在加载,因为该脚本负责将HubSpot 的 Cookie放置在访客的浏览器中。

如果存在脚本加载器js.hs-scripts.com,请同时检查跟踪脚本js.hs-analytics.net,以确保 代码能正确触发。如果您只看到实际的跟踪脚本js.hs-analytics.net而没有看到脚本加载器,跟踪代码仍会正确触发。

验证跟踪代码是否正常触发

如果您的跟踪代码已安装、显示在页面上且正在加载,请确认跟踪代码是否正常触发:

  1. 在浏览器中打开您网站上的一个页面,然后在页面任意位置右键单击。
  2. 在下拉菜单中,选择“检查元素”或 “检查”。屏幕底部或侧边将出现一个工具栏。
  3. 点击“网络”选项卡 ,然后刷新页面。
  4. 点击搜索栏并输入 __ptq.gif
  5. “名称”列中查找__ptq.gif
  6. __ptq.gif旁边,“状态”列中应显示200 OK

Network tab screenshot to verify tracking code is firing correctly

如果 HubSpot 跟踪代码已在您的网站页面上加载并触发,但您在仪表盘来源报告中未看到任何新的页面浏览量或会话,您可能需要更改目标域名或在跟踪代码设置中添加其他域名,以确保 HubSpot 从正确的域名或子域名收集分析数据。

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助