Catch up on highlights from Firebase at Google I/O 2023. Learn more

Rejestruj zdarzenia

Ten przewodnik pokazuje, jak rejestrować zdarzenia w aplikacji.

Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje za Ciebie niektóre zdarzenia ; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej do 500 różnych typów zdarzeń Analytics. Nie ma limitu całkowitej liczby zdarzeń rejestrowanych przez aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter, a rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje powstanie dwóch różnych zdarzeń.

Zanim zaczniesz

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

Rejestruj zdarzenia

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

Aby pomóc Ci zacząć, pakiet Analytics SDK definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, podróży i gier. Aby dowiedzieć się więcej o tych wydarzeniach i kiedy ich używać, zobacz Polecane wydarzenia .

Szczegóły implementacji zalecanych typów zdarzeń można znaleźć w następujących lokalizacjach:

Poniższy przykład ilustruje rejestrowanie zdarzenia 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 określonych parametrów do każdego zdarzenia można dodać następujące parametry:

  • Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics . Niestandardowych wymiarów możesz używać w przypadku nieliczbowych danych parametrów zdarzeń i niestandardowych metryk w przypadku dowolnych danych parametrów lepiej przedstawionych liczbowo. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby mieć pewność, że te parametry niestandardowe pojawią się w raportach Analytics. Zrób to za pomocą: Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary

    Parametrów niestandardowych można używać w definicjach odbiorców , które można zastosować 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. Znajdź przykładowe zapytania i wiele więcej w Google Analytics 4 BigQuery Export .

  • Parametr VALUE : VALUE to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Przykłady obejmują przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne niestandardowe zdarzenia, jak pokazano 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

Ustaw domyślne parametry zdarzenia

Możesz rejestrować parametry między zdarzeniami za pomocą 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 zdarzeń, aby pojawiał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() , ta wartość jest używana zamiast wartości domyślnej.

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

Zobacz zdarzenia w dzienniku debugowania Android Studio

Możesz włączyć szczegółowe rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK, aby pomóc zweryfikować, czy zdarzenia są prawidłowo rejestrowane. Obejmuje to zarówno zdarzenia rejestrowane automatycznie, jak i ręcznie.

Możesz włączyć pełne rejestrowanie 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 Android Studio, pomagając natychmiast zweryfikować, czy zdarzenia są wysyłane.

Zobacz zdarzenia na pulpicie nawigacyjnym

Możesz przeglądać zagregowane statystyki dotyczące swoich wydarzeń w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne są okresowo aktualizowane w ciągu dnia. Do natychmiastowego testowania użyj danych wyjściowych logcat, jak opisano w poprzedniej sekcji.

Możesz uzyskać dostęp do tych danych z pulpitu nawigacyjnego Zdarzenia w konsoli Firebase. Ten pulpit nawigacyjny pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.