Google Analytics Reader

Le node Google Analytics Reader récupère les données GA4 — sessions, utilisateurs, pages vues, conversions et revenus — via une liste curée de métriques, dimensions et plages de dates.

À quoi sert le node Google Analytics ?

Le node Google Analytics Reader se connecte à Google Analytics 4 et récupère des données de rapport à la demande. Vous choisissez un account et une property, sélectionnez des métriques et dimensions dans une liste GA4 curée, définissez une plage de dates, et le node renvoie les lignes sous forme de chaîne JSON prête à être traitée par les nodes suivants.

Cas d’usage typiques :

• Construire des rapports de trafic hebdomadaires ou mensuels automatisés sans se connecter à GA4.
• Suivre des entonnoirs de conversion en combinant des métriques d’événements (conversions, eventCount) avec des dimensions de source de trafic.
• Comparer la performance d’une année sur l’autre pour une property donnée et envoyer le résultat à un LLM pour un commentaire narratif.
• Lancer des rapports multi-propriétés en batch — alimentez les properties depuis une liste et un seul node itère.

Configuration rapide

Paramètres de configuration

Champs obligatoires

Champs optionnels

Que produit le node en sortie ?

Le node produit une chaîne JSON contenant les lignes renvoyées par l’API GA4 Data. Chaque ligne mélange les dimensions choisies avec les métriques, aplaties dans un seul objet.

Exemple de sortie :

{
  "rows": [
    {
      "date": "20260115",
      "country": "France",
      "sessions": 1500,
      "activeUsers": 1200,
      "engagementRate": 0.62
    },
    {
      "date": "20260115",
      "country": "United States",
      "sessions": 4200,
      "activeUsers": 3100,
      "engagementRate": 0.58
    }
  ]
}

Exemples d’utilisation

Exemple 1 : Rapport de trafic hebdomadaire vers Google Sheets

Vous voulez un instantané hebdomadaire automatisé des sessions et utilisateurs actifs par pays, écrit dans un Google Sheet partagé.

Configuration :

• Account / Property : choisis inline.
• Metrics : sessions,activeUsers,engagementRate
• Dimensions : date,country
• Date Range : last_7_days
• Row limit : 10000

Connectez la sortie à un node Google Sheets Writer et ajoutez les lignes à un onglet Weekly Traffic.

Exemple 2 : Rapport multi-propriétés en batch

Vous gérez 30 properties GA4 pour différents clients et voulez un rapport par property, à la demande.

Configuration :

• Ajoutez un node d’entrée Google Analytics Property, en mode batch, alimenté depuis un CSV listant les 30 properties.
• Sur le Reader, activez Use Integration Variable (qui active automatiquement Use Variables).
• Branchez integration_id, account_id et property_id du node d’entrée vers le Reader.
• Metrics : sessions,totalRevenue,conversions
• Dimensions : sessionDefaultChannelGroup
• Date Range : last_28_days

Chaque ligne du CSV déclenche un appel Reader ; envoyez la sortie dans un LLM pour générer un commentaire narratif par client.

Exemple 3 : Comparaison année sur année

Comparez ce mois de mars avec le mars précédent pour une property.

Configuration A (mars de cette année) :

• Date Range : personalized
• Start date : 2026-03-01, End date : 2026-03-31
• Metrics : sessions,totalUsers,totalRevenue

Configuration B (mars de l’année dernière) : même node dupliqué, avec start_date=2025-03-01 et end_date=2025-03-31.

Fusionnez les deux sorties dans un node LLM et demandez un commentaire de delta.

Problèmes courants

La liste Account ou Property est vide

Cause : Le compte Google derrière l’intégration n’a accès à aucune property GA4, ou l’intégration vient d’être créée et le cache des properties n’a pas été rafraîchi.

Solution : Dans Google Analytics, vérifiez que le compte a au minimum le rôle Viewer sur la property cible. Puis rouvrez les paramètres du node — l’autocomplete est récupéré en live depuis l’API GA Admin lors de l’ouverture.

Le node renvoie zéro ligne alors que la property a du trafic

Cause : La plage de dates choisie est en dehors de la fenêtre de rétention des données de la property, ou la combinaison métrique/dimension est invalide pour GA4 (certaines paires sont rejetées par l’API Data).

Solution : Élargissez d’abord la plage à last_28_days et retirez toutes les dimensions pour confirmer que la property répond. Puis rajoutez les dimensions une par une — l’API GA4 Data rejette certaines combinaisons (par exemple, certaines métriques user-scoped avec des dimensions event-scoped).

Erreur de plage de dates personnalisée : format invalide

Cause : start_date ou end_date n’est pas au format YYYY-MM-DD, ou end_date est antérieure à start_date.

Solution : Utilisez des chaînes de date ISO comme 2026-03-01. Quand vous alimentez les dates depuis des nodes en amont, formatez-les en amont plutôt que de compter sur les valeurs par défaut de la locale.

Erreur d'autorisation ou de permission depuis GA4

Cause : Le token OAuth derrière l’intégration a été révoqué, expiré, ou l’utilisateur n’a plus accès à la property.

Solution : Ouvrez Settings > Integrations, trouvez l’intégration Google Analytics et reconnectez-la. Si le compte Google sous-jacent a perdu l’accès à la property, redonnez le rôle Viewer dans GA4 Admin.

Mélanger un account fixe et une property en variable est bloqué

Cause : Le toggle Use Variables est atomique — account et property basculent ensemble. Sinon, le runner laisserait une property en amont écraser l’account fixe, ce qui produirait des paires account/property incohérentes.

Solution : Soit gardez account et property fixes tous les deux, soit activez Use Variables et alimentez-les depuis des input handles en amont.

Bonnes pratiques et pièges

Comment s’intègre-t-il dans un workflow ?

Google Analytics Reader est typiquement un node de source de données placé près du début d’un workflow, qui alimente une étape de transformation ou un writer.

graph LR
    Trigger[Schedule trigger] --> GA[Google Analytics Reader]
    GA --> Extract[JSON Path Extractor]
    Extract --> LLM[LLM commentary]
    LLM --> Sheets[Google Sheets Writer]

Nodes associés