Firebase 将于 5 月 10 日重返 Google I/O 大会！立即报名

Beginnen Sie mit Google Analytics

Dieser Schnellstart zeigt Ihnen, wie Sie Google Analytics zu Ihrer App 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, wie z. B. Sprachpräferenzen 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 Workflows zur Projekterstellung.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, gehen Sie zur Registerkarte Integrationen Ihrer > 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 Ihrer App das Analytics SDK 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 Verwenden von Firebase mit vorhandenem gtag.js-Tagging beschrieben sind.

  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, und 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 ähnlich 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:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
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 Sie zuvor Google Analytics in Ihrer App mit dem gtag.js-Snippet ausgeführt haben, erfordert Ihre App möglicherweise eine zusätzliche Einrichtung, wenn Sie einen der folgenden Schritte ausführen möchten:

  • Fügen Sie der Seite Google Analytics-Aufrufe von Firebase hinzu, planen Sie aber auch, weiterhin gtag() Aufrufe direkt auf derselben Seite zu verwenden.
  • Dieselbe Mess-ID zwischen direkten gtag() Aufrufen und an Firebase gesendeten Google Analytics-Daten verwenden möchten.

Führen Sie die folgenden zusätzlichen Einrichtungsschritte aus, um sicherzustellen, dass Ihre Ereignisse von allen Firebase-Diensten verwendet werden können:

  • 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-Properties auf der Seite haben, müssen Sie deren Konfigurationszeile nicht entfernen.
  • Stellen Sie sicher, dass Sie firebase.analytics( 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.

Starten Sie die Protokollierung von Ereignissen

Nachdem Sie den Analytics-Dienst initialisiert haben, können Sie mit der Protokollierung von Ereignissen mit der logEvent() Methode 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 ihren vorgeschriebenen Parametern senden, um sicherzustellen, dass möglichst viele Details in Ihren Berichten verfügbar sind, und um von zukünftigen Funktionen und Integrationen zu profitieren, sobald sie verfügbar sind. Dieser Abschnitt demonstriert das Protokollieren eines vordefinierten Ereignisses. 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 version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web version 8

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

Nächste Schritte

,

Dieser Schnellstart zeigt Ihnen, wie Sie Google Analytics zu Ihrer App 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, wie z. B. Sprachpräferenzen 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 Workflows zur Projekterstellung.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, gehen Sie zur Registerkarte Integrationen Ihrer > 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 Ihrer App das Analytics SDK 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 Verwenden von Firebase mit vorhandenem gtag.js-Tagging beschrieben sind.

  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, und 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 ähnlich 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:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
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 Sie zuvor Google Analytics in Ihrer App mit dem gtag.js-Snippet ausgeführt haben, erfordert Ihre App möglicherweise eine zusätzliche Einrichtung, wenn Sie einen der folgenden Schritte ausführen möchten:

  • Fügen Sie der Seite Google Analytics-Aufrufe von Firebase hinzu, planen Sie aber auch, weiterhin gtag() Aufrufe direkt auf derselben Seite zu verwenden.
  • Dieselbe Mess-ID zwischen direkten gtag() Aufrufen und an Firebase gesendeten Google Analytics-Daten verwenden möchten.

Führen Sie die folgenden zusätzlichen Einrichtungsschritte aus, um sicherzustellen, dass Ihre Ereignisse von allen Firebase-Diensten verwendet werden können:

  • 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-Properties auf der Seite haben, müssen Sie deren Konfigurationszeile nicht entfernen.
  • Stellen Sie sicher, dass Sie firebase.analytics( 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.

Starten Sie die Protokollierung von Ereignissen

Nachdem Sie den Analytics-Dienst initialisiert haben, können Sie mit der Protokollierung von Ereignissen mit der logEvent() Methode 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 ihren vorgeschriebenen Parametern senden, um sicherzustellen, dass möglichst viele Details in Ihren Berichten verfügbar sind, und um von zukünftigen Funktionen und Integrationen zu profitieren, sobald sie verfügbar sind. Dieser Abschnitt demonstriert das Protokollieren eines vordefinierten Ereignisses. 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 version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web version 8

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

Nächste Schritte