📦 plugin-google-gtag

The default Global Site Tag (gtag.js) plugin. It is a JavaScript tagging framework and API that allows you to send event data to Google Analytics, Google Ads, and Google Marketing Platform. Essa seção descreve como configurar um site do Docusaurus para habilitar a tag global do site do Google Analytics.

tip

Você pode usar a ferramenta Assistente de Tags do Google para verificar se sua tag está configurada corretamente!

production only

This plugin is always inactive in development and only active in production to avoid polluting the analytics statistics.

Instalação

npm

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

Yarn

yarn add @docusaurus/plugin-google-gtag

pnpm

pnpm add @docusaurus/plugin-google-gtag

Bun

bun add @docusaurus/plugin-google-gtag

tip

If you use the preset @docusaurus/preset-classic, you don't need to install this plugin as a dependency.

You can configure this plugin through the preset options.

Configuração

Campos aceitos:

Nome	Type	Padrão	Descrição
trackingID	string | string[]	Required	The tracking ID of your gtag service. It is possible to provide multiple ids.
anonymizeIP	boolean	false	Whether the IP should be anonymized when sending requests.

Configuração de exemplo

Você pode configurar este plugin através das opções de predefinição ou opções do plugin.

tip

A maioria dos usuários do Docusaurus configura este plugin através das configurações de predefinição.

Opções de predefinição

Se você usar uma predefinição, configure este plugin através do opções de predefinição:

docusaurus.config.js

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

Opções do plugin

Se você estiver usando um plugin independente, forneça opções diretamente para o plugin:

docusaurus.config.js

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