Bildschirmaufrufe messen

Google Analytics erfasst Bildschirmübergänge und fügt Ereignissen Informationen zum aktuellen Bildschirm hinzu. So können Sie Messwerte wie Nutzerinteraktionen oder Nutzerverhalten pro Bildschirm erfassen. Ein Großteil dieser Datenerhebung erfolgt automatisch. Sie können Bildschirmaufrufe aber auch manuell erfassen. Das manuelle Erfassen von Bildschirmen ist nützlich, wenn in Ihrer App für jeden Bildschirm, den Sie erfassen möchten, keine separate UIViewController, View oder Activity verwendet wird, z. B. in einem Spiel.

Bildschirme automatisch erfassen

Analytics erfasst automatisch einige Informationen zu Bildschirmen in Ihrer App, z. B. den Klassennamen der UIViewController oder Activity, die gerade im Fokus ist. Wenn ein Bildschirmübergang erfolgt, wird in Analytics ein screen_view-Ereignis protokolliert, das den neuen Bildschirm identifiziert. Ereignisse, die auf diesen Bildschirmen auftreten, werden automatisch mit dem Parameter firebase_screen_class (z. B. menuViewController oder MenuActivity) und einer generierten firebase_screen_id getaggt. Wenn in Ihrer App für jeden Bildschirm eine eigene UIViewController oder Activity verwendet wird, kann Analytics automatisch jeden Bildschirmübergang erfassen und einen Bericht zum Nutzer-Engagement nach Bildschirm erstellen. Wenn das nicht der Fall ist, können Sie diese Berichte auch manuell erfassen, indem Sie screen_view-Ereignisse protokollieren.

Hinweis :Auf Apple-Plattformen ist Firebase auf das Methode-Swizzling angewiesen, um Bildschirmaufrufe automatisch zu erfassen. In SwiftUI-Apps müssen Bildschirmnamen für Ansichten manuell festgelegt werden, die über das FirebaseAnalyticsSwift-Modul protokolliert werden sollen, oder Bildschirmansichten manuell protokolliert werden (siehe unten).

Tracking von Bildschirmaufrufen deaktivieren

Die automatische Erfassung von Screenview-Berichten kann unter iOS deaktiviert werden, indem in der Info.plist-Datei FirebaseAutomaticScreenReportingEnabled auf NO (boolescher Wert) gesetzt wird.

Und auf Android-Geräten verschachteln Sie die folgende Einstellung im <application>-Tag der Datei AndroidManifest.xml:

<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />

Bildschirme manuell erfassen

Sie können screen_view-Ereignisse unabhängig davon manuell erfassen, ob automatisches Tracking aktiviert ist oder nicht. Sie können diese Ereignisse mit den Methoden onAppear oder viewDidAppear für Apple-Plattformen und onResume für Android protokollieren. Wenn screen_class nicht festgelegt ist, legt Analytics einen Standardwert basierend auf dem UIViewController oder der Activity fest, die beim Aufruf im Fokus ist.

Wenn Sie das Swapping in Ihrer App deaktiviert haben, müssen alle Bildschirmnamen manuell festgelegt werden. SwiftUI-Nutzer sollten das Analytics Swift Extension SDK verwenden.

Swift

Hinweis:Dieses Firebase-Produkt ist für das macOS-Ziel nicht verfügbar.

Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])
ViewController.swift

Objective-C

Hinweis:Dieses Firebase-Produkt ist für das macOS-Ziel nicht verfügbar.

[FIRAnalytics logEventWithName:kFIREventScreenView
                    parameters:@{kFIRParameterScreenClass: screenClass,
                                 kFIRParameterScreenName: screenName}];
ViewController.m

Kotlin

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW) {
    param(FirebaseAnalytics.Param.SCREEN_NAME, screenName)
    param(FirebaseAnalytics.Param.SCREEN_CLASS, "MainActivity")
}
MainActivity.kt

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.SCREEN_NAME, screenName);
bundle.putString(FirebaseAnalytics.Param.SCREEN_CLASS, "MainActivity");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW, bundle);
MainActivity.java

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});
analytics_record_screen_view.js

Web

firebase.analytics().logEvent('screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});
index.js

Dart

await FirebaseAnalytics.instance.logEvent(
  name: 'screen_view',
  parameters: {
    'firebase_screen': screenName,
    'firebase_screen_class': screenClass,
  },
);