Erste Schritte mit Google Analytics

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 Web-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 > Projekteinstellungen , um es zu aktivieren.

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.

  1. Ü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"
      };
      
  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:

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 ist GA_MEASUREMENT_ID die measurementId 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 mit gtag() 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