更多： 快速开始
- 在网站上安装 TapCub
- 从 Google Analytics 4 或百度统计迁移
- 添加网站、App 或小程序
- WordPress 怎么安装 TapCub？
- Shopify 怎么安装 TapCub？
- TapCub 统计代码贴在哪里？
- 能用 Google Tag Manager 安装 TapCub 吗？
- React、Vue 或 Next.js 应用怎么统计？
- 怎么确认 TapCub 已经在收数据？
- 什么是站点，能添加几个？
- 站点该选哪个时区？
- 需要登记哪些域名？
- 怎么不让自己的访问进报表？
- 访客数为什么和 Google Analytics 4 对不上？
- 能同时跑 TapCub 和 Google Analytics 4 吗？
- GA4 的目标和事件怎么搬到 TapCub？
- 能把 GA4 的历史数据导入吗？
- Squarespace 怎么安装 TapCub？
- Wix 怎么安装 TapCub？
- TapCub 需要哪些内容安全策略（CSP）规则？
- 广告拦截器会拦住 TapCub 吗？
- 怎么从服务端上报事件？
- 怎么在 React 上安装 TapCub？
- 怎么在 Nuxt 上安装 TapCub？
- 怎么在 Vue 上安装 TapCub？
- 怎么在 Next.js 上安装 TapCub？
- 怎么为 TapCub 客服抓取 HAR 文件？
- 怎么创建和管理 API 密钥？
- 怎么用 HTTP API 发送事件？
- 本分类全部文章
简短回答
通常是三件事之一：实际输出的页面里还没有代码；你自己的浏览器发了脚本会尊重的隐私信号；域名没在 SDK 代码页登记。
原因与处理
| 现象 | 原因与处理 |
|---|---|
没有 client.js 请求 | 实际输出的页面里没有代码。清网站或 CDN 缓存，确认改的是线上真正在用的模板，或者在拦截它的扩展里放行。 |
client.js 加载了，没有 POST | 浏览器发了 Do Not Track 或 Global Privacy Control，脚本尊重了它。换一个没开这些信号的浏览器配置测。 |
| 控制台报 CSP 错误 | 在 script-src 放行脚本主机、在 connect-src 放行上报主机。见 CSP 与 SRI。 |
| 有 POST，实时为空 | 到 数据管理数据质量 看原因。最常见的是域名没登记；也可能是站点已暂停、当月额度用完，或排除规则命中了这个页面或你的 IP。 |
| 部分页面没有 | 页面路径命中了排除规则或代码里的 data-exclude，或者那个模板没改到。 |
| 单页应用只有一次页面浏览 | Hash 路由要加 data-hash="true"。见单页应用。 |
| 用无头浏览器测试 | 无头模式的 Puppeteer、Playwright 访问通常会被识别为机器人，不进访客报表和实时报表。用普通浏览器测。 |
在 localhost 上测试
脚本在 localhost、127.0.0.1 等本地地址上什么都不发，开发流量不会混进报表。确实要在本地测试，两件事都要做：
- 给标签加
data-allow-local="true"。 - 在 SDK 代码页把
localhost登记为域名。 它同时覆盖127.0.0.1。
测完把两项都去掉，否则本地访问会一直混进数字里。用 file:// 打开的页面永远不会被统计。
原来有数据，后来停了
先查额度和套餐：超过当月事件额度的数据会被丢弃，直到下个周期或升级。到达上限时会发生什么，见套餐与额度。另一个常见原因是换主题或改版替换了模板。
还是不行？通过联系页把页面地址和网络面板截图发给我们。
另见：HAR 文件。
这篇回答解决你的问题了吗？
我们会根据反馈修改和补充这篇内容。
提交没有成功，请稍后再试。
谢谢你的反馈，我们会据此改进这篇内容。你已经反馈过这篇了，谢谢。