新增自定义标签 — 按自有 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 小时，因此安装后，部分回访用户可能要到次日才会看到效果。