📦 plugin-google-gtag

Le plugin par défaut de Global Site Tag (gtag.js). Il s'agit d'un framework de balisage JavaScript et d'une API qui vous permet d'envoyer des données d'événements à Google Analytics, Google Ads et Google Marketing Platform. Cette section décrit comment configurer un site Docusaurus pour activer les balises globales pour Google Analytics.

astuce

Vous pouvez utiliser l'outil Google Tag Assistant pour vérifier si votre gtag est configuré correctement !

seulement en production

Ce plugin est toujours inactif en développement et uniquement actif en production pour éviter de polluer les statistiques d'analyse.

Installation

npm

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

Yarn

yarn add @docusaurus/plugin-google-gtag

pnpm

pnpm add @docusaurus/plugin-google-gtag

astuce

Si vous utilisez le preset @docusaurus/preset-classic, vous n'avez pas besoin d'installer ce plugin en tant que dépendance.

Vous pouvez configurer ce plugin via les options du preset.

Configuration

Champs acceptés :

Nom	Type	Par défaut	Description
trackingID	string | string[]	Obligatoire	L'ID de suivi de votre service gtag. Il est possible de fournir plusieurs ids.
anonymizeIP	boolean	false	Si l'adresse IP doit être anonymisée lors de l'envoi de requêtes.

Exemple de configuration

Vous pouvez configurer ce plugin via les options du preset ou du plugin.

astuce

La plupart des utilisateurs de Docusaurus configurent ce plugin via les options du preset.

Options du preset

Si vous utilisez un preset, configurez ce plugin via le options du preset :

docusaurus.config.js

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

Options du plugin

Si vous utilisez un plugin autonome, fournissez des options directement au plugin :

docusaurus.config.js

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