Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Erste Schritte mit Google Analytics

In dieser Schnellstartanleitung erfahren Sie, wie Sie Ihrer App Google Analytics hinzufügen und mit der Protokollierung von Ereignissen beginnen.

Google Analytics sammelt 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 vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, gehen Sie in Ihren zum Tab Integrationen > 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 mit einerApp + Web-Property verknüpft sind.

Fügen Sie das Analytics SDK zu Ihrer App hinzu

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

  1. Überprüfen Sie, ob Ihr Firebase Config Objekt in Ihrem Code enthält measurementId . 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 config-Objekt sollte dem folgenden Beispiel ähneln:

      // 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. Firebase Analytics initialisieren:

Web v8

const analytics = firebase.analytics();

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Firebase mit vorhandenem gtag.js-Tagging verwenden

Wenn Sie zuvor Google Analytics mithilfe des gtag.js-Snippets in Ihrer App ausgeführt haben, erfordert Ihre App möglicherweise eine zusätzliche Einrichtung, wenn Sie eine der folgenden Aktionen planen:

  • Fügen Sie Google Analytics-Aufrufe von Firebase zur Seite hinzu, planen Sie jedoch auch, gtag() Aufrufe direkt auf derselben Seite zu verwenden.
  • Sie gtag() dieselbe Mess-ID sowohl für direkte gtag() Aufrufe als auch für an Firebase gesendete Google Analytics-Daten verwenden.

Führen Sie die folgenden zusätzlichen Einrichtungsschritte aus, um sicherzustellen, dass Ihre Ereignisse für alle Firebase-Dienste verfügbar sind:

  • Entfernen Sie [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) aus der URL. Ihr gtag-Snippet sollte ähnlich sein wie

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Entfernen Sie die Zeile gtag('config', ' GA_MEASUREMENT_ID '); wobei die GA_MEASUREMENT_ID mit der measurementId in Ihrem Firebase-Konfigurations-Snippet GA_MEASUREMENT_ID . Wenn Sie andere IDs für andere Analytics-Properties auf der Seite haben, müssen Sie deren Konfigurationszeile nicht entfernen.

  • Stellen Sie sicher , dass Sie rufen firebase.analytics() , bevor Sie Ereignisse mit senden gtag() .

Andernfalls werden Ereignisse, die mit gtag() Aufrufen an diese ID gtag() 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 mit 'firebase.analytics()' initialisiert haben, können Sie beginnen, Ereignisse mit der Methode 'logEvent()' zu protokollieren.

Bestimmte Ereignisse werden für alle Apps empfohlen ; andere werden für bestimmte Unternehmenstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den vorgeschriebenen Parametern senden, um maximale verfügbare Details in Ihren Berichten zu gewährleisten und von zukünftigen Funktionen und Integrationen zu profitieren, sobald sie verfügbar sind. In diesem Abschnitt wird das Protokollieren eines vordefinierten Ereignisses veranschaulicht . Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Protokollereignisse .

Das folgende Beispiel zeigt, wie Sie ein empfohlenes Ereignis protokollieren, um anzuzeigen, dass ein Benutzer eine Benachrichtigung in Ihrer App erhalten hat:

Web v8

firebase.analytics().logEvent('notification_received');

Web v9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Nächste Schritte