Zdarzenia w dzienniku

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

Zdarzenia dają wgląd w aktualny ruch w Twojej aplikacji, np. w formie działań użytkowników, zdarzeń systemowych lub błędów.

Analytics automatycznie rejestruje niektóre zdarzenia. Nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować maksymalnie 500 różnych Analytics rodzajów zdarzeń. Nie ma limitu łącznej ilości rejestrowanych przez aplikację zdarzeń. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Sprawdź, czy masz skonfigurowany projekt i czy masz dostęp do Analytics zgodnie z opisem w artykule Rozpoczęcie korzystania z 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 pracy, pakiet SDK Analyticsdefiniuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajó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 Polecane zdarzenia.

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

Zdarzenia zalecane: zapoznaj się z com.google.firebase.analytics.FirebaseAnalytics.Eventdokumentacją klasy.
Określone parametry: zobacz odniesienie com.google.firebase.analytics.FirebaseAnalytics.Param.

Poniższy przykład pokazuje, jak rejestrować 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

Poza określonymi parametrami możesz dodać do dowolnego zdarzenia te parametry:

Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w Analyticsraportach. Wymiarów niestandardowych możesz używać w przypadku nienumerycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawiają wartości liczbowe. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby te parametry niestandardowe pojawiały się w raportach Analytics. Możesz to zrobić, korzystając z opcji Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

Parametry niestandardowe można stosować w definicjach list odbiorców, które można 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 inne informacje znajdziesz w artykule BigQuery Export w Google Analytics 4.
Parametr VALUE: VALUE to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma specyficzne potrzeby, których nie obejmuje zalecany typ zdarzenia, 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 zdarzenia

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(), używana jest ta wartość zamiast wartości domyślnej.

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

Wyświetlanie zdarzeń w dzienniku debugowania Androida Studio

Możesz włączyć szczegółowe logowanie, aby monitorować logowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są logowane prawidłowo. Obejmuje to zdarzenia rejestrowane automatycznie 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 pozwala od razu sprawdzić, czy są one wysyłane.

Wyświetlanie zdarzeń w panelu

Zagregowane statystyki dotyczące zdarzeń możesz wyświetlać w Firebasepanelach konsoli. Te panele są okresowo aktualizowane w ciągu dnia. Aby natychmiast przetestować aplikację, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych możesz uzyskać w panelu Wydarzenia w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.