📦 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.
Vous pouvez utiliser l'outil Google Tag Assistant pour vérifier si votre gtag est correctement configuré !
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-gtag
yarn add @docusaurus/plugin-google-gtag
pnpm add @docusaurus/plugin-google-gtag
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.
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',
{
gtag: {
trackingID: 'G-999X9XX9XX',
anonymizeIP: true,
},
},
],
],
};
Si vous utilisez un plugin autonome, fournissez des options directement au plugin :
module.exports = {
plugins: [
[
'@docusaurus/plugin-google-gtag',
{
trackingID: 'G-999X9XX9XX',
anonymizeIP: true,
},
],
],
};