DebugView umożliwia wyświetlanie nieprzetworzonych danych zdarzeń zarejestrowanych przez aplikację na urządzeniach programistycznych w czasie zbliżonym do rzeczywistego. Jest to bardzo przydatne do celów weryfikacji na etapie instrumentacji i może pomóc w wykryciu błędów w implementacji Analytics oraz potwierdzeniu, że wszystkie zdarzenia i właściwości użytkownika są prawidłowo rejestrowane.
Włącz tryb debugowania
Zdarzenia rejestrowane przez aplikację są zwykle grupowane w pakiety obejmujące okres około godziny i przesyłane razem. Takie podejście pozwala oszczędzać baterię na urządzeniach użytkowników i zmniejsza wykorzystanie danych w sieci. Jednak na potrzeby sprawdzania implementacji Analytics (oraz wyświetlania Analytics w raporcie DebugView) możesz włączyć tryb debugowania na urządzeniu używanym do programowania, aby przesyłać zdarzenia z minimalnym opóźnieniem.
iOS+
Aby włączyć tryb debugowania Analytics na urządzeniu używanym do programowania, podaj w Xcode ten argument wiersza poleceń:
-FIRDebugEnabled
Tryb debugowania pozostanie włączony, dopóki go nie wyłączysz tym argumentem wiersza poleceń:
-FIRDebugDisabled
Możesz dodać te argumenty, edytując schemat projektu i dodając nowy wpis do sekcji „Arguments Passed On Launch” (Argumenty przekazywane przy uruchamianiu).
Android
Aby włączyć tryb debugowania Analytics na urządzeniu z Androidem, wykonaj te polecenia:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
Tryb debugowania pozostanie włączony, dopóki go nie wyłączysz tym poleceniem:
adb shell setprop debug.firebase.analytics.app .none.
Sieć
Aby włączyć tryb debugowania Analytics w przeglądarce, zainstaluj rozszerzenie do Chrome Google Analytics Debugger.
Po zainstalowaniu rozszerzenia włącz je i odśwież stronę. Od tego momentu rozszerzenie będzie rejestrować zdarzenia w aplikacji w trybie debugowania.
Zdarzenia zarejestrowane w DebugView możesz wyświetlić w konsoli Firebase.
Wyświetl error zdarzenie
W raporcie DebugView pojawiają się zarówno automatycznie rejestrowane zdarzenia error (które wskazują na problemy z rejestrowaniem zdarzeń lub właściwości użytkownika), jak i inne zdarzenia, które zawierają parametr firebase_error.
Pamiętaj, że zdarzenia error pojawiają się bezpośrednio w strumieniu, ale w przypadku innych zdarzeń, które zawierają parametr firebase_error, DebugView nie wyświetla specjalnego wskaźnika błędu w głównym strumieniu zdarzeń. Aby wyświetlić parametr firebase_error na liście parametrów, musisz kliknąć zdarzenie.
Aby ułatwić debugowanie błędów implementacji Analytics, sprawdź w dziennikach konsoli urządzenia, czy nie ma komunikatów z pakietu SDK Firebase Analytics, które często zawierają szczegółowe informacje o przyczynach odrzucenia zdarzenia lub parametru.
Raportowanie danych zdarzeń
Upewnij się, że na urządzeniach używanych do programowania masz włączony tryb debugowania, jak opisano w poprzedniej sekcji tego przewodnika.
W konsoli Firebase kliknij Analytics > DebugView.
Zacznij korzystać z aplikacji, aby zobaczyć, jak jej zdarzenia są rejestrowane w raporcie DebugView w konsoli Firebase.
Strumień sekund (środkowa kolumna) przedstawia zdarzenia, które zostały zarejestrowane w ciągu ostatnich 60 sekund. W strumieniu minut (kolumna po lewej) zobaczysz serię archiwów zdarzeń z ostatnich 30 minut. Kolumna po prawej pokazuje najczęstsze zdarzenia zarejestrowane w dzienniku zdarzeń z okresu 30 minut, a także aktualne właściwości użytkownika dla wybranego urządzenia, którego używasz do programowania.
Strumień sekund
Domyślnie widoczna jest lista zdarzeń zarejestrowanych w ciągu ostatnich 60 sekund. Każde zdarzenie ma sygnaturę czasową, która wskazuje moment jego zarejestrowania na urządzeniu służącym do programowania. Możesz kliknąć zdarzenie, aby wyświetlić listę powiązanych z nim parametrów.
W miarę jak wartości właściwości użytkownika zmieniają się w toku używania aplikacji, możesz zobaczyć wpis dotyczący tej zmiany.
Strumień minut
Ten strumień wyświetla serię okręgów, z których każdy odpowiada jednej minucie z ostatnich 30 minut. Numer w okręgu oznacza liczbę zdarzeń zarejestrowanych w danej minucie. Kliknięcie okręgu spowoduje wypełnienie strumienia sekund zdarzeniami zarejestrowanymi w danej minucie. Dzięki temu możesz szczegółowo przeanalizować zdarzenia zarejestrowane w ciągu ostatnich 30 minut.
Najczęstsze zdarzenia i aktualne właściwości użytkowników
Tabela Najczęstsze zdarzenia pokazuje najczęstsze zdarzenia, które zarejestrowano w okresie 30 minut. Tabela Aktualne właściwości użytkownika przedstawia najnowszy stan zbioru właściwości użytkownika dla wybranego urządzenia, którego używasz do programowania.
Wybór urządzenia
Tryb debugowania może być włączony na wielu różnych urządzeniach używanych do programowania, dlatego możesz korzystać z menu „Wybór urządzenia”, aby wybrać konkretne urządzenie, którego będzie dotyczyć raport DebugView. Pozwala to różnym programistom skupić się na swoich narzędziach i zadaniach weryfikacji bez przeszkadzania sobie nawzajem.
