Zdarzenia w dzienniku

Zdarzenia dają wgląd w aktualny ruch w Twojej aplikacji, np. w formie działań użytkowników, zdarzeń systemowych lub błędów.

Google Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej maksymalnie 500 różnych Analyticsrodzajów zdarzeńAnalytics. Nie ma limitu łącznej ilości zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Zanim zaczniesz korzystać z Google Analytics, musisz:

  • Zarejestruj projekt Unity i skonfiguruj go tak, aby korzystał z Firebase.

    • Jeśli Twój projekt w Unity korzysta już z Firebase, jest on już zarejestrowany i skonfigurowany pod kątem Firebase.

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

  • Dodaj do projektu Unity pakiet Firebase Unity SDK (a konkretnie FirebaseAnalytics.unitypackage).

Pamiętaj, że dodanie Firebase do projektu w Unity wymaga wykonania czynności zarówno w Firebasekonsoli, jak i w otwartym projekcie w Unity (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a następnie przenosisz je do projektu w Unity).

Zdarzenia z dziennika

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

Aby ułatwić Ci rozpoczęcie pracy, pakiet SDK Analyticsdefiniuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajów aplikacji, w tym aplikacji handlowych i e-commerce, podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykułach Zalecane zdarzenia w Centrum pomocy Google Analytics.

Szczegółowe informacje o wdrażaniu zalecanych zdarzeń znajdziesz w tych miejscach:

  • Sugerowane zdarzenia: zobacz listę stałych Event.
  • Określone parametry: zobacz listę stałych Parameters.

Poniższy przykład pokazuje, jak rejestrować 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)
);

Poza określonymi parametrami możesz dodać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: parametry niestandardowe nie są bezpośrednio reprezentowane w raportachAnalytics, ale można ich używać jako filtrów w definicjach odbiorców, które można stosować 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.

  • VALUE Parametr: VALUE to ogólny parametr, który jest przydatny do gromadzenia kluczowych danych dotyczących Analyticszdarzenia. Są to na przykład przychody, odległość, czas i punkty.

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

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

Wyświetlanie zdarzeń w danych wyjściowych logu

Android

Możesz włączyć szczegółowe logowanie w dzienniku debugowania Androida Studio, aby sprawdzić, czy pakiet SDK prawidłowo rejestruje zdarzenia. Obejmuje to zdarzenia rejestrowane automatycznie i 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 logcat w Android Studio, co pozwala od razu sprawdzić, czy są one wysyłane.

iOS+

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

Wyświetlanie zdarzeń analitycznych w panelu

Zagregowane statystyki dotyczące AnalyticszdarzeńFirebase możesz wyświetlać w panelach konsoli. Te panele są okresowo aktualizowane w ciągu dnia. Aby natychmiast przetestować aplikację, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

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

  1. W Firebasekonsoli otwórz projekt.
  2. W menu kliknij Analytics, aby wyświetlić panel raportowania.Analytics

Karta Zdarzenia zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia Analytics rejestrowanego przez aplikację. Więcej informacji o panelu