📦 plugin-google-gtag

默认的 全局网站标签 (gtag.js) 插件。它是一个 JavaScript 标签框架和 API，允许您将事件数据发送到 Google Analytics、Google Ads 和 Google Marketing Platform。本节介绍如何配置 Docusaurus 站点以启用 Google Analytics 的全局网站标签。

提示

您可以使用 Google 的标签助手 工具检查您的 gtag 是否已正确设置！

production only

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

安装

npm

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

Yarn

yarn add @docusaurus/plugin-google-gtag

pnpm

pnpm add @docusaurus/plugin-google-gtag

提示

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

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

配置

接受的字段：

名称	类型	默认值	描述
trackingID	string | string[]	必需	您的 gtag 服务的跟踪 ID。可以提供多个 ID。
anonymizeIP	boolean	false	发送请求时是否应匿名化 IP。

示例配置

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

提示

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

Preset options

If you use a preset, configure this plugin through the preset options:

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        gtag: {
          trackingID: 'G-999X9XX9XX',
          anonymizeIP: true,
        },
      },
    ],
  ],
};

Plugin options

If you are using a standalone plugin, provide options directly to the plugin:

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-google-gtag',
      {
        trackingID: 'G-999X9XX9XX',
        anonymizeIP: true,
      },
    ],
  ],
};