更多: 快速开始
- 在网站上安装 TapCub
- 从 Google Analytics 4 或百度统计迁移
- 添加网站、App 或小程序
- WordPress 怎么安装 TapCub?
- Shopify 怎么安装 TapCub?
- TapCub 统计代码贴在哪里?
- 能用 Google Tag Manager 安装 TapCub 吗?
- React、Vue 或 Next.js 应用怎么统计?
- 怎么确认 TapCub 已经在收数据?
- 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?
- 怎么创建和管理 API 密钥?
- 怎么用 HTTP API 发送事件?
- 本分类全部文章
简短回答
打开开发者工具 › Network,勾选 Preserve log,刷新并重现问题,然后导出 HAR(Chrome/Edge 点下载箭头,Firefox 和 Safari 用保存/导出)。确认 client.js 返回 200、/api/v1/pulse 返回 202,只分享去掉 Cookie 和授权头的脱敏文件。
简短回答
在出问题的页面上打开浏览器开发者工具,进入 Network(网络) 面板,勾选 Preserve log(保留日志),刷新并重现问题,然后把记录导出为 HAR 文件(在请求列表上右键 → Save all as HAR,或点下载箭头)。发给任何人之前,先导出脱敏版本,或删掉 Cookie 和授权请求头。
HAR(HTTP Archive)文件是一份 JSON 记录,包含页面发出的每个请求:网址、方法、状态码、请求头、耗时,以及可选的响应内容。要说明 TapCub 脚本在你的网站上到底做了什么,这是最快的办法。
TapCub 客服什么时候会要 HAR 文件
- 安装检查说没有数据,但脚本标签明明在页面上。
- 有些页面或浏览器有页面浏览,有些没有。
- 事件或属性缺失,或看起来不对。
- 客服挂件不显示。
Chrome 和 Edge
- 打开页面,按 F12(Windows)或 ⌥⌘I(Mac),选择 Network。
- 勾选 Preserve log 和 Disable cache。
- 清空列表(🚫 图标),刷新页面,重现问题:跳转页面、点击按钮、提交表单。
- 点 Network 工具栏里的下载箭头(Export HAR),或在任意请求上右键 → Save all as HAR。
- 新版本默认导出脱敏的 HAR,不含 Cookie 和授权请求头。除非客服明确需要别的内容,保持默认即可。
Firefox
- 按 F12 或 ⌥⌘I,打开 Network。
- 打开 ⚙ 菜单,启用 Persist Logs;勾选 Disable Cache。
- 刷新并重现问题。
- 在请求列表里右键 → Save All As HAR。
Safari
- 打开开发菜单:Safari › 设置 › 高级 › 显示网页开发者功能。
- 开发 › 显示网页检查器 → 网络,勾选 保留日志。
- 刷新并重现问题。
- 点网络工具栏里的导出,保存 HAR。
发送之前先自己看一眼
很多时候你自己就能找到答案。在请求列表里筛选:
| 筛选 | 应该看到 | 如果没有 |
|---|---|---|
client.js | TapCub 脚本地址返回 200 | 被拦截(ERR_BLOCKED_BY_CLIENT):广告拦截插件,见广告拦截会拦 TapCub 吗?;没有这条请求:这个页面或模板上没放标签 |
pulse | 每个页面浏览或事件一条发往 /api/v1/pulse 的 POST,类型常显示为 ping(sendBeacon) | 没有请求:脚本没启动(检查 data-site),或被内容安全策略拦了(看 Console) |
pulse 的状态码 | 202 | 4xx 或网络错误:检查地址和 CSP |
注意:202 表示采集服务接受了请求,不代表事件已经存下来。 域名没登记、月度额度用完、或命中排除规则(比如内部流量过滤)时,它同样返回 202。看到 202 却没有数据,就接着查这些设置。本地 localhost 默认不统计,要在部署后的网址上测试。
保管好文件
HAR 文件可能包含会话 Cookie、登录令牌、表单内容和个人数据。分享之前:
- 在无痕窗口里重现问题,并退出无关服务的登录。
- 用脱敏导出,或者用文本编辑器打开文件,删掉
Cookie、Set-Cookie和Authorization请求头。 - 不要公开发布 HAR 文件。只通过工单发送,问题解决后删掉本地副本。
相关
这篇回答解决你的问题了吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。