本页目录
  1. 1. 脚本真的加载了吗
  2. 2. 采集请求发出去了吗
  3. 3. 打开「实时」页
  4. 4. 核对域名
  5. 5. 再看几项项目状态
  6. 还是没找到原因

先说一个容易误会的地方:采集接口对每一条请求都返回 202,包括被丢弃的。丢弃的原因只记在项目这边,不会回给浏览器。所以浏览器网络面板里看到 202,只能说明请求发出去了,不代表进了报表。

判断有没有入库,唯一可靠的办法是看控制台的「实时」页。下面的步骤就是围绕这一点。

1. 脚本真的加载了吗

打开你的网站,按 F12 打开开发者工具,切到「网络」面板,刷新页面,在筛选框里输入 client.js。

  • 有这条请求,状态 200:脚本加载成功,往下看第 2 步。
  • 没有这条请求:脚本标签没出现在页面里。查看网页源代码确认一下,常见原因是改了模板但没发布、加在了只有首页用的模板里,或者缓存插件还在返回旧页面。
  • 请求被标成失败或「已阻止」:多半是广告拦截插件或网站的内容安全策略拦掉了,见 内容安全策略与拦截插件。

2. 采集请求发出去了吗

还在网络面板,筛选 pulse。正常情况下,页面加载后会有一条发往 api.pathclue.com 的 POST 请求。

没有这条请求时,最常见的原因是浏览器开了「请勿跟踪」或「全局隐私控制」。这两个开关打开时,脚本默认完全不运行,这是有意的设计,尊重访客的选择。换一个没开这些开关的浏览器,或者用手机流量打开试试。

另一个原因是你在 localhost 上测试,本地地址默认不发送。

3. 打开「实时」页

请求发出去了,就到控制台「网站统计 › 实时」看最近几分钟。实时页里有,其他报表过一会儿也会有;实时页里没有,其他报表也不会有。

4. 核对域名

请求发了、实时却是空的,几乎都是域名的问题。到「网站统计 › 配置 › SDK 代码」看登记的域名:

  • 是不是写成了 https://example.com/ 这种带协议、带斜杠的形式?只能填 example.com。
  • 你访问的是不是另一个域名?比如登记的是正式站,你在测试站 staging-example.net 上看。子域名会自动放行,但完全不同的域名不会。

5. 再看几项项目状态

如果域名也没问题,再确认这几项:

  • 排除规则:你是不是之前点过「排除我自己」,或者加了排除路径?排除是在采集端执行的,命中了就不入库。
  • 月度额度:免费版每月 50 万 个事件,超出后当月剩下的时间不再入库,下个月 1 日重置。用量在控制台「统计套餐与用量」里能看到。
  • 时区:报表的「今天」按项目时区切。如果项目时区比你所在地晚,你刚才那次访问可能被记在了「昨天」。

还是没找到原因

把这几样信息发给我们:网站地址、你访问的具体页面、访问时间(精确到分钟),以及网络面板里 client.js 和 pulse 两条请求的截图。我们能在项目这边查到被丢弃的原因。在线咨询或者发邮件都可以。

本主题下一篇项目设置:时区、排除规则、会话和站内搜索