📦 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.
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.
Ce plugin est toujours inactif en développement et uniquement actif en production pour éviter de polluer les statistiques d'analyse.
Installation
- npm
- Yarn
- pnpm
npm install --save @docusaurus/plugin-google-analytics
yarn add @docusaurus/plugin-google-analytics
pnpm add @docusaurus/plugin-google-analytics
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.
La plupart des utilisateurs de Docusaurus configurent ce plugin via les options du preset.
- Options du preset
- Options du plugin
Si vous utilisez un preset, configurez ce plugin via le options du preset :
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
googleAnalytics: {
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
},
],
],
};
Si vous utilisez un plugin autonome, fournissez des options directement au plugin :
module.exports = {
plugins: [
[
'@docusaurus/plugin-google-analytics',
{
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
],
],
};