VuePress 生态系统VuePress 生态系统
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • AI 插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • AI 插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • baidu-analytics
  • clarity-analytics
  • google-analytics
  • umami-analytics

google-analytics

@vuepress/plugin-google-analytics

为你的 VuePress 站点无缝集成 Google Analytics 4 (GA4)。

该插件通过引入 Global Site Tag (gtag.js) 来支持强大的流量分析与用户追踪功能。

Usage

npm i -D @vuepress/plugin-google-analytics@next
.vuepress/config.ts
import { googleAnalyticsPlugin } from '@vuepress/plugin-google-analytics'

export default {
  plugins: [
    googleAnalyticsPlugin({
      // 选项
      id: 'G-XXXXXXXXXX',
    }),
  ],
}

指南

上报事件

Google Analytics 4 默认自动收集多种事件,例如 page_view(页面浏览)、first_visit(首次访问)和 scroll(滚动)等。

如果你只需要收集基础的站点数据,只需配置正确的 Measurement ID(测定 ID)即可。

如需更高级的追踪能力,该插件会在 window 对象上暴露全局 gtag() 函数。你可以利用该函数,基于用户在站点内的交互行为,通过编程方式上报自定义事件。

选项

id必填string

Google Analytics 4 的测定 ID(Measurement ID),通常以 'G-' 开头。

请参考官方指南查找你的测定 ID。请注意区分 Google Analytics 4 的测定 ID("G-" ID)与 Universal Analytics 的追踪 ID("UA-" ID)。

debugboolean

设置为 true 以启用向 Google Analytics DebugView 发送事件的功能。这对于在开发过程中验证配置和调试事件数据非常有用。了解更多关于 DebugView 的信息。

在 GitHub 上编辑此页
上次更新: 2026/9/28 04:40
贡献者: Mister-Hope
上一页
clarity-analytics
下一页
umami-analytics