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 Ihrer App Google Analytics 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: Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, System ereignisse oder Fehler.

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

Einige Ereignisse und Nutzereigenschaften werden in Analytics automatisch protokolliert. Sie müssen dafür also keinen Code hinzufügen.

Hinweis

Fügen Sie Ihrem JavaScript-Projekt Firebase hinzu, falls noch nicht geschehen, 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 Projekterstellungsprozesses.

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

Fügen Sie das Analytics SDK Ihrer App hinzu

Je nachdem, wie Ihre Webanwendung gehostet wird, wird Ihre Konfiguration möglicherweise automatisch verarbeitet oder Sie müssen Ihr Firebase-Konfigurationsobjektaktualisieren. Wenn Ihre Web-App bereits Google Analytics verwendet, 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 Web-App 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 Skripts von der Karte „Ihre Apps“ in den Projekteinstellungen zum <body>-Tag Ihrer App hinzu, falls noch nicht geschehen.

    • 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 in etwa so 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. Installieren Sie das Firebase JS SDK und initialisieren Sie Firebase, falls noch nicht geschehen. 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 in Ihrer App mit dem gtag.js-Snippetverwendet haben, ist möglicherweise eine zusätzliche Einrichtung erforderlich, wenn Sie Folgendes planen:

  • Google Analytics Aufrufe von Firebase zur Seite hinzufügen, aber auch weiterhin gtag() Aufrufe direkt auf derselben Seite verwenden.
  • 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, führen Sie die folgenden zusätzlichen Einrichtungsschritte aus:

  • Entfernen Sie die Zeile gtag('config', 'GA_MEASUREMENT_ID'); wobei die 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 die Konfigurationszeile nicht entfernen.
  • Achten Sie darauf, 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 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 Ereignisse mit der logEvent() Methode 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 zugehörigen Parametern senden, um detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. 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 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