Connecter Google Analytics 4 (GA4)

Trouvez l’ID de propriété GA4 (numérique), placez la clé JSON du compte-service, donnez-lui l’accès en lecture, puis validez la connexion dans FlowLead.

Connexion à Google Analytics 4

Où trouver l’ID de propriété GA4 ?

  1. Ouvrez Google Analytics.
  2. Allez dans Admin (roue dentée) → colonne Propriété.
  3. Copiez l’ID de propriété au format numérique (ex. 312345678).

Ne pas confondre :

  • ID de mesure (Measurement ID) : G-XXXXXXXX → ❌ ce n’est pas cela
  • ID de flux (Stream ID) : numérique mais lié au flux → ❌
  • ID de propriété GA4 : 312345678 → ✅ c’est celui-là
312345678 Copié !

Placer la clé JSON du compte-service

Déposez la clé JSON de votre compte-service dans le dossier suivant (lecture par l’application uniquement) :

storage/app/analytics/ Copié !
  • Nom de fichier recommandé : service-account.json (ou celui attendu par ta config).
  • Ne pas committer le fichier dans Git. Ajoute-le à .gitignore.
  • Vérifie les droits (lecture par l’utilisateur PHP).

Donner l’accès au compte-service dans GA4

Ajoutez le compte-service comme utilisateur de la propriété GA4 (rôle Lecteur/Viewer suffit). Si vous utilisez le compte-service FlowLead :

analytics-flowpi@flowpi-1740667084404.iam.gserviceaccount.com Copié !

Étapes :

  1. Dans GA : Admin → Propriété → Gestion des accès à la propriété.
  2. Ajouter un utilisateur → collez l’e-mail du compte-service → rôle Lecteur (Viewer) (ou Analyst).
  3. Enregistrez. L’accès en lecture à la propriété est actif.

Si vous utilisez une autre clé JSON, ajoutez l’e-mail indiqué dans cette clé comme utilisateur.

Finaliser la connexion dans FlowLead

  1. Renseignez l’ID de propriété GA4 (numérique, ex. 312345678).
  2. Indiquez le chemin de la clé JSON si nécessaire (storage/app/analytics/service-account.json).
  3. Cliquez sur Tester la connexion, puis Sauvegarder.
Ouvrir l’intégration GA4

Si le bouton est inactif, remplace la route par celle de ta page d’intégration.

Dépannage rapide

Le test échoue : « accès refusé »

Vérifiez que le compte-service a bien été ajouté dans GA4 (Admin → Gestion des accès à la propriété) avec le rôle Lecteur/Viewer, et que l’ID de propriété est correct (numérique).

J’ai saisi un identifiant en G-XXXX

C’est l’ID de mesure (Measurement ID). Remplacez-le par l’ID de propriété GA4 au format numérique, visible dans la colonne Propriété.

Clé JSON introuvable

Assurez-vous que le fichier est bien dans storage/app/analytics/, que le nom correspond à votre configuration, et que les droits de lecture sont valides pour PHP.

Aucune donnée ne remonte

Attendez quelques minutes puis réessayez. Confirmez que vous regardez la bonne propriété et que des données existent sur la période sélectionnée.