Erste Schritte mit Google Analytics


In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics zu Ihrer App hinzufügen und damit beginnen, Ereignisse zu erfassen.

Google Analytics erfasst Nutzungs- und Verhaltensdaten für Ihre Webanwendung. Das SDK protokolliert zwei Hauptarten von Informationen:

  • Ereignisse: Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.

  • Nutzereigenschaften: Attribute, mit denen Sie Nutzersegmente wie Spracheinstellungen oder geografische Standorte beschreiben.

Einige Ereignisse und Nutzereigenschaften werden in Analytics automatisch protokolliert. Sie müssen also keinen Code hinzufügen, um sie zu aktivieren.

Hinweis

Fügen Sie Ihrem JavaScript-Projekt Firebase hinzu und prüfen Sie, ob Google Analytics in Ihrem Firebase-Projekt aktiviert ist:

  • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Projekterstellungsvorgangs.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, rufen Sie den Tab Integrationen unter  > Projekteinstellungen auf, um Google Analytics zu aktivieren.

Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Web-Apps mit Google Analytics-Datenstreams verknüpft, die mit einer App- + Web-Property verknüpft sind.

Analytics SDK in Ihre App einbinden

Je nachdem, wie Ihre Webanwendung gehostet wird, wird Ihre Konfiguration möglicherweise automatisch verarbeitet oder Sie müssen Ihr Firebase-Konfigurationsobjekt aktualisieren. Wenn in Ihrer Webanwendung bereits Google Analytics verwendet wird, müssen Sie möglicherweise zusätzliche Schritte ausführen, die unter Firebase mit vorhandenem gtag.js-Tagging verwenden beschrieben sind.

  1. Prü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 Webanwendung 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 konfiguriert Ihre Anwendung automatisch. Fügen Sie zum Abschließen der Einrichtung die Scripts aus der Karte Meine Apps in den Projekteinstellungen dem <body>-Tag Ihrer App hinzu, falls Sie dies noch nicht getan haben.

    • Wenn Ihre App keine reservierten URLs verwendet: Wenn Sie mit einer vorhandenen Webanwendung arbeiten, aktualisieren Sie das Firebase-Konfigurationsobjekt in Ihrem Code, damit das Feld measurementId vorhanden ist. Das config-Objekt sollte in etwa so 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"
      };
      
  2. Installieren und initialisieren Sie das Firebase JS SDK, falls noch nicht geschehen.

  3. Füge das Analytics JS SDK hinzu und initialisiere 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 in Ihrer App bereits mit dem gtag.js-Snippet verwendet haben, ist möglicherweise eine zusätzliche Einrichtung Ihrer App erforderlich, wenn Sie eine der folgenden Aktionen ausführen möchten:

  • Sie fügen der Seite Google Analytics-Aufrufe von Firebase hinzu, möchten aber auch weiterhin Google Analytics-Aufrufe direkt auf derselben Seite verwenden.gtag()
  • Sie möchten dieselbe Mess-ID für direkte gtag()-Aufrufe und Google Analytics-Daten verwenden, die an Firebase gesendet werden.

Damit Ihre Ereignisse von allen Firebase-Diensten verwendet werden können, müssen Sie die folgenden zusätzlichen Einrichtungsschritte ausführen:

  • 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 können nicht für das Targeting in anderen Firebase-Diensten verwendet werden.

Ereignisse protokollieren

Nachdem du den Analytics-Dienst initialisiert hast, kannst du mit der Methode logEvent() Ereignisse erfassen.

Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. Sie sollten vorgeschlagene Ereignisse zusammen mit den zugehörigen Parametern senden, um detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. In diesem Abschnitt wird das Protokollieren eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.

Das folgende Beispiel zeigt, wie Sie ein empfohlenes Ereignis erfassen, 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