Rejestruj zdarzenia

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

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

Analytics automatycznie rejestruje pewne wydarzenia dla Ciebie; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, można zalogować się do 500 różnych typów Analytics wydarzenie w swojej aplikacji. Nie ma limitu łącznej 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 odrębnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz ustawione projektu i mogą uzyskać dostęp do Analytics jak opisano w Pierwsze kroki z Analytics .

Rejestruj zdarzenia

Po utworzeniu FirebaseAnalytics przykład, można go używać do rejestrowania zdarzeń z logEvent() metody.

Aby ułatwić rozpoczęcie pracy, pakiet Analytics SDK definiuje szereg sugerowanych 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 na temat tych wydarzeń i kiedy je stosować, przeglądanie zdarzeń i właściwości artykuły w Centrum pomocy Firebase.

Szczegóły implementacji sugerowanych typów zdarzeń znajdziesz w następujących lokalizacjach:

Poniższy przykład pokazuje, jak zalogować się SELECT_CONTENT wydarzenie:

Jawa

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);

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")
}

Oprócz określonych parametrów do dowolnego zdarzenia można dodać następujące parametry:

  • Niestandardowe parametry: niestandardowe parametry mogą być rejestrowane za zgłoszenie w raportach Analytics. Mogą być również stosowane jako filtry w oglądalności definicji, które można zastosować do każdego raportu. Parametry niestandardowe są również zawarte w danych eksportowanych do BigQuery jeśli aplikacja jest powiązana z projektem BigQuery.

  • VALUE parametr: VALUE jest parametrem ogólnego przeznaczenia, które są przydatne do gromadzenia kluczowy parametr, który odnosi się do zdarzenia. Przykłady obejmują przychody, odległość, czas i punkty.

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

Jawa

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

Kotlin+KTX

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

Ustaw domyślne parametry zdarzenia

Parametry można zalogować całej imprez wykorzystujących setDefaultEventParameters . Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.

Jawa

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

Kotlin+KTX

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Jeśli parametr jest specificed w logEvent() metodę, która wartość jest używana zamiast domyślnego.

Aby usunąć parametr domyślny, zadzwoń setDefaultEventParameters metodę z parametrem ustawionym na null .

Wyświetl zdarzenia w dzienniku debugowania Android Studio

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

Pełne rejestrowanie można 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 Android Studio, pomagając natychmiast sprawdzić, czy zdarzenia są wysyłane.

Zobacz wydarzenia w desce rozdzielczej

Zagregowane statystyki dotyczące zdarzeń możesz wyświetlić w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne aktualizują się okresowo 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 Zdarzenia desce rozdzielczej w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego typu zdarzenia zarejestrowanego przez Twoją aplikację.