页面浏览埋点

页面浏览事件在多页面应用与 SPA 中的判定方式、采集时机和常见边界问题。

#type / concept #status / growing #tech / dev / frontend #platform / browser

[!info] related notes

页面浏览埋点

一句话定义

页面浏览埋点是在用户进入某个业务页面时记录一次 page_view 事件,但“什么算一个页面”在 MPA 和 SPA 中并不完全一样。

核心内容

  • 多页面应用里,页面加载通常天然对应一次浏览事件
  • SPA 中不能只监听 load,还要关注路由切换,例如 pushStatereplaceStatepopstate 或框架 router hook
  • 页面浏览不只是技术路由问题,还要看业务页面模型,例如 /product/1/product/2 在业务上往往是两个详情页
  • 一个稳定的 page_view 事件通常会带上 urlpathtitlereferrerroute_namequerypage_id

常见边界

  • 首次加载是否算一次
  • 重定向是否单独算一次
  • query 变化是否视为新页面
  • 弹窗、抽屉、嵌套路由是否应该建模成页面
  • 同一页面短时间重复进入是否需要去重

为什么它重要

  • 它经常是漏斗、停留时长、跳出率、来源归因等分析的起点
  • 如果 page_view 口径不稳,下游很多行为分析都会跟着失真

边界与易混淆点

  • 页面浏览埋点不等于性能埋点,后者更关心 LCP、INP、白屏等健康度
  • 监听到了路由变化,不代表一定要记成新页面,关键还是业务页面模型
创建于 2026/4/24 更新于 2026/5/27