Zdarzenia w dzienniku

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

Zdarzenia dostarczają informacji o tym, co dzieje się w aplikacji, np. o użytkownikach czynności, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje niektóre wydarzenia dla Ciebie, Ty nie muszą dodać kod, żeby je otrzymać. Jeśli aplikacja ma zbierać dodatkowe możesz zarejestrować maksymalnie 500 różnych typów zdarzeń Analytics w swojej aplikacji. Nie ma limitu całkowitej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że zdarzenie wielkość liter w nazwach jest rozróżniana, a logowanie 2 zdarzeń, których nazwy różnią się tylko daje dwa różne zdarzenia.

Zanim zaczniesz

Upewnij się, że Twój projekt jest skonfigurowany i masz dostęp do Analytics jako opisane w Pierwsze kroki z Analytics

Zdarzenia w dzienniku

Po utworzeniu instancji FirebaseAnalytics możesz jej używać do logowania wydarzenia z logEvent() .

Aby ułatwić rozpoczęcie pracy, pakiet SDK Analytics określa szereg zalecane zdarzenia, które są typowe w różnych typach aplikacji, na przykład aplikacje związane z handlem detalicznym, e-commerce, podróżami i grami. Więcej informacji o tych wydarzeniach i ich używanie znajdziesz w sekcji Zalecane zdarzenia.

Szczegóły implementacji zalecanych typów zdarzeń znajdziesz w tych artykułach: lokalizacje:

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

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 możesz dodać następujące parametry: do dowolnego wydarzenia:

  • Parametry niestandardowe: jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych parametrów zdarzeń nieliczbowych oraz niestandardowe dla dowolnego parametru lepiej przedstawionego w postaci liczbowej. Po zarejestrowano parametr niestandardowy za pomocą pakietu SDK, zarejestruj wymiar lub aby mieć pewność, że te parametry niestandardowe pojawią się w Analytics raportów. Zrób to za pomocą Analytics > Wydarzenia > Zarządzaj niestandardowymi definicjami > Tworzenie wymiarów niestandardowych

    Parametry niestandardowe można stosować odbiorcy definicje, które można zastosować w każdym raporcie. Parametry niestandardowe są też uwzględniane w danych wyeksportowane do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje o Google Analytics 4 BigQuery Export.

  • Parametr VALUE: VALUE jest parametrem ogólnego przeznaczenia przydatne do gromadzenia kluczowych danych związanych z . Mogą to być na przykład przychody, dystans, czas i punkty.

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

Możesz rejestrować parametry w różnych zdarzeniach 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 mieć pewność, że widoczne 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 parametrze 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

Możesz włączyć logowanie szczegółowe, aby monitorować logowanie zdarzeń przez pakiet SDK. sprawdzać, czy zdarzenia są prawidłowo rejestrowane. Uwzględniane są zarówno automatycznie, zdarzeń rejestrowanych 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 dzienniku Androida Studio, od razu sprawdzić, czy zdarzenia są wysyłane.

Wyświetlanie zdarzeń w panelu

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

Dostęp do tych danych możesz uzyskać w Wydarzenia w panelu Firebase. Ten panel pokazuje raporty o zdarzeniach tworzone automatycznie dla poszczególnych typów zdarzeń rejestrowanych przez do aplikacji.