如何用 Google Tag Manager 安裝熱點圖（免改程式碼，5 分鐘完成）

重點摘要

用 GTM 就能完全不動網站程式碼，直接安裝熱點圖

只要 5 個步驟：建立 Custom HTML 標籤 → 套用 All Pages 觸發條件 → 發布

成功的標準不是「沒有錯誤訊息」，而是 HeatMapX 儀表板上的數字開始跑動

如果你的網站已經在用 Google Tag Manager（GTM）管理標籤，那麼透過 GTM 安裝熱點圖追蹤是最乾淨俐落的方式：所有操作都在 GTM 介面完成，完全不用改任何程式碼。這篇教學會一步一步帶你完成設定。

開始之前：先取得你的網站金鑰（site key）

註冊 HeatMapX（有免費方案，不需要信用卡），登錄你的網站，就會拿到一組網站金鑰（site key）。

拿到金鑰後，你會用到以下格式的標籤——記得把 YOUR-SITE-KEY 換成你實際拿到的金鑰：

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

重要提醒： 請貼上完整的標籤，而不是只貼網址。data-site-key="..." 這個屬性是用來告訴 HeatMapX 這筆資料屬於哪個網站——如果你漏掉這個屬性，或只貼了 src 網址，系統就完全不會追蹤到任何資料。

GTM 設定步驟（共 5 步）

打開 GTM 管理主控台（tagmanager.google.com），選擇你網站所在的容器（workspace）
從左側選單點選「標籤」→「新增」，在標籤類型中選擇「Custom HTML」
把上面那段完整標籤貼到 HTML 欄位裡
在觸發條件設定中選擇「All Pages（Page View）」，幫這個標籤取一個容易辨識的名稱（例如 HeatMapX），然後儲存
點右上角的「Submit / Publish」，把變更正式發布上線

這樣就完成了——現在你網站的每一個頁面都會開始追蹤。

想在發布前先確認？（Preview 模式）

在 GTM 點「Preview」，就能在自己的瀏覽器上先測試標籤，不用真的發布上線。透過預覽畫面（Tag Assistant）打開你的網站，如果你的 HeatMapX 標籤出現在「Fired」欄位下，就代表運作正常。

標籤沒有觸發？檢查清單

是否有按下 Publish？ 只儲存並不會把變更推上線，這是最常見的原因
觸發條件是不是 All Pages？ 如果設成只在特定頁面觸發，其他頁面就不會被追蹤到
是不是被 Cookie 同意橫幅（consent mode）擋住了？ 有些同意管理工具會讓 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」數字在持續上升，就代表追蹤已經生效了。

成功的標準不是「沒有錯誤」，而是儀表板上的數字真的在動。如果數字完全沒有變化，請照著上面的檢查清單依序排查。