In dieser Schnellstartanleitung erfahren Sie, wie Sie Google Analytics zu Ihrer App hinzufügen und mit der Protokollierung von Ereignissen beginnen.
Google Analytics erfasst Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei Haupttypen von Informationen:
- Ereignisse: Was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.
- Benutzereigenschaften: Attribute, die Sie definieren, um Segmente Ihrer Benutzerbasis zu beschreiben, z. B. Sprachpräferenz oder geografischer Standort.
Analytics protokolliert automatisch einige Ereignisse und Benutzereigenschaften ; Sie müssen keinen Code hinzufügen, um sie zu aktivieren.
Bevor Sie beginnen
Falls noch nicht geschehen, fügen Sie Firebase zu Ihrem JavaScript-Projekt hinzu und stellen Sie sicher, dass Google Analytics in Ihrem Firebase-Projekt aktiviert ist:
Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Projekterstellungsworkflows.
Wenn Sie ein bestehendes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, wechseln Sie zur Registerkarte „Integrationen“ Ihres Projekts
Fügen Sie das Analytics SDK zu Ihrer App hinzu
Überprüfen Sie, ob Ihr Firebase-Konfigurationsobjekt in Ihrem Code measurementId
enthält. Diese ID wird automatisch erstellt, wenn Sie Analytics in Ihrem Firebase-Projekt aktivieren und eine Web-App registrieren. Sie ist für die Verwendung von Analytics erforderlich.Wenn Ihre App Firebase Hosting verwendet und reservierte URLs für die Firebase SDKs verwendet : Firebase übernimmt automatisch die Konfiguration Ihrer Anwendung. Um die Einrichtung abzuschließen, fügen Sie die Skripts von der Karte „Ihre Apps“ in Ihren Projekteinstellungen zum <body>-Tag Ihrer App hinzu, falls Sie dies noch nicht getan haben. Wenn Ihre App keine reservierten URLs verwendet : Wenn Sie mit einer vorhandenen Web-App arbeiten , aktualisieren Sie das Firebase-Konfigurationsobjekt in Ihrem Code, um sicherzustellen, dass das Feld measurementId
vorhanden ist. Das Konfigurationsobjekt sollte etwa wie im folgenden Beispiel aussehen:// 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" };
Falls noch nicht geschehen, installieren Sie das Firebase JS SDK und initialisieren Sie Firebase . Fügen Sie das Analytics JS SDK hinzu und initialisieren Sie Analytics:
Modulare Web-API
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);
Web-Namespace-API
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();
Verwenden Sie Firebase mit vorhandenem gtag.js-Tagging
Fügen Sie der Seite Google Analytics-Aufrufe von Firebase hinzu, planen Sie aber auch, weiterhin gtag()
Aufrufe direkt auf derselben Seite zu verwenden.Sie möchten dieselbe Mess-ID zwischen direkten gtag()
Aufrufen und an Firebase gesendeten Google Analytics-Daten verwenden.
Entfernen Sie die Zeile gtag('config', ' GA_MEASUREMENT_ID ');
Dabei istGA_MEASUREMENT_ID
diemeasurementId
Ihrer Firebase-Web-App. Wenn Sie andere IDs für andere Analytics-Eigenschaften auf der Seite haben, müssen Sie deren Konfigurationszeile nicht entfernen.Stellen Sie sicher, dass Sie firebase.analytics()
aufrufen, bevor Sie Ereignisse mitgtag()
senden.
gtag()
-Aufrufen an diese ID gesendet werden, nicht mit Firebase verknüpft und stehen nicht für das Targeting in anderen Firebase-Diensten zur Verfügung.
Beginnen Sie mit der Protokollierung von Ereignissen
logEvent()
beginnen.
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
Nächste Schritte
Verstehen Sie jeden Analytics-Bericht . Verwenden Sie DebugView, um Ihre Ereignisse zu überprüfen. Erkunden Sie Ihre Daten in der Firebase-Konsole . Entdecken Sie die Leitfäden zu Ereignissen und Benutzereigenschaften. Erfahren Sie, wie Sie Ihre Daten nach BigQuery exportieren.