核心方案是uni.report配合页面生命周期:onShow记进入时间戳,onHide或onUnload记离开时间戳,通过两端差值计算停留时长,避免仅用onLoad/onUnload导致前台切后台场景漏统计。

uni.report 配合页面生命周期是核心方案
uni-app 没有内置「自动计算页面停留时长」的功能,必须手动用 uni.report 上报进入和离开时间戳,再由后台或自己解析差值。关键不是“统计时长”,而是“记录两个时间点”——onShow 记起点,onHide 或 onUnload 记终点。
-
onShow中调用uni.report('page_show', { page: 'goods_detail', ts: Date.now() }),确保每次切回前台都刷新起点(比如从后台返回、Tab 切换) -
onHide中上报离开事件:uni.report('page_hide', { page: 'goods_detail', ts: Date.now() });若页面确定不会被缓存(如用redirectTo),也可放在onUnload - 避免只在
onLoad和onUnload埋点——这会漏掉「前台切后台再切回」的场景,导致时长严重低估 - 注意:iOS App 和部分小程序中,
onHide可能延迟触发或不触发(如强退),所以单靠两端差值会有误差,建议配合 session 级别兜底逻辑(比如 30 分钟无 activity 视为会话结束)
为什么不能只用 setInterval 持续上报?
直接在页面里启个 setInterval 每 10 秒调一次 uni.report 看似简单,但实际不可行:
- App 和小程序进入后台后,
setInterval会被系统挂起(iOS 微信几秒即停),上报立刻中断 - 频繁上报增加服务端压力,且无业务意义——你并不需要“每 10 秒知道一次用户还在”,只需要“他来了、他走了”
- 公有版 uni 统计后台不提供原始时间戳导出,所有
uni.report数据按事件聚合,无法反向拼出连续轨迹 - 如果真要高频采样(如性能监控),应走独立日志通道,而非混入业务统计事件流
页面路径与参数怎么传才不混乱?
上报停留时间时,page 字段必须稳定可区分,否则后台无法归因。常见问题不是“没传”,而是传得不一致:
- 不要用
getCurrentPages()动态拼路径——它返回的是带 query 的完整路径(如/pages/goods/detail?id=123),会导致同一页面被拆成 N 条记录 - 推荐做法:统一提取路由名,例如
/pages/goods/detail→goods_detail,再加必要维度:{ page: 'goods_detail', category: 'shoes', from: 'search' } - 避免在
param里塞过长字符串或实时数据(如用户输入内容),uni 统计对单字段长度有限制,超长会被截断 - 如果页面支持多入口(分享链接、通知跳转、首页入口),建议把
from作为必传字段,方便后续分析渠道质量
私有化部署时如何补全时间差?
如果你用了私有版 uni 统计(数据进自己 uniCloud),可以利用云函数做轻量级补全:
- 前端只报
page_show和page_hide事件,带ts时间戳和page标识 - 云函数定时扫描最近 5 分钟的
page_show事件,找出未匹配page_hide的记录,按规则打标(如 “超时未离开”,设为 300 秒) - 注意:不要在云函数里做复杂 join 或跨天聚合,uniCloud 免费额度有限,简单标记 + 前端二次处理更稳
- 本地调试时,可用
uni.setStorageSync临时存 pair 数据(showTs + hideTs),验证逻辑是否正确,上线前务必删掉
真实场景里,页面停留时间最常被忽略的不是技术实现,而是「定义分歧」:产品说的“停留”指首次显示到彻底离开,而开发可能只埋了 onLoad/onUnload;用户切后台 2 小时又回来,该算 2 小时还是只算前后台活跃段?这些必须在埋点前对齐口径,否则数据出来全是噪音。











