In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics in Ihre App einfügen und mit der Erfassung von Ereignissen beginnen.
Google Analytics erfasst Nutzungs- und Verhaltensdaten für Ihre Web-App. Das SDK protokolliert zwei primäre Arten von Informationen:
Ereignisse: Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
Nutzereigenschaften: Attribute, die Sie definieren, um Nutzersegmente wie Spracheinstellungen oder geografische Standorte zu beschreiben.
Einige Ereignisse und Nutzereigenschaften werden in Analytics automatisch protokolliert. Sie müssen dafür also keinen Code hinzufügen.
Hinweis
Falls noch nicht geschehen, fügen Sie Ihrem JavaScript-Projekt Firebase hinzu und achten Sie darauf, dass Google Analytics in Ihrem Firebase-Projekt aktiviert ist:
Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während der Projekterstellung.
Wenn Sie ein vorhandenes Firebase-Projekt verwenden, in dem Google Analytics nicht aktiviert ist, können Sie es auf dem Tab Integrationen unter
aktivieren. > Projekteinstellungen
Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Web-Apps mit Google Analytics-Datenstreams verknüpft, die einer App- + Web-Property zugeordnet sind.
Analytics SDK zu Ihrer App hinzufügen
Je nachdem, wie Ihre Webanwendung gehostet wird, wird die Konfiguration möglicherweise automatisch vorgenommen oder Sie müssen Ihr Firebase-Konfigurationsobjekt aktualisieren. Wenn Ihre Web-App bereits Google Analytics verwendet, müssen Sie möglicherweise zusätzliche Einrichtungsschritte ausführen, die unter Firebase mit vorhandenem gtag.js-Tagging verwenden beschrieben sind.
Prüfen Sie, ob das 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 und reservierte URLs für die Firebase SDKs verwendet:
Firebase übernimmt automatisch die Konfiguration Ihrer Anwendung. Fügen Sie zum Abschließen der Einrichtung die Scripts von der Karte Meine Apps in den Projekteinstellungen in das <body>-Tag Ihrer App ein, falls Sie das 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, damit das Feld
measurementId
vorhanden ist. Das Konfigurationsobjekt sollte in etwa so aussehen:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "API_KEY", authDomain: "PROJECT_ID.firebaseapp.com", databaseURL: "https://PROJECT_ID.firebaseio.com", projectId: "PROJECT_ID", storageBucket: "
", messagingSenderId: "SENDER_ID", appId: "APP_ID", measurementId: "G-GA_MEASUREMENT_ID" };PROJECT_ID.firebasestorage.app
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:
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);
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();
Firebase mit vorhandenem gtag.js-Tagging verwenden
Wenn Sie Google Analytics zuvor in Ihrer App mit dem gtag.js-Snippet verwendet haben, ist möglicherweise eine zusätzliche Einrichtung erforderlich, wenn Sie Folgendes planen:
- Sie fügen Google Analytics-Aufrufe von Firebase auf der Seite hinzu, möchten aber auch weiterhin
gtag()
-Aufrufe direkt auf derselben Seite verwenden. - Sie möchten dieselbe Mess-ID für direkte
gtag()
-Aufrufe und Google Analytics-Daten verwenden, die an Firebase gesendet werden.
Damit 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');
, wobeiGA_MEASUREMENT_ID
diemeasurementId
Ihrer Firebase-Web-App ist. Wenn Sie auf der Seite andere IDs für andere Analytics-Properties haben, müssen Sie deren Konfigurationszeile nicht entfernen. - Rufen Sie
firebase.analytics()
auf, bevor Sie Ereignisse mitgtag()
senden.
Andernfalls werden Ereignisse, die mit gtag()
-Aufrufen an diese ID gesendet werden, nicht mit Firebase verknüpft und sind nicht für das Targeting in anderen Firebase-Diensten verfügbar.
Ereignisse protokollieren
Nachdem Sie den Analytics-Dienst initialisiert haben, können Sie mit der Methode logEvent()
Ereignisse protokollieren.
Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. Sie sollten empfohlene Ereignisse gemeinsam mit den zugehörigen Parametern senden, um detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. In diesem Abschnitt wird gezeigt, wie ein vordefiniertes Ereignis protokolliert wird. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.
Das folgende Beispiel zeigt, wie Sie ein empfohlenes Ereignis protokollieren, um anzugeben, dass ein Nutzer eine Benachrichtigung in Ihrer App erhalten hat:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Nächste Schritte
- Jeden Analytics-Bericht verstehen.
- Mit DebugView können Sie Ihre Ereignisse überprüfen.
- Daten in der Firebase-Konsole ansehen
- Anleitungen zu Ereignissen und Nutzereigenschaften
- Informationen zum Exportieren von Daten nach BigQuery