Google Analytics śledzi przejścia między ekranami i dołącza do zdarzeń informacje o bieżącym ekranie, co umożliwia śledzenie wskaźników takich jak zaangażowanie użytkowników lub ich zachowanie na poszczególnych ekranach. Większość tych danych jest zbierana automatycznie, ale możesz też ręcznie rejestrować wyświetlenia ekranu. Ręczne śledzenie ekranów jest przydatne, jeśli aplikacja nie używa osobnego UIViewController
, View
ani Activity
dla każdego ekranu, który chcesz śledzić, np. w grze.
Automatyczne śledzenie ekranów
Analytics automatycznie śledzi niektóre informacje o ekranach w aplikacji, takie jak nazwa klasy UIViewController
lub Activity
, która jest obecnie aktywna. Gdy nastąpi przejście do ekranu, Analytics rejestruje zdarzeniescreen_view
, które identyfikuje nowy ekran. Zdarzenia, które występują na tych ekranach, są automatycznie oznaczane tagiem z parametrem firebase_screen_class
(np. menuViewController
lub MenuActivity
) i wygenerowanym parametrem firebase_screen_id
. Jeśli Twoja aplikacja używa osobnego UIViewController
lub Activity
dla każdego ekranu, Analytics może automatycznie śledzić przejścia między ekranami i generować raport o zaangażowaniu użytkowników z podziałem na ekrany. Jeśli Twoja aplikacja nie obsługuje tych funkcji, możesz nadal uzyskiwać te raporty, ręcznie rejestrując zdarzenia screen_view
.
Wyłączanie śledzenia wyświetleń ekranu
Automatyczne raportowanie wyświetleń ekranu można wyłączyć na iOS, ustawiając w pliku Info.plist wartość FirebaseAutomaticScreenReportingEnabled
na NO
(wartość logiczna).
Na Androidzie zagnieźdź to ustawienie w tagu <application>
pliku 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 za pomocą metod onAppear
lub viewDidAppear
na platformach Apple i onResume
na Androidzie. Gdy parametr screen_class
nie jest ustawiony, parametr Analytics ustawia wartość domyślną na podstawie klasy UIViewController lub Activity, która jest aktywna w momencie wywołania.
Jeśli w aplikacji wyłączono zamianę metod, wszystkie nazwy ekranów muszą być ustawiane ręcznie. Użytkownicy SwiftUI mogą korzystać z Analytics pakietu SDK rozszerzenia Swift.
Swift
Analytics.logEvent(AnalyticsEventScreenView, parameters: [AnalyticsParameterScreenName: screenName, AnalyticsParameterScreenClass: screenClass])
Objective-C
[FIRAnalytics logEventWithName:kFIREventScreenView parameters:@{kFIRParameterScreenClass: screenClass, kFIRParameterScreenName: screenName}];
Kotlin
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,
},
);