Rejestruj zdarzenia

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

Google Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie; 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 łącznej liczby zdarzeń rejestrowanych przez Twoją 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

Aby móc korzystać z Google Analytics , musisz:

  • Zarejestruj swój projekt Unity i skonfiguruj go do korzystania z Firebase.

    • Jeśli Twój projekt Unity korzysta już z Firebase, oznacza to, że jest już zarejestrowany i skonfigurowany dla Firebase.

    • Jeśli nie masz projektu Unity, możesz pobrać przykładową aplikację .

  • Dodaj pakiet SDK Firebase Unity (w szczególności FirebaseAnalytics.unitypackage ) do swojego projektu Unity.

Pamiętaj, że dodanie Firebase do projektu Unity obejmuje zadania zarówno w konsoli Firebase , jak i w otwartym projekcie Unity (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do swojego projektu Unity).

Rejestruj zdarzenia

Po zainicjowaniu modułu Firebase.Analytics.FirebaseAnalytics można go używać do rejestrowania zdarzeń za pomocą metody LogEvent() .

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 o tych zdarzeniach i kiedy ich używać, przejrzyj artykuły Zdarzenia i właściwości w Centrum pomocy Firebase.

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

  • Sugerowane zdarzenia: zobacz listę stałych Event .
  • Przepisane parametry: zobacz listę stałych Parameters .

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

  • Parametry niestandardowe: parametry niestandardowe nie są przedstawiane bezpośrednio w raportach Analytics, ale można ich używać jako filtrów 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.

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Wyświetl zdarzenia w danych wyjściowych dziennika

Android

Możesz włączyć pełne rejestrowanie w dzienniku debugowania Android Studio, aby pomóc sprawdzić, czy zdarzenia są prawidłowo rejestrowane przez zestaw SDK. 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.

iOS+

Zdarzenia są rejestrowane w konsoli i można je wyświetlać podczas uruchamiania aplikacji za pośrednictwem XCode.

Zobacz zdarzenia analityczne na pulpicie nawigacyjnym

Zagregowane statystyki dotyczące zdarzeń Analytics można wyświetlać w panelach kontrolnych 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.

Aby uzyskać dostęp do tych danych w konsoli Firebase:

  1. W konsoli Firebase otwórz projekt.
  2. Wybierz Analytics z menu, aby wyświetlić panel raportowania Analytics.

Karta Zdarzenia zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego typu zdarzenia Analytics zarejestrowanego przez Twoją aplikację. Więcej informacji o panelu raportowania Analytics znajdziesz w Centrum pomocy Firebase.