Intégration Google Analytics
Ajoutez Google Analytics 4 à votre site de documentation avec un ID de mesure pour suivre les visiteurs et l'engagement.
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 ID de mesure GA4 (Google Analytics 4) qui commencent par G-.
Obtenir votre ID de mesure
- Accédez à Google Analytics
- Sélectionnez votre propriété (ou créez-en une)
- Accédez à Admin → Data Streams
- Sélectionnez votre flux Web (ou créez-en un)
- Copiez l'ID de mesure (commence par
G-)
Ajouter GA4 à vos docs
Ajoutez l'ID de mesure à votre docs.json :
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Remplacez G-XXXXXXXXXX par votre ID de mesure réel.
Consulter vos données
Après avoir ajouté l'intégration :
- Déclenchez un rebuild de vos docs
- Visitez votre site de documentation en ligne
- Dans Google Analytics, accédez à Reports → Real-time
- Vous devriez voir votre visite apparaître en 30 secondes
Les données peuvent mettre 24 à 48 heures pour apparaître dans les rapports standards. Utilisez les rapports en temps réel pour une vérification immédiate.
Utiliser 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 Intégration Google Tag Manager pour plus de détails.
Vous êtes responsable de la mise en place de bannières de consentement aux cookies pour toute balise que vous chargez via Google Tag Manager, si nécessaire. Jamdesk charge votre conteneur GTM pour tous les visiteurs sans porte de consentement. Consultez Consentement aux cookies pour restreindre l'analytique jusqu'à ce que les visiteurs acceptent.
N'ajoutez pas la même propriété GA4 à la fois directement dans docs.json et via Google Tag Manager, car cela entraînerait un suivi en double.
Considérations sur la confidentialité
Google Analytics collecte des données sur les visiteurs. Pensez à :
- Ajouter une bannière de consentement aux cookies si le RGPD/CCPA s'applique. Jamdesk charge GA4 pour chaque visiteur par défaut ; utilisez Consentement aux cookies pour le restreindre jusqu'à leur consentement.
- Mettre à jour votre politique de confidentialité pour mentionner l'analytique
- Utiliser l'anonymisation IP si nécessaire
Dépannage
- Vérifiez votre ID de mesure - Il doit commencer par
G- - Vérifiez les bloqueurs de publicité - 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 standards ont un délai de 24 à 48 heures
L'ID doit :
- Commencer par
G- - Contenir uniquement des lettres et des chiffres après
G- - Être copié exactement depuis Google Analytics (sans espaces superflus)