google-analytics

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

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

Usage

npm i -D @vuepress/plugin-google-analytics@next

import { googleAnalyticsPlugin } from '@vuepress/plugin-google-analytics'

export default {
  plugins: [
    googleAnalyticsPlugin({
      // 选项
    }),
  ],
}

上报事件

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

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

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

Options

id

• 类型：string

• 必填：是

• 详情：

  Google Analytics 4 的测定 ID（Measurement ID），通常以 'G-' 开头。

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

• 示例：

  .vuepress/config.ts

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

debug

• 类型：boolean

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

• 示例：

  .vuepress/config.ts

  export default {
    plugins: [
      googleAnalyticsPlugin({
        id: 'G-XXXXXXXXXX',
        debug: true,
      }),
    ],
  }