📦 plugin-google-gtag

默认的全局站点标签(gtag.js)插件。它是一个 JavaScript 标签框架和 API，允许您将事件数据发送到谷歌分析, 谷歌广告和谷歌营销平台。本节介绍如何配置 Docusaurus 站点以启用谷歌分析的全局站点标签。

提示

您可以使用谷歌标签助理工具来检查您的 gtag 是否设置正确!

只生产

这个插件在开发中总是不活跃的，并且只在生产中活跃，以避免污染分析统计。

安装

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[]	Required	您的 gtag 服务的跟踪 ID。可以提供多个 id。
anonymizeIP	boolean	false	发送请求时是否对 IP 进行匿名化。

示例配置

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

提示

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

预设选项

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

docusaurus.config.js

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

插件选项

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

docusaurus.config.js

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