Zdarzenia w dzienniku


Z tego przewodnika dowiesz się, jak rejestrować zdarzenia w aplikacji.

Zdarzenia dają wgląd w to, co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe i błędy.

Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie. Nie musisz dodawać żadnego kodu, aby je odbierać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej maksymalnie 500 różnych typów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje zarejestrowanie 2 różnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i masz dostęp do usługi Analytics w sposób opisany w artykule Pierwsze kroki z usługą Analytics.

Zdarzenia z dziennika

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

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

Szczegółowe informacje o wdrożeniu zalecanych typów zdarzeń znajdziesz w tych miejscach:

Ten przykład pokazuje, jak rejestrować zdarzenie SELECT_CONTENT:

Kotlin+KTX 

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 parametrów zalecanych możesz dodawać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: w Analyticsraportach można używać parametrów niestandardowych jako wymiarów lub danych. Wymiarów niestandardowych możesz używać w przypadku danych nieliczbowych parametrów zdarzenia i danych niestandardowych w przypadku dowolnych danych parametrów, które lepiej są przedstawiane w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub metrykę, aby parametry niestandardowe pojawiały się w raportach Analytics. Aby to zrobić, kliknij Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

    Parametry niestandardowe możesz stosować w definicjach odbiorców, które możesz stosować w każdym raporcie. 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 wiele innych informacji znajdziesz w artykule BigQuery Export w Google Analytics 4.

  • Parametr VALUE: VALUE to parametr ogólnego przeznaczenia, który przydaje się do gromadzenia kluczowych danych związanych ze zdarzeniem. Mogą to być na przykład przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje żaden zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak w tym przykładzie:

Kotlin+KTX 

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 zdarzenia

Parametry w różnych zdarzeniach możesz rejestrować za pomocą narzędzia setDefaultEventParameters. Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.

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

Kotlin+KTX 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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

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

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

Wyświetlanie zdarzeń w dzienniku debugowania Android Studio

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

Logowanie szczegółowe możesz włączyć za pomocą serii poleceń 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 w Android Studio, co ułatwia natychmiastowe sprawdzenie, czy są one wysyłane.

Wyświetlanie zdarzeń w panelu

Zbiorcze statystyki zdarzeń możesz wyświetlać w panelach konsoli Firebase. Te panele są okresowo aktualizowane w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Te dane są dostępne w panelu Zdarzenia w konsoli Firebase. Ten panel pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego rodzaju zdarzenia rejestrowanego przez Twoją aplikację.