Intégration Google Analytics
Ajoutez Google Analytics 4 (GA4) à votre site de documentation. Nécessite un identifiant de mesure commençant par G-.
Ajoutez Google Analytics 4 à votre site de documentation pour comprendre comment les utilisateurs interagissent avec votre contenu.
L'intégration Google Analytics fonctionne avec les identifiants de mesure GA4 (Google Analytics 4) qui commencent par G-.
Obtenir votre identifiant de mesure
- Accédez à Google Analytics
- Sélectionnez votre propriété (ou créez-en une)
- Allez dans Admin → Flux de données
- Sélectionnez votre flux web (ou créez-en un)
- Copiez l'identifiant de mesure (commence par
G-)
Ajouter GA4 à votre documentation
Ajoutez l'identifiant de mesure à votre docs.json :
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Remplacez G-XXXXXXXXXX par votre identifiant de mesure réel.
Consulter vos données
Après avoir ajouté l'intégration :
- Déclenchez un rebuild de votre documentation
- Visitez votre site de documentation en ligne
- Dans Google Analytics, allez dans Rapports → Temps réel
- Votre visite devrait apparaître dans les 30 secondes
Les données peuvent prendre 24 à 48 heures pour apparaître dans les rapports standard. Utilisez les rapports en temps réel pour une vérification immédiate.
Utilisation avec Google Tag Manager
Si vous utilisez déjà Google Tag Manager, vous pouvez configurer GA4 via GTM plutôt que de l'ajouter directement. Consultez l'intégration Google Tag Manager pour plus de détails.
N'ajoutez pas la même propriété GA4 à la fois directement dans docs.json et via Google Tag Manager — cela entraînera un suivi en double.
Considérations relatives à la confidentialité
Google Analytics collecte des données sur les visiteurs. Pensez à :
- Ajouter une bannière de consentement aux cookies si requis par le RGPD/CCPA
- Mettre à jour votre politique de confidentialité pour mentionner l'analytique
- Utiliser l'anonymisation des IP si nécessaire
Dépannage
- Vérifiez votre identifiant de mesure - Il doit commencer par
G- - Vérifiez les bloqueurs de publicités - Ils peuvent bloquer les scripts d'analytique
- Attendez le rebuild - Les modifications nécessitent un nouveau build pour prendre effet
- Utilisez les rapports en temps réel - Les rapports standard ont un délai de 24 à 48 heures
L'identifiant doit :
- Commencer par
G- - Ne contenir que des lettres et des chiffres après
G- - Être copié exactement depuis Google Analytics (sans espaces supplémentaires)