Rejestruj zdarzenia

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

Google Analytics automatycznie rejestruje dla 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 ograniczeń co do całkowitej liczby zdarzeń rejestrowanych przez aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter i że rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, skutkuje dwoma różnymi zdarzeniami.

Zanim zaczniesz

Zanim będziesz mógł 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 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ć Ci rozpoczęcie pracy, pakiet SDK Analytics definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, aplikacji podróżniczych i gier. Aby dowiedzieć się więcej o tych zdarzeniach i tym, kiedy z nich korzystać, zobacz artykuły dotyczące polecanych zdarzeń w Centrum pomocy Google Analytics.

Szczegóły implementacji rekomendowanych wydarzeń znajdziesz w następujących lokalizacjach:

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

Poniższy przykład ilustruje sposób rejestrowania sugerowanego zdarzenia 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ą reprezentowane 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ą także 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, przydatny do gromadzenia kluczowych danych odnoszących się do zdarzenia Analytics. Przykłady obejmują przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma specyficzne 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 wynikach dziennika

Android

Możesz włączyć szczegółowe rejestrowanie w dzienniku debugowania Android Studio, aby sprawdzić, czy zdarzenia są poprawnie rejestrowane przez zestaw SDK. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć szczegółowe rejestrowanie za pomocą szeregu 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 Twoje zdarzenia w logcat Android Studio, pomagając Ci natychmiast sprawdzić, czy zdarzenia są wysyłane.

iOS+

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

Wyświetlaj zdarzenia analityczne na pulpicie nawigacyjnym

Możesz przeglądać zagregowane statystyki dotyczące zdarzeń Analytics w panelach kontrolnych konsoli Firebase. Te pulpity nawigacyjne są aktualizowane okresowo w ciągu dnia. W celu natychmiastowego przetestowania użyj wyjścia logcat zgodnie z opisem w poprzedniej sekcji.

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

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

Karta Zdarzenia zawiera raporty zdarzeń tworzone automatycznie dla każdego typu zdarzeń Analytics rejestrowanych przez Twoją aplikację. Przeczytaj więcej o panelu kontrolnym .