真实用户体验
真实用户体验:在访客浏览器里实测页面加载、交互和稳定性指标,并统计资源与请求错误,在控制台按 p75 评级查看。
作用
节点在被采样到的 HTML 页面里注入一行同源脚本,由访客的浏览器测出真实的加载速度、交互响应和页面稳定性,并上报资源加载失败、导航失败和 fetch、XHR 请求错误。数据汇总后在控制台按 p75 评级显示。
使用场景
- 想知道真实访客感受到的速度,而不是实验室测速。
- 对比改版、换线路或开启缓存前后的体验变化。
- 按页面、国家/地区、设备类型定位慢的位置。
- 发现某个资源或接口持续报错。
在哪里配置
开启:网站管理,选择网站,编辑,“高级设置”里“其它”卡片的“真实用户体验上报”开关,开启后设置“采样率”。查看:统计分析,真实用户体验。节点需要支持该功能,未升级的节点在发布时会列出。
配置项
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 真实用户体验上报 | 关闭 | 网站级开关 |
| 采样率 | 10% | 1% 到 100%;节点每 100 次页面请求约注入这么多次 |
报表上可以选择网站,时间范围有近 1 小时、近 24 小时、近 7 天、近 30 天。
报表内容
| 指标 | 含义 |
|---|---|
| LCP | 最大内容绘制 |
| INP | 交互到下次绘制 |
| CLS | 累计布局偏移 |
| FCP | 首次内容绘制 |
| TTFB | 首字节时间 |
每项指标显示 p75 值和“良好、需改进、差”的评级与占比,以及 p75 趋势。下方按“页面、国家/地区、设备”三个页签看分布,设备分桌面、手机、平板。“资源与请求错误”按资源、导航、fetch、XHR 分类,显示元素、目标、状态码和次数。数据约有 1 到 2 分钟延迟。
脚本不采集查询字符串、IP 和 Cookie,也不生成访客标识。
常见问题
开启后报表一直是空的
发布生效后要有访客浏览被采样到的页面才会出现数据;开启前缓存的页面要等到过期或刷新缓存后才会带上脚本。
页面没有上报
网站设置了 Content-Security-Policy 时,需要在 script-src 和 connect-src 里放行 'self'。设置了 Referrer-Policy: no-referrer 的页面无法上报。
某些浏览器没有 LCP 或 INP
这两项依赖浏览器支持,不支持的浏览器不上报,报表里会标注该区间没有浏览器上报此指标。
样本少时的数字可靠吗
样本很少时报表会标注“样本少”,请结合更长的时间范围看。