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.

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.

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

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

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

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

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

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

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