Skip to content

行为埋点 ​

命令式四件套(track / click / expo / pageview)与声明式 data-trace-* autoTrack 两种接法。概念、坐标规则与完整 API 见 行为埋点。

为什么声明式区单独起实例

全局 playground 实例 autoTrack:false,避免在 VitePress 单页应用里随路由持续产生 pageview / dwell 噪音。本页声明式容器单独挂一个 autoTrack:true 的局部实例(root 收窄、卸载即销毁)来真实演示自动采集。

停留标记(hide / show / leave) ​

hide / show / leave 由 DwellCollector 产出,而它的启动被 TrackingPlugin 的 autoTrack 门控——不传 autoTrack 就没有停留标记,也没有 Auto PageView。全局 playground 实例正是 autoTrack:false,所以在别的页面上怎么切标签页都不会有 hide/show,这是预期行为而非故障。

下面这张卡固定建一个 autoTrack 开启的局部实例(声明式采集 root 收窄到卡内,避免与上面的声明式区双报)来补上这条链路:

  • 合成档:派发 visibilitychange(hidden) / (visible),页面不真的切走。hide 随同一次派发的卸载 keepalive 批同步发出;show 与 hide 同为 P1,只入队不即时发,要等空闲调度——卡片会分别显示 flush 前后的结果,这正是「切回来没看到 show」的常见观感来源。
  • 真实档:起实例后真的切走标签页再切回来,表格按实例实际发出的批体统计,出现在表里即证明真的上报了。

基于 MIT 协议发布(内部使用)