📦 plugin-google-analytics

默认的 Google Analytics 插件。它是一个 JavaScript 库，用于衡量用户如何与您的网站进行交互 **在生产构建中**。如果您使用的是 Google Analytics 4，您可能需要考虑使用 plugin-google-gtag 代替。

已弃用

此插件 **已弃用**，并将于 2023 年 7 月 1 日失效。

Google 正在 逐步淘汰 Universal Analytics。

如果您仍在使用此插件并使用 UA-* 跟踪 ID，则应尽快创建 Google Analytics 4 帐户，并使用 @docusaurus/plugin-google-gtag 代替此插件。更多详情 请点击此处。

仅限生产环境

此插件在开发环境中始终处于非活动状态，并且 **仅在生产环境中处于活动状态**，以避免污染分析统计数据。

安装

npm

npm install --save @docusaurus/plugin-google-analytics

Yarn

yarn add @docusaurus/plugin-google-analytics

pnpm

pnpm add @docusaurus/plugin-google-analytics

提示

如果您使用预设 @docusaurus/preset-classic，则无需将此插件作为依赖项安装。

您可以通过 预设选项 配置此插件。

配置

接受的字段

名称	类型	默认值	描述
trackingID	字符串	必需	您的分析服务的跟踪 ID。
anonymizeIP	布尔值	false	发送请求时是否应匿名化 IP。

示例配置

您可以通过预设选项或插件选项配置此插件。

提示

大多数 Docusaurus 用户通过预设选项配置此插件。

预设选项

如果您使用预设，请通过 预设选项 配置此插件

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        googleAnalytics: {
          trackingID: 'UA-141789564-1',
          anonymizeIP: true,
        },
      },
    ],
  ],
};

插件选项

如果您使用的是独立插件，请直接向插件提供选项

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-google-analytics',
      {
        trackingID: 'UA-141789564-1',
        anonymizeIP: true,
      },
    ],
  ],
};