新增自訂標籤 — 依自有 A/B 測試變體篩選熱圖

HeatMapX 現已支援自訂標籤。只要在頁面中加入一行程式碼，該訪客的每一次點擊、捲動、滑鼠移動事件都會帶上標籤，之後就能在後台依標籤篩選熱圖。

這項功能源自一位客戶的需求：「我們的 A/B 測試已經在自己的程式碼裡跑了，只是想依變體分別查看熱圖。」它並不侷限於 A/B 測試——只要是網站已經知道的訪客屬性，例如是否登入、會員所在的方案、來自哪個行銷活動，都能拿來劃分區隔。

使用方式

在已安裝追蹤標籤的頁面中加入以下程式碼。放在追蹤標籤之前或之後皆可運作（較早呼叫的會先排入佇列，待標籤載入後再套用）。

<script>
  window.hmx = window.hmx || function(){ (window.hmx.q = window.hmx.q || []).push(arguments) };
  hmx('set', 'ab_variant', 'B');
</script>

若由伺服器端渲染 HTML，也可以在追蹤標籤之前一次傳入。

<script>window.heatmapxTags = { ab_variant: 'B', plan: 'pro' };</script>

標籤會在同一瀏覽器分頁內的頁面切換間保留，因此只需在造訪開始時設定一次即可。使用 hmx('unset', 'ab_variant') 可移除標籤。

在後台篩選

開啟某個網站下某個頁面的熱圖後，右上角的篩選列（裝置篩選旁邊）會出現**「標籤」**下拉選單。每個選項都會顯示鍵、值與工作階段數，例如 ab_variant = B (128)。選擇其中一項後，點擊、捲動、滑鼠移動熱圖都會僅依該區隔重新繪製。

若網站還沒有任何帶標籤的資料，下拉選單不會顯示。安裝後，一旦收到第一筆帶標籤的事件，該選項就會出現。

在 MCP 伺服器中篩選

供 Claude 等 AI 工具呼叫的 MCP 伺服器同樣支援標籤。

• 向 get_heatmap_summary 傳入 tags: { "ab_variant": "B" }，即可取得該區隔的摘要。多個鍵之間以 AND 條件組合。
• 新增的 list_tags 工具可回傳網站上觀測到的所有鍵與值。

規則

• 鍵：小寫英文字母、數字、_、-，長度 1 到 32 個字元（大寫字母會自動轉換為小寫）。值：長度 1 到 64 個字元。同時最多保留 10 個鍵。
• 請勿在值中放入可識別個人身分的資訊，例如電子郵件地址、使用者 ID 或訂單編號。同時包含 @ 與 . 的值不會被儲存。
• 每個鍵在最近 30 天內最多儲存 50 個不同的值，超出的新值會被忽略。
• 若不使用標籤，傳送的內容與以往完全相同。

價格方案

包含免費方案在內的所有方案皆可使用。

影響範圍

沿用您現有的追蹤標籤，不會帶來額外變動。未設定標籤的網站不受影響。追蹤指令碼（tracker.js）會在瀏覽器中快取最長 24 小時，因此安裝後，部分回訪使用者可能要到隔天才會看到變化。