Bildschirmaufrufe messen

Google Analytics verfolgt Bildschirmübergänge und fügt Ereignissen Informationen zum aktuellen Bildschirm hinzu. So können Sie Messwerte wie Nutzer-Engagement oder Nutzerverhalten pro Bildschirm erfassen. Ein Großteil dieser Datenerhebung erfolgt automatisch, Sie können Bildschirmaufrufe aber auch manuell protokollieren. Das manuelle Tracking von Bildschirmen ist nützlich, wenn Ihre App nicht für jeden Bildschirm, den Sie erfassen möchten, ein separates UIViewController, View oder Activity verwendet, z. B. in einem Spiel.

Bildschirme automatisch erfassen

Analytics erfasst automatisch einige Informationen zu Bildschirmen in Ihrer Anwendung, z. B. den Klassennamen des UIViewController oder Activity, der gerade im Fokus ist. Wenn ein Bildschirmübergang erfolgt, protokolliert Analytics ein screen_view-Ereignis, 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 Ihre App für jeden Bildschirm eine eigene UIViewController oder Activity verwendet, kann Analytics jeden Bildschirmübergang automatisch erfassen und einen Bericht zum Nutzer-Engagement nach Bildschirm erstellen. Wenn Ihre App dies nicht tut, können Sie diese Berichte trotzdem erhalten, indem Sie screen_view-Ereignisse manuell protokollieren.

Tracking von Bildschirmaufrufen deaktivieren

Die automatische Berichterstellung für Bildschirmaufrufe kann unter iOS deaktiviert werden, indem FirebaseAutomaticScreenReportingEnabled in der Datei „Info.plist“ auf NO (boolescher Wert) gesetzt wird.

Unter Android müssen Sie die folgende Einstellung im <application>-Tag der Datei AndroidManifest.xml verschachteln:

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

Bildschirme manuell erfassen

Sie können screen_view-Ereignisse manuell protokollieren, unabhängig davon, ob das automatische 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 fest, der auf dem UIViewController oder der Activity basiert, die beim Aufruf im Fokus ist.

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

Swift

Hinweis:Dieses Firebase-Produkt ist für watchOS nicht verfügbar. 
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                               AnalyticsParameterScreenClass: screenClass])

Objective-C

Hinweis:Dieses Firebase-Produkt ist für watchOS nicht verfügbar. 
[FIRAnalytics logEventWithName:kFIREventScreenView
                    parameters:@{kFIRParameterScreenClass: screenClass,
                                 kFIRParameterScreenName: screenName}];

Kotlin 

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

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);

Web 

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

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

Web 

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

Dart 

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