Google Analytics
Connectez Google Analytics à une application MeDo : listez les comptes et propriétés GA4, lisez les rapports de trafic et les visiteurs en direct, retrouvez l'ID de mesure d'un flux web et ajoutez le suivi à l'application.
Google Analytics est un connecteur : il relie une application MeDo à un compte Google qui peut ouvrir vos propriétés Google Analytics 4 (GA4), afin que l'application puisse lister les comptes et les propriétés, lire les rapports standard et en temps réel, et retrouver l'ID de mesure d'un flux de données web. Tout ce que l'application voit provient du compte que vous avez connecté, et l'accès est en lecture seule.
Ce que vous pouvez construire
- Un tableau de bord de trafic. Choisissez une propriété et affichez les pages vues, les sessions et les utilisateurs d'une fenêtre de dates sous forme de graphique quotidien, avec les pages les plus consultées.
- Un rapport hebdomadaire. Comparez cette semaine à la précédente par source de trafic, pays ou appareil et mettez en évidence les plus grands écarts.
- Un panneau de visiteurs en direct. Affichez combien de personnes étaient actives sur le site au cours des 30 dernières minutes et quelles pages elles consultent.
- Le suivi de l'application elle-même. Lisez l'ID de mesure d'un flux web pour que l'application envoie ses propres pages vues et événements, comme un événement
sign_up, à Google Analytics.
Google Analytics convient lorsque l'application a besoin des vraies données de trafic du propriétaire. Il ne peut ni créer ni modifier des propriétés, des flux de données ou des paramètres — voir Limites.
Exemples de construction
Copiez l'un de ces textes dans la zone de saisie. Le premier est le point de départ le plus simple et déjà utile.
La formulation compte : dites à qui s'adresse la page et ce qu'elle doit afficher. « Un tableau de bord auquel moi seul peux me connecter » donne une application très différente d'« un compteur de visiteurs public ».
Préparer et connecter
Vous avez besoin d'un compte Google qui peut ouvrir les propriétés GA4 que l'application doit utiliser. Aucune clé API, aucun projet Google Cloud, aucune configuration de facturation.
- Ouvrez Skills & Connectors dans la barre latérale et recherchez Google Analytics.
- Ouvrez la carte Google Analytics et cliquez sur Connect.
- Connectez-vous au compte Google et autorisez l'accès en lecture seule demandé par MeDo.
- Le bouton passe à Connected. C'est l'état de succès ; vous n'avez rien à recopier dans l'application.
Si vous commencez à construire avant de connecter, MeDo le détecte et affiche un bouton de connexion Google Analytics sous sa réponse. Vous pouvez connecter depuis là. Si aucun bouton n'apparaît, utilisez la carte du connecteur décrite ci-dessus.
Utilisation dans votre application
- L'application utilise le compte connecté par le propriétaire, pas le compte Google de chaque visiteur. Tout visiteur qui accède à une vue de trafic voit les données du même compte. Placez derrière la connexion propre à l'application les tableaux de bord qui exposent plusieurs propriétés ou des rapports libres. Une page intitulée « privé » n'est pas un contrôle d'accès à elle seule. Une page qui affiche les chiffres clés d'un seul site fixe peut être publique, à condition que la propriété soit fixée côté serveur et que les visiteurs ne puissent pas en choisir une autre.
- Copiez les ID de propriété depuis le compte connecté. Utilisez la valeur
properties/<id>renvoyée par Google Analytics. Ne la devinez pas et ne réutilisez pas l'ID d'un autre compte. - Les rapports standard ont du retard. Le nouveau trafic peut mettre 24 à 48 heures à apparaître dans les rapports standard. Les données en temps réel apparaissent en quelques minutes et couvrent environ les 30 dernières minutes. Un rapport vide signifie qu'il n'y a pas eu de trafic sur cette fenêtre, pas un échec.
- Les rapports renvoient des valeurs sous forme de texte. Convertissez chaque valeur en nombre dans l'ordre des en-têtes du rapport avant de tracer un graphique. Quand un rapport compare deux plages de dates, Google Analytics ajoute une colonne de plage de dates.
- Les gros rapports se paginent par lignes. Une requête renvoie jusqu'à 1 000 lignes ; demandez la page suivante si vous en avez besoin de plus.
- N'affichez jamais de chiffres inventés. Si le compte n'est pas connecté ou si le rapport est vide, la page doit le dire plutôt que d'afficher des données d'exemple.
- Retrouvez l'ID de mesure au lieu de le saisir de mémoire. MeDo le lit dans le flux de données web de la propriété, afin que le code de suivi utilise le véritable ID.
Limites et dépannage
« Connexion requise » s'affiche dans l'application. La connexion Google Analytics appartient au propriétaire de l'application. Demandez-lui d'ouvrir la carte du connecteur et de cliquer sur Connect, puis de recharger.
Les rapports affichent des zéros ou un graphique vide. Cela signifie généralement que la propriété n'a pas eu de trafic sur la fenêtre, ou que les données ne sont pas encore arrivées. Élargissez les dates ou vérifiez que le site envoie bien des données à cette propriété.
La liste des propriétés est vide. Le compte Google connecté ne peut ouvrir aucune propriété GA4. Connectez le compte qui possède les propriétés.
Les visiteurs voient des analyses alors qu'ils ne devraient pas. La connexion est partagée. Ajoutez une connexion et des restrictions côté serveur à l'application ; voir Gérer l'accès et les rôles.
Voir aussi
- Catalogue de connecteurs — les autres connecteurs et leur usage.
- Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
- Gérer la connexion et les utilisateurs — donnez à une application ses propres comptes avant d'exposer des données connectées.