Pomiar wyświetleń ekranu

Google Analytics śledzi przejścia między ekranami i załącza informacje o bieżącym ekranie do zdarzeń, dzięki czemu można śledzić zaangażowanie lub zachowanie użytkownika na każdym ekranie. Znaczna część tych danych automatycznie, ale możesz też rejestrować wyświetlenia ekranu ręcznie. Śledzenie ręczne przydaje się, gdy aplikacja nie używa osobnego interfejsu UIViewController, View lub Activity w przypadku każdego ekranu, który chcesz śledzić, np. w grze.

Automatycznie śledź ekrany

Analytics automatycznie śledzi niektóre informacje o ekranach w aplikacji, np. nazwę klasy obiektu UIViewController lub Activity, który jest obecnie na pierwszym planie. Gdy następuje przejście do ekranu, Analytics rejestruje Zdarzenie screen_view, które identyfikuje nowy ekran. Zdarzenia, które mają miejsce w tych miejscach ekrany są automatycznie otagowane parametrem firebase_screen_class (na np. menuViewController lub MenuActivity) i wygenerowana firebase_screen_id Jeśli aplikacja używa unikalnego identyfikatora UIViewController lub Activity na każdym ekranie, Analytics może automatycznie śledzić każdy z nich. przejść i wygenerować raport zaangażowania użytkowników z podziałem na ekrany. Jeśli nie działa, możesz jednak otrzymywać te raporty, logując się ręcznie Wydarzenia: screen_view.

Wyłączanie śledzenia wyświetleń ekranu

Automatyczne raportowanie wyświetleń ekranu można wyłączyć w iOS za pomocą FirebaseAutomaticScreenReportingEnabled na NO (wartość logiczna) w pliku Info.plist.

Na Androidzie umieść poniższe ustawienie w tagu <application> sekcji Plik AndroidManifest.xml:

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

Ręczne śledzenie ekranów

Możesz ręcznie rejestrować zdarzenia screen_view niezależnie od tego, czy automatyczne śledzenie jest włączone . Możesz rejestrować te zdarzenia w metodach onAppear lub viewDidAppear na platformach Apple i onResume na Androida. Jeśli zasada screen_class nie jest skonfigurowana, Analytics ustawia wartość domyślną na podstawie klasy UIViewController lub Activity na pierwszym planie.

Jeśli przesuwanie w aplikacji zostało wyłączone, wszystkie nazwy ekranów trzeba ustawiać ręcznie. Użytkownicy SwiftUI powinni użyć Analytics Pakiet SDK rozszerzenia Swift.

Swift

Uwaga: ta usługa Firebase jest niedostępna w miejscu docelowym macOS.
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Objective-C

Uwaga: ta usługa Firebase jest niedostępna w miejscu docelowym macOS.
[FIRAnalytics logEventWithName:kFIREventScreenView
                    parameters:@{kFIRParameterScreenClass: screenClass,
                                 kFIRParameterScreenName: screenName}];

Kotlin+KTX

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