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 App. Das SDK protokolliert zwei Haupttypen von Informationen:

  • Veranstaltungen: Was in Ihrer Anwendung geschieht, wie Benutzeraktionen, Systemereignisse oder Fehler.
  • Benutzereigenschaften: Attribute definieren Sie Segmente Ihrer Nutzerbasis zu beschreiben, wie bevorzugte Sprache oder geographische Lage.

Analytics automatisch protokolliert einige Ereignisse und Benutzereigenschaften ; Sie müssen keinen Code hinzufügen, um sie zu aktivieren.

Bevor Sie beginnen

Wenn Sie nicht bereits haben, fügen Sie Firebase zu Ihrem JavaScript - Projekt und stellen Sie sicher , dass Google Analytics in Ihrem Projekt Firebase aktiviert ist:

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

  • Wenn Sie ein vorhandenes Projekt Firebase verwenden , die nicht von Google Analytics nicht aktiviert ist , gehen Sie auf die Integrations Registerkarte Ihrer > Projekteinstellungen zu aktivieren.

Wenn Sie aktivieren Google Analytics in Ihrem Projekt, Ihre Firebase Web - Anwendungen sind zu Google Analytics - Daten verknüpft Ströme im Zusammenhang mit einer Immobilie App + Web .

Fügen Sie das Analytics SDK zu Ihrer App hinzu

Je nachdem , wie Ihre Web - Anwendung gehostet wird, kann die Konfiguration automatisch gehandhabt werden , oder Sie können Ihre aktualisieren müssen Firebase Konfigurationsobjekt . Wenn Ihr Web - App von Google Analytics bereits verwendet, müssen Sie in beschrieben zusätzliche Einrichtung tun Verwenden Firebase mit bestehenden gtag.js Tagging .

  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 verwendet Firebase Hosting und Verwendungen reserviert URLs für die Firebase SDKs:

      Firebase übernimmt automatisch die Konfiguration Ihrer Anwendung. Um eine vollständige Einrichtung, fügen Sie die Skripte aus der Ihre Apps - Karte in Ihrem Projekteinstellungen an den Tag <body> Ihrer Anwendung, wenn Sie nicht bereits haben.

    • Wenn Ihre App nicht reserviert URLs verwenden: Wenn Sie mit einem bestehenden Web - App arbeiten, aktualisieren Sie das Config - Objekt Firebase in Ihrem Code das , um sicherzustellen , measurementId Feld 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 hatte laufen Google Analytics in Ihrer App die gtag.js Schnipsel , die App zusätzliche Einrichtung erforderlich, wenn Sie planen , einen der folgenden Schritte zu tun:

  • In Google Analytics Anrufen von Firebase auf der Seite , sondern auch plant , weiter zu verwenden gtag() Anrufe direkt auf der gleichen Seite.
  • Möchten Sie die gleiche Messung ID zwischen den beiden direkt verwenden gtag() Anrufe und Google Analytics - Daten zu Firebase gesendet.

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

  • Entfernen Sie die Zeile gtag('config', ' GA_MEASUREMENT_ID '); wo die GA_MEASUREMENT_ID ist die measurementId Ihrer Firebase Web - App. 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 gesendet Ereignisse dieser ID mit gtag() Anrufe werden nicht mit Firebase in Verbindung gebracht werden und wird nicht für das Targeting in andere Dienste Firebase zur Verfügung.

Beginnen Sie mit der Protokollierung von Ereignissen

Nachdem Sie den initialisierten Analytics - Service mit ‚firebase.analytics ()‘ , können Sie beginnen Ereignisse mit dem einzuloggen ‚LogEvent ()‘ Methode.

Bestimmte Ereignisse werden für alle Anwendungen 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. Dieser Abschnitt zeigt die Anmeldung ein vordefiniertes Ereignis, um weitere Informationen über die Protokollierung von Ereignissen finden Sie 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