Ce démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer les événements.
Google Analytics collecte des données d'utilisation et de comportement pour votre application. Le SDK enregistre deux principaux types d'informations :
- Événements : ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements système ou les erreurs.
- Propriétés utilisateur : attributs que vous définissez pour décrire les segments de votre base d'utilisateurs, tels que les préférences linguistiques ou l'emplacement géographique.
Analytics enregistre automatiquement certains événements et propriétés utilisateur ; vous n'avez pas besoin d'ajouter de code pour les activer.
Avant que tu commences
Si ce n'est pas déjà fait, ajoutez Firebase à votre projet JavaScript et assurez-vous que Google Analytics est activé dans votre projet Firebase :
Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le workflow de création du projet.
Si vous utilisez un projet Firebase existant sur lequel Google Analytics n'est pas activé, accédez à l'onglet Intégrations de votre
Ajoutez le SDK Analytics à votre application
Vérifiez que votre objet de configuration Firebase dans votre code contient measurementId
. Cet identifiant est automatiquement créé lorsque vous activez Analytics dans votre projet Firebase et enregistrez une application Web, et il est requis pour utiliser Analytics.Si votre application utilise Firebase Hosting et utilise des URL réservées pour les SDK Firebase : Firebase gère automatiquement la configuration de votre application. Pour terminer la configuration, ajoutez les scripts de la carte Vos applications dans les paramètres de votre projet à la balise <body> de votre application, si ce n'est pas déjà fait. Si votre application n'utilise pas d'URL réservées : si vous travaillez avec une application Web existante , mettez à jour l'objet de configuration Firebase dans votre code pour vous assurer que le champ measurementId
est présent. L'objet de configuration doit ressembler à l'exemple suivant :// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Si vous ne l'avez pas déjà fait, installez le SDK Firebase JS et initialisez Firebase . Ajoutez le SDK Analytics JS et initialisez Analytics :
API modulaire Web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
API avec espace de noms Web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Utiliser Firebase avec le balisage gtag.js existant
Ajoutez les appels Google Analytics de Firebase à la page, mais prévoyez également de continuer à utiliser les appels gtag()
directement sur la même page.Vous souhaitez utiliser le même ID de mesure entre les appels directs gtag()
et les données Google Analytics envoyées à Firebase.
Supprimez la ligne gtag('config', ' GA_MEASUREMENT_ID ');
oùGA_MEASUREMENT_ID
est l'measurementId
de votre application Web Firebase. Si vous disposez d'autres identifiants pour d'autres propriétés Analytics sur la page, vous n'avez pas besoin de supprimer leur ligne de configuration.Assurez-vous d'appeler firebase.analytics()
avant d'envoyer des événements avecgtag()
.
gtag()
ne seront pas associés à Firebase et ne pourront pas être ciblés dans d'autres services Firebase.
Commencer à enregistrer les événements
logEvent()
.
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
Prochaines étapes
Comprendre chaque rapport Analytics . Utilisez DebugView pour vérifier vos événements. Explorez vos données dans la console Firebase . Explorez les guides sur les événements et les propriétés des utilisateurs. Découvrez comment exporter vos données vers BigQuery.