vue埋点核心是监听用户交互事件和生命周期钩子而非响应式数据,通过路由守卫、自定义指令(v-track)和全局事件捕获实现低侵入自动上报,覆盖pv、点击、曝光等场景。

Vue 中实现用户操作行为的埋点数据自动上报,核心不是靠 watch 或 computed 做数据监听,而是基于用户交互事件本身(如 click、scroll、expose)和生命周期钩子(如路由切换、组件挂载/卸载)来触发采集与上报。所谓“数据监听”在这里容易被误解——埋点关注的是行为发生,而非响应式数据变化。真正高效、低侵入的方案,是把行为捕获逻辑从业务代码中剥离,统一由指令、守卫、Observer 和封装函数承载。
下面分三类关键场景说明如何落地:
路由级行为:自动记录 PV 与停留时长
利用 Vue Router 的全局守卫,无需修改页面组件即可完成基础页面埋点:
- 在
router.beforeEach记录进入时间戳(存入localStorage或组件实例) - 在
router.afterEach读取上次时间戳,计算停留时长,拼装 PV 数据并上报 - 同时带上
from,to,referrer,screen等上下文字段
let startTime = 0
router.beforeEach((to, from) => {
startTime = performance.now()
// 可选:记录首次进入标记、UTM 参数等
})
router.afterEach((to, from) => {
const duration = performance.now() - startTime
trackPageView({
pageUrl: to.fullPath,
referrer: from.fullPath || document.referrer,
duration,
timestamp: Date.now()
})
})
组件级交互:用自定义指令统一捕获点击与曝光
避免每个按钮都写 @click="track('submit')", 改用声明式 v-track 指令:
-
点击埋点:指令绑定时监听
click,自动提取元素data-track-id、data-track-page等属性 -
曝光埋点:结合
IntersectionObserver,当元素进入视口即触发一次上报(防重复) - 指令内部自动携带当前路由、设备信息、时间戳等公共字段
示例指令简版(Vue 3 Composition API 风格):
app.directive('track', {
mounted(el, binding) {
const { value } = binding
const trackData = {
eventName: value.eventName || 'click',
elementId: el.dataset.trackId || '',
pageUrl: window.location.pathname,
timestamp: Date.now(),
...value.extra
}
if (value.type === 'click') {
el.addEventListener('click', () => trackEvent(trackData))
} else if (value.type === 'expose') {
const observer = new IntersectionObserver(entries => {
entries.forEach(entry => {
if (entry.isIntersecting) {
trackEvent({ ...trackData, eventType: 'expose' })
observer.unobserve(el)
}
})
}, { threshold: 0.1 })
observer.observe(el)
}
}
})
使用方式简洁明了:
<!-- 点击埋点 -->
<button v-track="{ type: 'click', eventName: 'login_btn_click' }">登录</button>
<!-- 曝光埋点 -->
<div v-track="{ type: 'expose', eventName: 'banner_ad_expose', extra: { adId: 101 } }">
广告位
</div>
全局行为兜底:自动捕获未覆盖的操作
对开发者未显式声明的交互,做一层“无感捕获”:
- 监听
document.body的click事件,通过 CSS 选择器或data-track属性匹配目标元素 - 表单提交、输入框失焦、视频播放等高频动作,通过
v-model修饰符 + 自定义v-input-track指令拦截 - 所有上报前统一节流(如 500ms 内最多发 1 次)、聚合(多个点击合并为 batch)、补全字段(UA、分辨率、用户 ID)
重点在于:
- 不依赖
watch监听某个变量变化来判断用户是否点了按钮(那是反模式) - 真正的“监听”,是监听 DOM 事件和浏览器 API(Performance、IntersectionObserver、Navigation Timing)
- 上报通道统一走
sendBeacon(页面卸载前)或节流后的fetch(普通事件),确保不阻塞主流程
基本上就这些。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










