📦 Google 标签管理器插件

一个用于将 Google 标签管理器 (gtm.js) 添加到 Docusaurus 站点的插件。将此插件与标准 gtag 插件结合使用，可以深入分析用户如何使用您的网站。

提示

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

仅限生产环境

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

安装

npm

npm install --save @docusaurus/plugin-google-tag-manager

Yarn

yarn add @docusaurus/plugin-google-tag-manager

pnpm

pnpm add @docusaurus/plugin-google-tag-manager

Bun

bun add @docusaurus/plugin-google-tag-manager

提示

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

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

配置

接受的字段

名称	类型	默认值	描述
containerId	字符串	必需	您的标签管理器容器 ID（通常以 GTM- 开头）。

示例配置

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

提示

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

预设选项

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

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        googleTagManager: {
          containerId: 'GTM-12345',
        },
      },
    ],
  ],
};

插件选项

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

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-google-tag-manager',
      {
        containerId: 'GTM-12345',
      },
    ],
  ],
};