Comment installer Google Analytics sur une application mobile
Pour installer Google Analytics sur une application mobile, configurez une propriété Analytics associée à Firebase, puis enregistrez l’application Android ou iOS. Ajoutez son fichier de configuration et le SDK Analytics au projet ; sur iOS, initialisez également Firebase selon l’architecture utilisée. Définissez ensuite les événements utiles et vérifiez leur déclenchement avec DebugView. Terminez par la configuration des paramètres personnalisés nécessaires aux rapports et une recette des parcours réels.
Installer Google Analytics sur une application mobile demande de relier la configuration dans les consoles Google au code de l’application. Le parcours documenté repose sur le SDK Google Analytics for Firebase, qui collecte certains événements automatiquement et permet d’ajouter des événements adaptés à votre activité. Ces données sont ensuite consultables dans la console Firebase. Présentation de Google Analytics for Firebase.
La réussite du projet dépend autant du choix des actions à mesurer que de l’intégration technique. Voici un parcours pour préparer la mesure, installer les composants Android ou iOS, puis vérifier les données avant de les utiliser. Les recommandations d’organisation et les exemples proposés dans cet article sont des conseils de la rédaction d’Anaska, comparateur édité par WebGuard Agency.
1. Définir ce que l’analytics doit vous apprendre
Commencez par écrire les questions auxquelles les données devront répondre. Une application de réservation peut chercher à comprendre où les utilisateurs abandonnent leur demande. Une application de formation peut vouloir distinguer la consultation d’un cours de son achèvement. Ces exemples sont fictifs : ils montrent comment partir d’une décision produit plutôt que d’une liste de boutons à suivre.
Pour chaque question, précisez l’action observable et sa signification. « L’utilisateur a terminé sa réservation » reste ambigu tant que vous ne choisissez pas entre l’affichage d’un écran, l’envoi d’une demande et la confirmation effective. Nous conseillons de retenir un déclencheur que l’équipe produit et les développeurs peuvent décrire de la même façon, puis reproduire pendant une recette.
Préparez un document de mesure indiquant le nom prévu de l’événement, son déclencheur, ses paramètres et la question associée. Ajoutez les cas dans lesquels il ne doit pas partir. Ce document servira de référence lors des tests et des évolutions. Google distingue les événements collectés automatiquement des événements supplémentaires que vous pouvez enregistrer avec le SDK. Documentation sur les événements Analytics.
2. Choisir le point de départ entre Analytics et Firebase
Vous pouvez démarrer depuis Google Analytics en créant une propriété, puis un flux « Application iOS » ou « Application Android ». L’assistant crée alors le projet Firebase et le flux correspondants ; il réalise également leur association si elle n’existe pas déjà. Pour rattacher une propriété à un projet Firebase existant, Google indique de procéder depuis Firebase, avec une propriété qui n’est pas déjà associée à Firebase. Configurer une propriété et un flux d’application.
L’autre parcours consiste à créer un projet dans Firebase et à y configurer Google Analytics. Vous pouvez sélectionner un compte Analytics existant ou en créer un. Si Analytics n’a pas été configuré au départ, les guides Firebase indiquent qu’il peut être ajouté ultérieurement dans l’onglet des intégrations des paramètres du projet. Configuration depuis Firebase.
Avant de créer quoi que ce soit, nous conseillons donc de relever les projets, comptes et propriétés déjà utilisés par votre organisation. Faites confirmer la destination des données par la personne qui exploitera les rapports. Consignez ensuite les noms et identifiants retenus dans le dossier du projet. Cette préparation donne aux développeurs une cible claire et évite de découvrir une ambiguïté au moment de la validation.
3. Préparer les accès, les identifiants et les environnements
Pour créer une propriété Analytics, Google demande le rôle Éditeur. La configuration comprend notamment le nom de la propriété, le fuseau horaire et la devise des rapports. Le fuseau horaire mérite une décision explicite : Google précise qu’un changement affecte les données à venir et peut provoquer temporairement un plateau ou un pic dans les rapports. Accès et paramètres de la propriété.
Préparez aussi le nom de package Android et le bundle ID Apple réellement utilisés par l’application. Ces identifiants sont sensibles à la casse et ne peuvent plus être modifiés pour l’application Firebase après son enregistrement. Le package Android se trouve dans le fichier Gradle du module ; le bundle ID se consulte dans Xcode, dans les paramètres généraux de l’application. Identifiant Android et identifiant Apple.
Notre conseil est de dresser une correspondance explicite entre chaque version à compiler, son identifiant et sa configuration Firebase. Si vous disposez d’une application de recette distincte, indiquez-la dans ce document. Définissez également qui peut modifier les paramètres et qui valide les données. Enfin, faites examiner les choix de collecte et l’information destinée aux utilisateurs par les personnes compétentes dans votre organisation, avant d’activer la mesure auprès du public.
4. Installer Firebase Analytics dans une application Android
Dans la console Firebase, ouvrez le projet retenu et lancez l’ajout d’une application Android. Saisissez le nom de package exact, puis enregistrez l’application. Téléchargez ensuite le fichier google-services.json et placez-le à la racine du module de l’application. Le guide précise de conserver son nom sans suffixe ajouté, comme une numérotation de téléchargement. Procédure d’installation Android.
Ajoutez le plugin Gradle Google services dans la configuration du projet, puis appliquez-le au module de l’application. Ce plugin rend les valeurs du fichier de configuration accessibles aux SDK Firebase. Ajoutez ensuite la dépendance com.google.firebase:firebase-analytics. Google recommande la Firebase Android BoM pour gérer les versions compatibles des bibliothèques Firebase ; lorsqu’elle est utilisée, les dépendances Firebase individuelles sont déclarées sans numéro de version. Plugin, BoM et dépendance Analytics.
Synchronisez le projet avec Gradle, puis compilez et exécutez l’application. Nous conseillons de conserver une trace de la configuration choisie et de la compilation validée. Pour un projet ancien, examinez aussi les prérequis du guide avant de modifier les dépendances. La documentation Android déconseille désormais les anciens modules KTX et demande aux développeurs Kotlin d’utiliser les modules principaux. Prérequis et statut des modules KTX.
Évitez de reprendre toutes les dépendances d’un exemple général : identifiez celles correspondant à votre périmètre. L’objectif de cette étape est de disposer d’une application qui compile avec Analytics et la configuration attendue, avant d’ajouter les événements métier.
5. Installer Firebase Analytics dans une application iOS
Dans Firebase, ajoutez une application Apple avec le bundle ID relevé dans Xcode. Téléchargez GoogleService-Info.plist, puis ajoutez-le à la racine du projet Xcode en suivant les indications concernant les cibles. Si votre projet comprend plusieurs bundle IDs, Google demande d’enregistrer chaque application correspondante dans Firebase afin qu’elle dispose de son propre fichier de configuration. Enregistrement et fichier de configuration Apple.
Le guide utilise Swift Package Manager pour installer les SDK. Dans Xcode, passez par « File > Add Packages », ajoutez le dépôt Firebase indiqué par la documentation, puis sélectionnez la bibliothèque FirebaseAnalytics. Laissez Xcode résoudre et télécharger les dépendances. Pour un nouveau projet, suivez ce parcours plutôt que de recopier une ancienne procédure d’installation : Google recommande Swift Package Manager et indique que Firebase 12 est la dernière version majeure publiée sur CocoaPods. Gestion des dépendances Apple.
Initialisez ensuite Firebase en important FirebaseCore et en appelant FirebaseApp.configure() dans la méthode de lancement de l’application indiquée par le guide. Le cas SwiftUI possède des instructions particulières : création et rattachement d’un délégué d’application, ainsi que désactivation du swizzling du délégué. Traitez donc cette étape selon l’architecture effective de votre projet. Initialisation Firebase et cas SwiftUI.
Exécutez enfin l’application. Google indique que cette exécution, lorsque le SDK Analytics est inclus, permet d’envoyer à la console Firebase une vérification de l’installation. Nous conseillons de compléter ce premier signal par une recette des événements réellement utiles au produit.
6. Construire des événements comparables et compréhensibles
Après l’installation, examinez les événements recommandés avant de définir les vôtres. Google conseille d’utiliser ceux qui correspondent à l’application, avec les paramètres prévus, pour obtenir davantage de détails dans les rapports. Les besoins spécifiques peuvent être couverts par des événements personnalisés. Le nom des événements est sensible à la casse : deux noms qui diffèrent uniquement par une majuscule correspondent à deux événements distincts. Choix et nommage des événements.
Voici un exemple fictif de plan de mesure pour une application de réservation. Les noms servent uniquement à illustrer une convention éditoriale ; ils ne constituent pas une liste d’événements recommandés par Google. Avant leur implémentation, l’équipe devra les comparer aux événements recommandés adaptés à son activité.
| Question produit | Événement envisagé | Déclencheur à spécifier | Contrôle de recette |
|---|---|---|---|
| La recherche aboutit-elle ? | recherche_terminee | Réception et affichage du résultat | Essayer une recherche avec et sans résultat |
| Une offre est-elle examinée ? | offre_consultee | Ouverture effective de sa fiche | Revenir sur la fiche et vérifier la règle de comptage |
| La demande est-elle engagée ? | demande_commencee | Début du parcours de demande | Distinguer ouverture et première interaction |
| La réservation est-elle confirmée ? | reservation_confirmee | Confirmation effective définie avec l’équipe | Tester succès, échec et nouvelle tentative |
Pour chaque ligne, décidez ce qu’apporte chaque paramètre. Une catégorie d’offre peut répondre à une question de comparaison ; un texte libre intégral peut être inutile à cette analyse. Notre conseil est de privilégier un vocabulaire contrôlé et de documenter les valeurs attendues. Faites aussi approuver les données transmises avant leur intégration, au lieu de laisser chaque écran définir ses propres paramètres.
7. Rendre les paramètres utilisables dans les rapports
Envoyer un paramètre personnalisé et pouvoir l’exploiter dans un rapport sont deux étapes différentes. La documentation explique qu’un paramètre peut servir de dimension ou de métrique personnalisée. Après son enregistrement par le SDK, il faut déclarer la définition correspondante dans « Analytics > Custom Definitions » pour qu’il apparaisse dans les rapports concernés. Définitions personnalisées.
Pour préparer cette configuration, associez chaque paramètre à un usage précis. Dans notre exemple fictif, une catégorie de réservation correspondrait à une lecture par groupes, tandis qu’une valeur numérique pourrait servir à une mesure, selon sa signification. Nous recommandons d’écrire cette intention dans le plan de mesure et de faire relire le vocabulaire par la personne chargée de l’analyse.
Le guide Apple décrit également des paramètres par défaut, associés aux événements enregistrés ensuite. Lorsqu’un même paramètre est explicitement fourni dans logEvent(), cette valeur remplace la valeur par défaut. Cette règle mérite un test si votre implémentation utilise ce mécanisme. Paramètres d’événement par défaut.
Gardez une liste des définitions créées, de leur signification et de leur responsable. Une donnée visible sans explication reste difficile à interpréter : précisez notamment si elle décrit l’action présente, un choix effectué auparavant ou un état de l’application.
8. Vérifier la collecte avec DebugView
DebugView permet de voir les données brutes des événements des appareils de développement presque en temps réel. Google explique qu’en fonctionnement habituel, les événements sont généralement regroupés sur une période d’environ une heure avant envoi. Le mode débogage réduit ce délai pour la validation. Un tableau de bord encore vide ne suffit donc pas à conclure que l’intégration a échoué. Fonctionnement de DebugView et des envois.
Sur Android, activez ce mode avec adb shell setprop debug.firebase.analytics.app PACKAGE_NAME, en remplaçant PACKAGE_NAME par le package concerné. Pour le désactiver, la commande documentée est adb shell setprop debug.firebase.analytics.app .none.. Sur Apple, ajoutez -FIRDebugEnabled aux arguments de lancement du schéma Xcode ; -FIRDebugDisabled permet de désactiver ce comportement. Activation du débogage Android et Apple.
Ouvrez « Analytics > DebugView » dans Firebase, sélectionnez l’appareil, puis reproduisez un scénario court. Consultez les paramètres de chaque événement et comparez-les au document de mesure. Nous conseillons de vérifier le déclenchement, les valeurs et les absences attendues : une annulation ne devrait pas être interprétée comme une confirmation dans votre convention.
En cas d’anomalie, ouvrez le détail des événements pour rechercher un paramètre firebase_error et examinez les journaux du SDK sur l’appareil. Google précise que certains événements contenant ce paramètre n’affichent pas d’indicateur particulier dans le flux principal de DebugView. Diagnostic des erreurs de collecte.
9. Préparer une recette qui couvre les vrais parcours
Une recette utile associe un scénario à une attente vérifiable. Pour notre application fictive, faites une réservation réussie, une tentative interrompue et un retour sur une offre déjà consultée. Déterminez à l’avance les événements attendus dans chaque cas. Vous pourrez ainsi distinguer un défaut de collecte d’une règle de comptage mal définie.
Rejouez les parcours sur les versions Android et iOS concernées. Nous conseillons de comparer la signification des événements entre plateformes, pas seulement leur orthographe. Si « demande commencée » correspond à l’ouverture d’un écran sur une plateforme et à une saisie sur l’autre, la comparaison ne répondra pas à la même question. Faites corriger cette différence dans le plan de mesure ou dans le code avant validation.
Prévoyez aussi le traitement du trafic de développement. La documentation DebugView indique que les événements de débogage sont inclus par défaut dans l’export quotidien BigQuery. Elle recommande un filtre de trafic développeur dans la propriété Analytics pour empêcher le traitement et l’apparition de ce trafic dans les rapports ou les exports. Trafic de développement et filtres.
Comme livrables de recette, demandez le plan de mesure validé, les scénarios exécutés, les écarts corrigés et les paramètres de configuration retenus. Ce dossier rend l’installation transmissible à une autre équipe sans dépendre de souvenirs ou d’explications orales.
10. Organiser le suivi après l’installation
Après la mise à disposition de l’application, commencez par vérifier que les données restent cohérentes avec les parcours connus. Nous conseillons d’annoter les changements de version, les modifications d’événements et les évolutions fonctionnelles. Avant d’interpréter une variation comme un changement de comportement, recherchez si la définition ou le déclencheur de la mesure a changé.
Ajoutez ensuite les usages avancés selon les questions rencontrées. Google présente les audiences personnalisées comme des groupes définis notamment à partir des événements ou des propriétés utilisateur. La documentation décrit aussi une liaison avec BigQuery pour effectuer des analyses personnalisées et rapprocher les données Analytics d’autres sources. Ces possibilités doivent répondre à un besoin identifié et faire l’objet de leur propre cadrage. Audiences et intégration BigQuery.
Si vous confiez le travail à un prestataire, demandez une proposition couvrant la préparation, l’intégration par plateforme, la configuration des rapports et la recette. Comparez les livrables et les responsabilités annoncés, puis prévoyez la maintenance du plan de mesure. Le comparatif des agences d’application mobile peut aider à rechercher un accompagnement ; un brief peut également être préparé via le dépôt de projet.
Retenez comme critère de réception une installation expliquée et vérifiable : la bonne application envoie les événements convenus vers la destination retenue, avec des paramètres compréhensibles. Cette base permet à l’équipe de discuter des décisions produit à partir de mesures dont elle connaît le sens et les limites.
Questions fréquentes
Faut-il commencer par Google Analytics ou par Firebase ?
Quel fichier ajouter pour Android et pour iOS ?
Tous les événements doivent-ils être programmés ?
Comment vérifier rapidement que les événements arrivent ?
Pourquoi un paramètre envoyé n’apparaît-il pas dans les rapports ?
Sources
- Google Analytics for Firebase — consulté le 23/10/2026
- Add Firebase to your Android project | Firebase for Android — consulté le 23/10/2026
- Add Firebase to your Apple project | Firebase for Apple platforms — consulté le 23/10/2026
- Get started with Google Analytics | Google Analytics for Firebase — consulté le 23/10/2026
- Log events | Google Analytics for Firebase — consulté le 23/10/2026
- Monitor collected events and user properties using DebugView | Google Analytics for Firebase — consulté le 23/10/2026
- Configurer Analytics pour un site Web et/ou une application - Aide Google Analytics — consulté le 23/10/2026