Google Analytics 4 (import)

1. Ce qui est importé, et ce qui ne l’est pas

Les deux méthodes lisent les données de votre compte Google et s’activent séparément. Elles répondent à des questions différentes ; vous n’avez pas besoin des deux.

Méthode	Données récupérées	Utilité
Data API	Totaux quotidiens : sessions, utilisateurs, pages vues, sessions avec engagement	Mesurer la couverture. GA4 compte 3 000 sessions, MousePlayer en a enregistré 40 : sans chiffre de référence, vous ne pouvez même pas constater l’écart.
Import BigQuery	Sessions GA4 individuelles avec leurs événements	Savoir ce qui s’est passé lors d’une visite que MousePlayer n’a pas pu enregistrer.

Une session importée ne peut pas être relue. GA4 ne conserve ni capture de la page ni mouvement de souris : il n’y a donc rien à partir de quoi construire une relecture. Vous obtenez des chiffres et des événements à côté de vos enregistrements, rien de plus, et nous ne les présentons pas autrement.

Les données importées ont leurs propres tables et ne sont jamais mélangées à vos enregistrements. Sinon, la signification de chaque indicateur dérivé changerait silencieusement — profils comportementaux, valorisation des visiteurs, analyse des frictions — et personne ne pourrait ensuite distinguer les lignes mesurées des lignes récupérées.

2. Méthode 1 : Data API

Il vous faut deux éléments : l’identifiant de propriété et une clé de compte de service.

L’identifiant de propriété n’est pas l’identifiant de mesure

C’est l’erreur la plus fréquente, et le message de Google ne la nomme pas. L’identifiant de mesure ressemble à G-ABC123XYZ, figure dans votre extrait de code de suivi et se retrouve partout. L’identifiant de propriété est entièrement numérique et n’apparaît que dans l’administration, sous Administration, Paramètres de la propriété. C’est ce second identifiant qu’il faut ; nous refusons le premier avec une explication pour vous éviter une erreur 400.

Créer et autoriser le compte de service

Dans Google Cloud Console, créez un compte de service et générez une clé JSON.
Dans le même projet, activez la Google Analytics Data API.
Dans GA4, sous Administration, Gestion des accès à la propriété, ajoutez l’adresse e-mail du compte de service avec le rôle Lecteur. Un compte de service est un utilisateur à part entière ; sans cette étape, Google répond par une erreur 403, sans en préciser la raison.

Collez le contenu du fichier JSON dans le champ. Il est stocké sous forme chiffrée et ne sera ensuite affiché que sous forme abrégée.

3. Méthode 2 : import BigQuery

Cette méthode lit l’export brut de GA4. Vous devez le configurer une fois dans GA4 : Administration, Associations BigQuery. Les tables n’apparaissent que le lendemain — avant cela, l’import ne trouve rien, et ce n’est pas une erreur.

Les informations à saisir

L’identifiant du projet GCP qui contient l’export. Ce n’est pas forcément le projet vers lequel vous exportez les données MousePlayer.
L’identifiant de l’ensemble de données. GA4 lui donne le nom analytics_<propertyId>.
Une clé de compte de service avec le rôle Lecteur de données BigQuery sur l’ensemble de données et Utilisateur de tâches BigQuery dans le projet. L’accès en lecture suffit ; n’accordez pas de droits supplémentaires.

Le coût et qui le paie

BigQuery facture selon le nombre d’octets lus, et cette facture est à votre charge. C’est pourquoi l’import ne lit que quelques jours par exécution et ne lance qu’une seule requête : une seconde relirait les mêmes tables. Un plafond strict interrompt également la requête avant qu’elle ne devienne coûteuse ; dans ce cas, le journal de livraison indique que la période est trop grande.

La fréquence

Par défaut, toutes les six heures, chaque exécution récupérant à nouveau les trois derniers jours. Ce choix a une raison : GA4 complète les données pendant 48 heures, et l’export quotidien n’apparaît que le lendemain. Des requêtes plus fréquentes ne fournissent pas des chiffres plus récents, seulement les mêmes.

4. La clé qui relie les deux côtés

Si vous activez aussi la passerelle analytique vers GA4, MousePlayer enregistre avec chaque session l’identifiant client issu du cookie _ga . C’est exactement la valeur que l’export BigQuery contient dans user_pseudo_id.

Elle permet d’associer une session GA4 à l’un de vos enregistrements et, inversement, de voir ce que GA4 a compté lors de la même visite. Sans la passerelle, les deux sources restent simplement côte à côte, sans lien.

Ce même champ contient aussi votre propre identifiant client si vous utilisez setUserId(). Les deux ne peuvent pas coexister : il contient soit l’identifiant client Google, soit votre propre identifiant.

5. Consentement, conservation, suppression

Les données importées reposent sur un cookie

Seules les lignes contenant un user_pseudo_id sont importées. Lorsqu’un visiteur refuse, GA4 envoie des signaux sans cookie via Consent Mode, dépourvus de cet identifiant : ils sont donc exclus sans qu’une simple promesse soit nécessaire. Les lignes modélisées, c’est-à-dire estimées, sont exclues pour la même raison : enregistrer une estimation comme une session reviendrait à stocker des visites qui n’ont jamais eu lieu.

Durée de conservation

180 jours par défaut, à compter du jour décrit par la ligne, et non du moment de l’import. Sinon, le délai n’expirerait jamais, puisque chaque exécution récupère les mêmes jours.

Suppression

Si un visiteur demande l’effacement de ses données, ses sessions GA4 importées sont également supprimées, dans la mesure où l’identifiant ci-dessus permet de les lui attribuer. Si vous supprimez le projet, elles sont toutes supprimées, y compris les lignes qui n’ont jamais été associées à l’un de vos enregistrements. Le traitement quotidien de conservation les laisse volontairement intactes : les données GA4 suivent leur propre calendrier, et vos enregistrements expirent plus tôt.

6. Si aucune donnée n’arrive

Chaque exécution inscrit son résultat dans le journal de livraison de la page des intégrations, y compris les échecs, en termes clairs. Cela suffit généralement à comprendre ce qui manque.

Message	Que faire
L’identifiant de propriété doit être entièrement numérique	Vous avez saisi l’identifiant de mesure. Le bon numéro se trouve dans GA4, sous Paramètres de la propriété.
Erreur HTTP 403 de la Data API	Le compte de service n’a pas le rôle Lecteur sur la propriété GA4, ou la Data API n’est pas activée dans le projet GCP.
Ensemble de données ou tables d’export introuvables	L’association BigQuery manque, l’ensemble de données porte un autre nom, ou une journée ne s’est pas encore écoulée.
Accès refusé (BigQuery)	Le compte de service n’a pas le rôle Lecteur de données BigQuery sur l’ensemble de données ou Utilisateur de tâches BigQuery dans le projet.
La requête aurait lu trop de données	Le plafond de coût l’a interrompue avant toute facturation. Choisissez une période plus courte.
aucune session sur la période	Ce n’est pas une erreur. Il n’y a eu aucune session avec consentement sur les jours récupérés.

Comment pouvons-nous vous aider ?