📦 plugin-google-analytics

Le plugin par défaut Google Analytics. Il s'agit d'une bibliothèque JavaScript permettant de mesurer la façon dont les utilisateurs interagissent avec votre site web dans la version de production. Si vous utilisez Google Analytics 4, vous devrez peut-être envisager d'utiliser plugin-google-gtag à la place.

Obsolète

Ce plugin est obsolète, et deviendra inutile le 1er juillet 2023.

Google s'éloigne de Universal Analytics.

Si vous utilisez toujours ce plugin avec un identifiant de suivi UA-*, vous devriez créer un compte Google Analytics 4 dès que possible, et utilisez @docusaurus/plugin-google-gtag au lieu de ce plugin. Plus de détails ici.

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-analytics

Yarn

yarn add @docusaurus/plugin-google-analytics

pnpm

pnpm add @docusaurus/plugin-google-analytics

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	Obligatoire	L'ID de suivi de votre service d'analyse.
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',
      {
        googleAnalytics: {
          trackingID: 'UA-141789564-1',
          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-analytics',
      {
        trackingID: 'UA-141789564-1',
        anonymizeIP: true,
      },
    ],
  ],
};