Zdarzenia w dzienniku

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Zdarzenia pozwalają stwierdzić, co dzieje się w aplikacji. Dostarczają informacji m.in. o działaniach użytkowników , zdarzeniach systemowych i błędach.

Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej do 500 różnych Analytics zdarzeń typów Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter – 2 zdarzenia, których nazwy różnią się tylko wielkością liter, będą traktowane jako 2 różne zdarzenia.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics.

Zdarzenia w dzienniku

Po utworzeniu instancji FirebaseAnalytics możesz jej używać do rejestrowania zdarzeń za pomocą logEvent() metody.

Aby ułatwić Ci rozpoczęcie, pakiet SDK Analytics definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji handlowych i e-commerce, podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Zalecane zdarzenia.

Szczegóły implementacji zalecanych typów zdarzeń znajdziesz w tych miejscach:

Poniższy przykład pokazuje, jak zarejestrować zdarzenie SELECT_CONTENT:

Kotlin 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Java 

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Oprócz określonych parametrów możesz dodać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych parametrów zdarzeń, które nie są liczbami, a danych niestandardowych w przypadku danych parametrów, które lepiej reprezentują liczby. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby te parametry niestandardowe pojawiały się w raportach Analytics. Aby to zrobić, w konsoli Firebase kliknij Analytics > Definicje niestandardowe.

    Parametry niestandardowe mogą być używane w definicjach odbiorców , które można stosować do każdego raportu. Parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery , jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje znajdziesz w artykule BigQuery Export w Google Analytics 4.

  • VALUE parametr: VALUE to parametr ogólnego przeznaczenia który jest przydatny do gromadzenia kluczowych danych związanych ze zdarzeniem. Przykłady: przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma szczególne potrzeby, których nie spełnia żaden z zalecanych typów zdarzeń, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano w tym przykładzie:

Kotlin 

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Java 

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

Ustawianie domyślnych parametrów zdarzeń

Za pomocą setDefaultEventParameters możesz rejestrować parametry w różnych zdarzeniach. Domyślne parametry są powiązane ze wszystkimi przyszłymi zdarzeniami, które zostaną zarejestrowane.

Podobnie jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzeń, aby pojawiały się w raportach Analytics.

Kotlin 

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Jeśli parametr jest określony w metodzie logEvent(), zamiast wartości domyślnej używana jest ta wartość.

Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters z parametrem ustawionym na null.

Wyświetlanie zdarzeń w dzienniku debugowania Android Studio

Możesz włączyć logowanie szczegółowe, aby monitorować rejestrowanie zdarzeń przez pakiet SDK i sprawdzić, czy zdarzenia są rejestrowane prawidłowo. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć logowanie szczegółowe za pomocą serii poleceń narzędzia adb:

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

To polecenie wyświetla zdarzenia w logcat Android Studio, co pozwala od razu sprawdzić, czy zdarzenia są wysyłane.

Wyświetlanie zdarzeń na panelu

W konsoli Firebase możesz wyświetlać zagregowane statystyki dotyczące zdarzeń na panelu Analytics > Zdarzenia.

O tym panelu warto wiedzieć te rzeczy:

  • Panel wyświetla raporty o zdarzeniach, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.

  • Panel jest okresowo aktualizowany w ciągu dnia. Aby przeprowadzić natychmiastowe testy, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji tego przewodnika.