Bildschirmaufrufe messen

Google Analytics erfasst 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 erfassen. Die manuelle Erfassung von Bildschirmen ist nützlich, wenn Ihre App nicht für jeden Bildschirm, den Sie erfassen möchten, eine separate UIViewController-, View- oder Activity-Klasse verwendet, z. B. in einem Spiel.

Bildschirme automatisch erfassen

Analytics erfasst automatisch einige Informationen zu Bildschirmen in Ihrer Anwendung, z. B. den Klassennamen der derzeit aktiven UIViewController- oder Activity-Klasse. 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 ein eigenes UIViewController oder Activity verwendet, kann Analytics automatisch jeden Bildschirmübergang erfassen und einen Bericht zum Nutzer-Engagement nach Bildschirm aufschlüsseln. Wenn Ihre App das nicht tut, können Sie diese Berichte trotzdem erhalten, indem Sie screen_view-Ereignisse manuell protokollieren.

Screenview-Tracking deaktivieren

Die automatische Erfassung von Screenview-Berichten kann unter iOS deaktiviert werden, indem Sie in der Info.plist-Datei FirebaseAutomaticScreenReportingEnabled auf NO (Boolean) festlegen.

Unter Android müssen Sie die folgende Einstellung in das <application>-Tag der Datei AndroidManifest.xml einfügen:

<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 die automatische Erfassung aktiviert ist. Sie können diese Ereignisse in 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, der bzw. die beim Aufruf im Fokus ist.

Wenn Sie Swizzling in Ihrer App deaktiviert haben, müssen alle Bildschirmnamen manuell festgelegt werden. SwiftUI-Nutzer können 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,
  },
);