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 der Datenerfassung erfolgt automatisch, aber Sie können Bildschirmaufrufe auch manuell protokollieren. 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 auf diesen Bildschirmen werden automatisch mit dem Parameter firebase_screen_class (z. B. menuViewController oder MenuActivity) und einem generierten firebase_screen_id getaggt. Wenn deine App eine eigene UIViewController oder Activity für jeden Bildschirm verwendet, kann Analytics automatisch jeden Bildschirmübergang erfassen und einen Bericht zur Nutzerinteraktion nach Bildschirm erstellen. Wenn das nicht der Fall ist, können Sie diese Berichte auch manuell erfassen, indem Sie screen_view-Ereignisse protokollieren.

Bildschirmaufruf-Tracking 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.

Unter Android verschachtelst du 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,
  },
);