TapCub 正式上线:统计、分析、客服一个平台免费用
帮助中心

在网站上安装 TapCub

一段代码同时覆盖统计和在线客服。这篇讲贴在哪里、怎么确认数据到了,以及实时报表一直是空的时候查什么。

快速开始3 分钟阅读最后更新 2026 年 9 月 28 日TapCub 团队

开始之前

你需要一个 TapCub 账号,并在控制台里创建好站点。还没创建的话先看添加站点,大约两分钟,拿到下面要用的站点 Key。

你还需要能编辑网站每个页面共用的模板,或者建站平台的「自定义代码」区域。服务器上不用装任何东西。

统计和在线客服共用这一段代码。装上它不会出现客服气泡,客服在你按挂件指南启用之前一直是关闭的。

添加代码

打开 网站统计配置SDK 代码,复制页面上的代码,里面已经带了你的站点 Key。它长这样:

index.html
<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY"></script>

把它贴到每个页面的 </head> 之前。脚本压缩后约 2 KB,异步加载,不会阻塞渲染。首次加载发送一次页面浏览,之后站内 URL 变化时再发。

  1. 登记主机名。 在同一个 SDK 代码页添加访客实际使用的域名,不带 https:// 和路径。子域名自动允许。未登记主机名的数据会被静默丢弃。
  2. 贴上代码。 每个页面一份。如果一个页面出现两份,只有第一份会运行。
  3. 部署并打开网站。 在普通浏览器标签里打开已登记域名下的页面。用 file:// 打开本地文件不会发送。

建站平台与 CMS

不需要安装插件。每个建站平台都有「全站头部代码」的位置,把代码放进去一次即可:

平台贴在哪里
WordPress头部代码插件,或在子主题里挂 wp_head。放全局头部,不要逐篇文章贴。WordPress 步骤
Shopifytheme.liquid 的 <head> 里。平台托管的结账页不运行主题脚本,所以这段代码统计不到结账页。Shopify 步骤
Webflow / Wix / Squarespace站点设置 → 自定义代码 → head。用全站字段,不要用单页字段。
Hugo、Hexo、Jekyll、Ghost、Typecho主题共用的 head 片段。
Next.js、Nuxt、Vue、React根布局或应用外壳。单页应用已经覆盖——脚本会监听路由变化。路由用 # 的话,给标签加 data-hash="true"。单页应用
Google Tag Manager在所有页面触发的自定义 HTML 代码。GTM 步骤

如果主题缓存了渲染后的 HTML,改完头部后要清一次缓存,否则旧页面会继续不带代码地输出。

确认第一条访问

一个标签打开 网站统计实时,另一个标签打开你的网站。几秒内应该看到这次页面浏览,路径和标题一致。

如果没有,打开浏览器的网络面板,按顺序查两条请求:

  1. client.js 已加载。 没有的话,说明代码不在页面里,或者被浏览器扩展拦了。
  2. 一条到 /api/v1/pulse 的 POST。 脚本加载了但没有 POST,说明浏览器拦住了请求(见下文)。有 POST 但实时为空,说明被我们这边丢弃了——最常见的原因是主机名没登记。

采集接口对已存储和已丢弃的数据都返回 202。202 只证明请求到了,不证明被计数。实时报表是唯一的凭据。

常见安装问题

现象可能原因与处理
脚本加载了,没有 POST浏览器开了 Do Not Track 或 Global Privacy Control。TapCub 默认尊重两者,脚本会直接返回。换一个没开这些开关的浏览器测。
没有 POST,控制台报 CSP 错误你的 Content-Security-Policy 需要在 script-src 和 connect-src 里放行 TapCub 的源。身份识别和全埋点扩展从同一目录加载;在线客服从单独的客服域名加载,被拦时浏览器控制台会报出主机名。
有 POST,实时为空主机名未登记、站点已暂停、当月额度用完,或命中了排除规则。查 SDK 代码页和套餐用量。
线上正常,本地没数据localhost 默认不发送。测试期间给标签加 data-allow-local="true" 并登记 localhost,测完都去掉。在 localhost 上测试
单页应用只记一次浏览Hash 路由需要 data-hash="true"。较晚替换 history.pushState 的框架可能需要把标签放到 head 更靠前的位置。

每一种原因和处理办法都在装好了为什么没有数据里。查完还是空的?通过联系页把页面地址和网络面板截图发给我们,通常一次回复就能定位。

接下来可以开什么

相关阅读

这篇回答解决你的问题了吗?

我们会根据反馈修改和补充这篇内容。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie