HeatMapXHeatMapX
价格登录

如何在 Shopify 店铺安装热图(无需安装应用,仅需一行代码)

HeatMapX Engineering Team5 min read
  • how-to
  • shopify
  • ecommerce
  • heatmap
  • installation

文章摘要

  • 在 Shopify 中添加热图,只需将一行代码粘贴到 theme.liquid 中——无需安装任何应用
  • 编辑前务必先复制一份主题作为备份。保存后改动会立即生效——与 STUDIO 不同,这里没有单独的"重新发布"步骤
  • 结账页面不运行主题代码,因此不会被追踪。判断成功与否,应看 HeatMapX 仪表盘中的计数是否真正增加,而不只是"没有报错"

想知道能否在不安装应用的情况下为 Shopify 店铺添加热图?答案是可以。Shopify 允许你直接将一行标签代码粘贴到主题中,无需任何应用。本指南将带你了解编辑前应先做的备份步骤、如何添加标签、如何确认其是否生效,以及几个需要注意的事项。

第一步:获取你的站点密钥

首先,注册 HeatMapX 账号(提供免费方案),登记你的店铺,获取站点密钥(site key)。无需信用卡。

拿到站点密钥后,使用下方的标签代码,将 YOUR_SITE_KEY 替换为你实际获得的密钥。

<script src="https://heatmapx.com/tracker.js" data-site-key="YOUR_SITE_KEY"></script>

操作步骤:将标签添加到 theme.liquid

1.(必做)先复制一份主题作为备份

在直接编辑代码之前,务必先复制当前使用的主题。在 Shopify 后台中,进入 在线商店 → 主题,找到你已发布的主题,点击 "…"(操作)菜单,选择 复制。这样即可获得一份安全副本,一旦出现问题可以随时回退。跳过这一步,就意味着一旦误改代码将无法撤销。

2. 打开代码编辑器

  1. 在 Shopify 后台中,进入 在线商店 → 主题
  2. 在已发布的主题上,点击 "…"(操作)菜单,选择 编辑代码
  3. 左侧会打开该主题的文件浏览器

3. 在 layout/theme.liquid 中添加标签

  1. 在文件列表中,打开 "Layout" 文件夹,点击 theme.liquid
  2. 在文件中搜索 </head>,将上方的标签代码粘贴在其正前方
  3. 保存文件

4. 保存即完成——无需重新发布

在 Shopify 中,编辑主题代码保存的瞬间即刻生效。与 STUDIO 不同,这里没有单独的"发布"或"重新发布"步骤。保存后,你的正式店铺就已经加载了该标签。

如何确认追踪功能真正生效

添加标签后,请在你的店铺中浏览几个页面。但这里有个关键点。

页面加载无报错,并不等于追踪功能真的在正常工作。 即便浏览器控制台没有显示任何异常,站点密钥输错,或标签粘贴位置不对,都可能导致数据从未真正传送到 HeatMapX。

唯一可靠的确认方法,是打开 HeatMapX 仪表盘,在站点列表中找到你的店铺,确认其计数是否真的在增加。 浏览几个页面(商品页、分类页等)后,如果计数有所增加,说明安装成功。

需要注意的事项

结账页面不会被追踪

你添加到 theme.liquid 中的标签运行于店铺前台——首页、商品页、分类页和购物车页面——但不会运行于结账页面/checkouts/ 路径下的支付页面)。结账页面由 Shopify 直接托管,独立于你的主题之外,theme.liquid 中的主题代码永远不会在那里加载。如果你在仪表盘中发现结账页面没有数据,这是正常现象,并非故障。

切换主题需要重新添加标签

该标签只存在于你所编辑主题的 theme.liquid 文件中。如果之后你切换到其他主题(发布新主题),新主题的 theme.liquid 不会自动带有该标签。每次切换主题时,请重复相同步骤,将标签添加到新主题中。

常见问题

问:这会拖慢我的店铺速度吗? 答:该标签以异步方式加载,且体积很小,对页面加载速度的影响微乎其微。

问:我已经添加了标签,但仪表盘中的计数没有增加 答:最常见的原因是站点密钥不匹配——粘贴了其他站点的密钥,或复制时遗漏了某个字符。同时请确认你测试的页面是店铺前台页面(首页、商品页、分类页),而不是结账页面,因为结账页面本就不会被追踪。

结语

在 Shopify 添加热图,归根结底只需将一行代码粘贴到 theme.liquid 中——无需任何应用。HeatMapX 提供免费方案即可开始使用,不妨试试看,了解购物者在你的店铺中的真实体验。

从 Claude Code 运行的热力图,免费开始。

粘贴一行追踪标签,从 CLI 获取分析和改进建议。