如何通过 Google Tag Manager 安装热力图（无需改代码，5 分钟搞定）

一句话总结

用 GTM，你完全不需要改动网站代码就能安装热力图

五个步骤：创建 Custom HTML 标签 → 绑定 All Pages 触发器 → 发布

成功的标志是 HeatMapX 控制台上的数字在增长，而不只是"没有报错"

如果你的网站已经在用 Google Tag Manager（GTM）管理标签，那么通过 GTM 添加热力图追踪是最干净利落的方式：一切操作都在 GTM 界面里完成，完全不需要改代码。本文将带你一步步完成设置。

开始之前：获取你的站点密钥

拿到密钥后，你会用到下面这种形式的标签——把 YOUR-SITE-KEY 替换成你自己的实际密钥：

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

重要提示：要粘贴的是整个标签，而不仅仅是那个 URL。data-site-key="..." 这个属性告诉 HeatMapX 这些数据属于哪个网站——如果你漏掉它，或者只粘贴了 src 里的 URL，将不会有任何数据被追踪到。

GTM 设置流程（5 个步骤）

打开 GTM 控制台（tagmanager.google.com），选择你网站对应的容器（工作区）
在左侧菜单中依次点击"Tags（标签）"→"New（新建）"，标签类型选择"Custom HTML（自定义 HTML）"
把上面的整个标签粘贴到 HTML 输入框中
在触发条件（触发器）中选择"All Pages（Page View，全部网页）"，给标签起一个容易识别的名字（例如 HeatMapX），然后保存
点击右上角的"Submit / Publish（提交／发布）"，将改动推送上线

到这里就完成了——现在网站的每个页面都会开始追踪。

想在发布前先确认一下？（预览模式）

在 GTM 中点击"Preview（预览）"，可以在自己的浏览器中先测试标签，再正式上线。通过预览界面（Tag Assistant）打开你的网站，如果你的 HeatMapX 标签出现在"Fired（已触发）"一栏，就说明设置成功了。

标签没有触发？排查清单

是否点了发布（Publish）？ 只保存不会让改动生效上线，这是最常见的原因
触发器是不是 All Pages？ 如果触发器只限定于某个页面，其他页面就不会被追踪
是不是被 Cookie 同意横幅（同意模式）拦住了？ 有些同意管理工具会在访客同意之前暂时不发送 Custom HTML 标签。请检查该标签的同意设置，以及你的同意管理工具（CMP）对它的分类
data-site-key 是否正确？ 粘贴了别的网站的密钥，会导致数据被记录到错误的网站上

让 Claude Code 带你完成设置

如果你不想在 GTM 界面里到处摸索，也可以请 Claude Code 这样的 AI 助手来带你操作。复制下面的提示词，换成你自己的站点密钥，然后粘贴发送即可。

I want to deploy the HeatMapX heatmap tracking tag via Google Tag Manager.
Walk me through the GTM interface one step at a time, waiting for my reply at each step.

The tag to use (Custom HTML, All Pages trigger):
<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

如果你不使用 GTM，而是想把标签直接写进网站代码里，用下面这个版本可以让 Claude Code 帮你完成文件修改。

Install the HeatMapX heatmap tracking tag in this project.
Make sure the following tag is included right before </head> on every page, and tell me which files you changed.

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

HeatMapX 的设计也支持通过 Claude Code 拉取和分析你的数据（CLI 集成）——设置完成后，可以在控制台的"CLI & Skills"页面查看具体用法。

验证是否生效：数字应该在增长

安装完成后，先自己浏览几个网站页面，再打开 HeatMapX 控制台。如果你的网站"Sessions today（今日会话数）"在持续增加，就说明追踪已经在正常运行。

成功的标志不是"没有报错"，而是控制台上的数字在增长。如果数字没有任何变化，请按顺序检查上面的排查清单。