Pomiar wyświetleń ekranu

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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.

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