Erste Schritte mit Google Analytics für das Web

Plattform auswählen: iOS+ Android Web Flutter Unity C++


In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics in Ihre App einbinden und mit dem Protokollieren 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. Nutzeraktionen, Systemereignisse oder Fehler.

  • Nutzereigenschaften: Attribute, die Sie definieren, um bestimmte Nutzersegmente wie Spracheinstellungen oder geografische Standorte zu beschreiben.

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

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 des Projekterstellungsworkflows.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, können Sie es in den Einstellungen > Tab Integrationen 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 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 in Ihrer Web-App 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 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 erforderlich, um Analytics zu verwenden.

    • Wenn Ihre App Firebase Hosting und reservierte URLs für die Firebase SDKs verwendet:

      Firebase übernimmt die Konfiguration Ihrer Anwendung automatisch. Fügen Sie zum Abschließen der Einrichtung die Scripts von der Karte Meine Apps in den Projekteinstellungen dem <body>-Tag Ihrer App hinzu, 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 wie das folgende Beispiel 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"
};
      1. Falls noch nicht geschehen, installieren Sie das Firebase JS SDK und initialisieren Sie Firebase. 2. 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 mit dem gtag.js-Snippet in Ihrer App verwendet haben, ist möglicherweise eine zusätzliche Einrichtung erforderlich, wenn Sie Folgendes tun möchten:

  • Sie fügen der Seite Google Analytics-Aufrufe von Firebase 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.

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

  • Entfernen Sie die Zeile gtag('config', 'GA_MEASUREMENT_ID');, wobei GA_MEASUREMENT_ID die measurementId Ihrer Firebase-Web-App ist. Wenn Sie andere IDs für andere Analytics-Properties auf der Seite 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 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 vorgeschlagene 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 das Protokollieren eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.

Im folgenden Beispiel wird gezeigt, 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