跟踪
跟踪单页应用
使用 React、Next.js、Vue、Nuxt、Angular 及类似框架构建的单页应用 (SPA) 可以与 Umami 开箱即用。跟踪脚本会自动检测客户端导航并记录页面浏览,无需任何额外配置。
基本设置#
像其他任何网站一样,将 Umami 跟踪脚本添加到应用程序的 <head> 中。该脚本同时处理传统的页面加载和客户端路由更改。
Next.js (App Router)#
将脚本添加到您的根布局中:
或者,使用 Next.js 的 Script 组件:
React (Vite / Create React App)#
将脚本标签添加到您的 index.html 中:
Vue / Nuxt#
对于 Nuxt,将其添加到 nuxt.config.ts 中:
对于使用 Vite 的普通 Vue,像 React 一样将脚本添加到 index.html 中。
Angular#
将脚本添加到 src/index.html 中:
工作原理#
Umami 的跟踪脚本会监控浏览器的 History API(pushState 和 replaceState)以及 popstate 事件。当您的 SPA 导航到新路由时,Umami 会自动发送带有更新后 URL 和标题的页面浏览记录。
这意味着在大多数情况下,您不需要手动调用 umami.track() 来记录页面浏览。
在组件中跟踪自定义事件#
要跟踪组件内的按钮点击或其他交互,请使用 data 属性 方法或直接调用 umami.track():
或使用 JavaScript:
故障排除
- 导航后未跟踪页面:确保跟踪脚本仅在根布局中加载一次,不要在每次路由更改时重新添加。
- 重复的页面浏览:避免在
useEffect或onMounted钩子中无参数调用umami.track(),因为跟踪器已经自动记录导航。 - 基于哈希的路由:如果您的应用使用哈希路由(
/#/page),Umami 默认会跟踪这些。如果需要,您可以使用data-exclude-hash="true"禁用哈希收集。