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
Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Web-Apps mit Google Analytics-Datenströmen verknüpft, die einer App + Web-Property zugeordnet sind.
Fügen Sie das Analytics SDK zu Ihrer App hinzu
Abhängig davon, wie Ihre Webanwendung gehostet wird, wird Ihre Konfiguration möglicherweise automatisch verarbeitet oder Sie müssen möglicherweise Ihr Firebase-Konfigurationsobjekt aktualisieren. Wenn Ihre Web-App bereits Google Analytics verwendet, müssen Sie möglicherweise zusätzliche Einrichtungsschritte durchführen, die unter Firebase mit vorhandenem gtag.js-Tagging verwenden beschrieben werden.
Ü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
Wenn in Ihrer App zuvor Google Analytics mit dem Snippet gtag.js ausgeführt wurde, ist für Ihre App möglicherweise eine zusätzliche Einrichtung erforderlich, wenn Sie einen der folgenden Schritte planen:
- 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.
Um sicherzustellen, dass Ihre Ereignisse für alle Firebase-Dienste verfügbar sind, führen Sie die folgenden zusätzlichen Einrichtungsschritte aus:
- 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.
Andernfalls werden Ereignisse, die mit 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
Nachdem Sie den Analytics-Dienst initialisiert haben, können Sie mit der Protokollierung von Ereignissen mit der Methode logEvent()
beginnen.
Bestimmte Ereignisse werden für alle Apps empfohlen ; andere werden für bestimmte Geschäftstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den vorgeschriebenen Parametern senden, um die größtmögliche Detailgenauigkeit in Ihren Berichten sicherzustellen und von zukünftigen Funktionen und Integrationen zu profitieren, sobald diese verfügbar sind. In diesem Abschnitt wird die Protokollierung eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zur Protokollierung von Ereignissen finden Sie unter Ereignisse protokollieren .
Das folgende Beispiel zeigt, wie Sie ein empfohlenes Ereignis protokollieren, um anzugeben, dass ein Benutzer eine Benachrichtigung in Ihrer App erhalten hat:
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.