Catch up on highlights from Firebase at Google I/O 2023. Learn more

Zmierz wyświetlenia ekranu

Google Analytics śledzi przejścia między ekranami i dołącza informacje o bieżącym ekranie do zdarzeń, umożliwiając śledzenie takich wskaźników, jak zaangażowanie użytkowników lub zachowanie użytkowników na każdym ekranie. Wiele z tego zbierania danych odbywa się automatycznie, ale możesz także ręcznie rejestrować wyświetlenia ekranu. Ręczne śledzenie ekranów jest przydatne, jeśli Twoja aplikacja nie używa oddzielnego UIViewController , View lub Activity dla każdego ekranu, który chcesz śledzić, na przykład w grze.

Automatycznie śledź ekrany

Analytics automatycznie śledzi niektóre informacje o ekranach w Twojej aplikacji, takie jak nazwa klasy UIViewController lub Activity , na której aktualnie znajduje się fokus. Kiedy następuje zmiana ekranu, Analytics rejestruje zdarzenie screen_view , które identyfikuje nowy ekran. Zdarzenia występujące na tych ekranach są automatycznie oznaczane parametrem firebase_screen_class (na przykład menuViewController lub MenuActivity ) i wygenerowanym firebase_screen_id . Jeśli Twoja aplikacja używa odrębnego UIViewController lub Activity dla każdego ekranu, Analytics może automatycznie śledzić każde przejście między ekranami i generować raport zaangażowania użytkowników z podziałem na ekrany. Jeśli Twoja aplikacja tego nie robi, nadal możesz otrzymywać te raporty, ręcznie rejestrując zdarzenia screen_view .

Wyłącz śledzenie wyświetleń ekranu

Automatyczne raportowanie wyświetleń ekranu można wyłączyć w systemie iOS, ustawiając FirebaseAutomaticScreenReportingEnabled na NO (Boolean) w pliku Info.plist.

W systemie Android zagnieżdż następujące ustawienie w tagu <application> pliku AndroidManifest.xml :

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

Ręcznie śledź ekrany

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 dla platform Apple i onResume dla Androida. Jeśli screen_class nie jest ustawiona, Analytics ustawia wartość domyślną na podstawie UIViewController lub Activity, które są aktywne podczas wykonywania wywołania.

Jeśli wyłączyłeś swizzling w swojej aplikacji, wszystkie nazwy ekranowe musisz ustawić ręcznie. W przypadku użytkowników SwiftUI użyj pakietu SDK rozszerzenia Analytics Swift .

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie macOS.
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie 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);

Modułowy interfejs API sieci Web

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

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

Internetowy interfejs API z przestrzenią nazw

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