Nazwy ekranów w GA4: dlaczego aplikacja pokazuje MainActivity
Otwierasz w GA4 raport Strony i ekrany, przełączasz się na strumień aplikacji i widzisz jedną klasę, powtarzaną w każdym wierszu. MainActivity. Albo FlutterViewController. Albo UIHostingController. Zero informacji o tym, które ekrany ludzie faktycznie otwierają, choć na liście zdarzeń screen_view pojawia się regularnie. To nie jest błąd raportu. To skutek tego, co pakiet SDK wysyła domyślnie, i tego, czego nie wysyła wcale.
W listopadzie 2026 Google dodało do tego nowość: agent skills dla Google Analytics for Firebase, czyli instrukcje dla asystentów kodowania, które mają ustawić pomiar w aplikacji i podłączyć logowanie ekranów. Narzędzie nie naprawi jednak decyzji, których nikt nie podjął.
Co pakiet SDK wysyła sam
Google Analytics dla Firebase śledzi przejścia między ekranami automatycznie. Przy zmianie ekranu wysyła zdarzenie screen_view i dokłada do niego nazwę klasy, która jest w danym momencie aktywna: UIViewController na iOS albo Activity na Androidzie. Do tego generuje identyfikator ekranu. Parametry firebase_screen_id i firebase_screen_class są zbierane automatycznie, chyba że wyłączysz śledzenie wyświetleń ekranu.
Mechanizm działa w aplikacji, która ma osobny Activity albo UIViewController dla każdego ekranu. Dokumentacja Firebase mówi wprost: ręczne logowanie jest potrzebne wtedy, gdy aplikacja nie używa oddzielnego widoku dla każdego ekranu, jaki chcesz mierzyć.
Klasa i nazwa to dwa różne wymiary
Raport Strony i ekrany daje trzy wymiary do wyboru. Ścieżka do strony i klasa ekranu, tytuł strony i klasa ekranu oraz tytuł strony i nazwa ekranu. Klasa pochodzi z nazwy aktualnie aktywnej klasy, czyli z kodu, którego nikt nie nazywał pod raportowanie. Nazwa pochodzi z nazwy nadanej ekranowi przez Firebase, czyli z miejsca, w którym developer sam ją wpisał.
Stąd bierze się cała różnica. Klasa zawsze się wypełni, bo wynika z tego, co dzieje się w aplikacji. Nazwa wypełni się tylko wtedy, gdy ktoś ją ustawi. Jeśli nikt tego nie zrobił, grupowanie po nazwie pokazuje (not set) dla całego strumienia aplikacji, a grupowanie po klasie pokazuje jeden albo kilka wierszy niezależnie od tego, ile ekranów ma produkt.
Dlaczego interfejs deklaratywny psuje automat
Przez lata aplikacje miały jeden ekran równy jednej klasie. Jetpack Compose, SwiftUI, Flutter i React Native odwróciły ten układ. Jeden Activity albo jeden kontroler gospodarza obsługuje całą nawigację, a ekrany są funkcjami w środku. Automat widzi wtedy jedno przejście na starcie i jedno w tle, bo klasa się nie zmienia.
Google przyznaje to w ogłoszeniu z 10 listopada 2026: przy przejściu na deklaratywny interfejs ręczne logowanie screen_view staje się coraz częściej konieczne. To zdanie jest ważniejsze niż cała reszta komunikatu, bo opisuje sytuację większości nowych aplikacji, a nie wyjątek.
Ręczne logowanie: co trzeba ustawić
Zdarzenie screen_view można wysłać samemu, niezależnie od tego, czy automat działa. Miejsce wywołania zależy od platformy: onAppear lub viewDidAppear na platformach Apple i onResume na Androidzie. Dwa szczegóły psują raport po cichu.
Pierwszy: gdy nie ustawisz klasy ekranu, Analytics wpisze tam klasę widoku, który jest aktualnie aktywny. W aplikacji z jednym gospodarzem nazwa ekranu będzie poprawna, a klasa nadal będzie ta sama. Drugi: jeśli w aplikacji wyłączono swizzling, wszystkie nazwy ekranów muszą być ustawione ręcznie. Przy SwiftUI potrzebne jest rozszerzenie Analytics dla Swifta, bo sam kontroler gospodarza nie opisuje nawigacji.
Do tego dochodzi dyscyplina nazw. Wartość parametru zdarzenia ma limit 100 znaków, więc nazwa ekranu musi być krótka i stabilna. Ustal jeden schemat, na przykład koszyk, platnosc, potwierdzenie, i trzymaj go w całej aplikacji. Nazwy zmieniane przy każdym wydaniu rozbiją historię na dziesiątki wierszy, których nie da się porównać rok do roku. Nie wkładaj też do nazwy identyfikatorów użytkownika ani treści ekranu, bo trafią do wymiaru, który nie jest do tego przeznaczony.
Wyłączenie automatu i ryzyko podwójnego liczenia
Jeśli logujesz ekrany ręcznie, automat zwykle trzeba wyłączyć. Na iOS robi to klucz FirebaseAutomaticScreenReportingEnabled ustawiony na NO w pliku Info.plist. Na Androidzie wpis w manifeście, w tagu application: google_analytics_automatic_screen_reporting_enabled z wartością false.
Bez tego kroku oba mechanizmy działają równolegle. Na ekranie z własną aktywnością pojawią się dwa zdarzenia, jedno z automatu i jedno z kodu. Liczba wyświetleń rośnie, a nikt nie zauważa duplikatów.
Co to zmienia w liczbach
Metryka Wyświetlenia w tym raporcie liczy każde wyświetlenie strony lub ekranu, wraz z powtórzeniami. Jeśli ekrany są zgrupowane po klasie, liczba wygląda poprawnie, a podział jest bezużyteczny. Jeśli screen_view w ogóle nie leci, bo automat został wyłączony i nikt nie dodał ręcznego logowania, raport jest pusty, a reszta danych wygląda zdrowo.
Skutek sięga dalej niż ten jeden raport. GA4 uznaje sesję za zaangażowaną, gdy trwa co najmniej 10 sekund, zawiera kluczowe zdarzenie albo co najmniej dwa wyświetlenia strony bądź ekranu. Aplikacja bez wyświetleń ekranów traci trzecią furtkę i część sesji spada do niezaangażowanych, mimo że użytkownik spędził w niej kilka minut. Współczynnik zaangażowania wychodzi zaniżony, a przyczyny szuka się zwykle w definicji sesji.
Eksploracja sekwencji ścieżki pozwala sprawdzić, co użytkownik otwierał przed danym ekranem i po nim. Bez nazw ekranów trasa składa się z jednego punktu.
Nowość z listopada 2026: agent skills dla GA4F
Google dodało do pakietu Firebase agent skills dla Google Analytics for Firebase. To moduły wiedzy dla asystentów kodowania, które mają poprowadzić integrację: połączyć aplikację z Firebase, dodać zależności i kod inicjalizujący, a przy drugim zadaniu podłączyć ręczne logowanie screen_view w aplikacji z deklaratywnym interfejsem.
Działa lepiej niż zwykły czat z modelem z dwóch powodów. Skill zna pułapki platformowe, na przykład flagę linkera -ObjC wymaganą w projekcie iOS i poprawne zadeklarowanie pakietu SDK w pliku Gradle na Androidzie. Zna też kontekst projektu, czyli strukturę katalogów i warianty budowania, które inaczej wywalają kompilację. Instalacja jest jednorazowa: marketplace Antigravity, wtyczka w Claude Code, katalog Codex, marketplace Cursor albo polecenie npx skills add firebase/agent-skills dla dowolnego agenta.
Przed produkcją zostają trzy zastrzeżenia. Agent zmienia kod pomiarowy w aplikacji, więc diff trzeba przeczytać, a nie zaakceptować w całości. Nazwy ekranów muszą pochodzić z uzgodnionego schematu, bo agent wymyśli własne, jeśli nikt mu ich nie poda. Weryfikacja nie kończy się na zielonym buildzie: zdarzenia trzeba zobaczyć w DebugView, z parametrami.
Jak sprawdzić, czy nazwy działają
Włącz tryb debugowania w aplikacji i otwórz DebugView w GA4. Przejdź przez trzy, cztery ekrany i sprawdź, czy każde przejście daje osobne zdarzenie screen_view z różną nazwą i z tą samą klasą. Ten ostatni szczegół pokazuje, czy raport będzie miał czym grupować.
Potem wróć do raportu Strony i ekrany, przełącz wymiar na tytuł strony i nazwę ekranu i sprawdź, czy wiersze odpowiadają ekranom z aplikacji. Jeśli widzisz (not set), nazwy nie są wysyłane. Jeśli widzisz jedną klasę, wysyłane są tylko automatyczne. Oba przypadki są diagnozą, nie awarią.
Zgoda i granica prawna
W aplikacji art. 399 Prawa komunikacji elektronicznej dotyczy dostępu do informacji zapisanych w urządzeniu końcowym, a identyfikator instancji aplikacji jest taką informacją. Tryb zgody dla Firebase pozwala ustawić domyślne wartości dla analytics_storage i ad_storage oraz zmienić je metodą setConsent po decyzji użytkownika. Osobno działa setAnalyticsCollectionEnabled, które wstrzymuje zbieranie do czasu zgody.
Kolejność ma znaczenie. Domyślne wartości muszą być ustawione przed inicjalizacją pakietu SDK, inaczej pierwsze zdarzenia, w tym first_open i pierwszy screen_view, wyjdą przed decyzją. To ten sam błąd co odpalenie tagów przed banerem na stronie, tylko trudniejszy do zauważenia.
North Digital sprawdza pomiar w GA4 dla witryn i aplikacji, w tym nazwy ekranów, zgodę i jakość danych w strumieniach. Zamów konsultację.