Erste Schritte mit Google Analytics


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  > Projekteinstellungen aktivieren.

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.

  1. 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: "PROJECT_ID.firebasestorage.app",
        messagingSenderId: "SENDER_ID",
        appId: "APP_ID",
        measurementId: "G-GA_MEASUREMENT_ID"
      };
      
  2. Falls noch nicht geschehen, installieren Sie das Firebase JS SDK und initialisieren Sie Firebase.

  3. 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');, wobei GA_MEASUREMENT_ID die measurementId 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 mit gtag() 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