Zdarzenia w dzienniku

Zdarzenia pozwalają stwierdzić, co dzieje się w aplikacji. Dostarczają informacji o użytkownikach. czynności, zdarzenia systemowe lub błędy.

Google Analytics automatycznie rejestruje niektóre wydarzenia dla Ciebie, nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać możesz zarejestrować do 500 różnych typów zdarzeń Analytics, w aplikacji. Nie ma limitu całkowitej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter, a logowanie 2 zdarzeń, których nazwy różnią się tylko przypadkiem, gdy powstaną 2 różne zdarzenia.

Zanim zaczniesz

Zanim będzie można użyć Google Analytics, musisz:

  • Zarejestruj projekt Unity i skonfiguruj go pod kątem korzystania z Firebase.

    • Jeśli Twój projekt w Unity korzysta już z Firebase, zarejestrowane i skonfigurowane w Firebase.

    • Jeśli nie masz projektu Unity, możesz pobrać przykładowej aplikacji.

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

Pamiętaj, że dodanie Firebase do projektu Unity wymaga wykonania zadań zarówno w w konsoli Firebase i w otwartym projekcie Unity. (np. pobierasz z konsoli pliki konfiguracyjne Firebase, do swojego projektu Unity).

Zdarzenia w dzienniku

Po zainicjowaniu modułu Firebase.Analytics.FirebaseAnalytics możesz używać go do rejestrowania zdarzeń za pomocą metody 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. Aby dowiedzieć się więcej o tych wydarzeniach i kiedy ich używać, przeczytaj artykuł Zalecane zdarzenia. w Centrum pomocy Google Analytics.

Szczegółowe informacje o implementacji zalecanych zdarzeń znajdziesz w tych artykułach: lokalizacje:

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

Poniższy przykład pokazuje, jak zapisać sugerowane wartości SELECT_CONTENT Zdarzenie:

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

  • Parametry niestandardowe: parametry niestandardowe nie są odzwierciedlane bezpośrednio w raportów Analytics, ale możesz ich używać jako filtrów Definicje odbiorców, które można zastosować w każdym raporcie. Niestandardowy zakres dat są też uwzględniane w danych eksportowanych do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery.

  • Parametr VALUE: VALUE to parametr do zwykłych obciążeń. przydatne do gromadzenia kluczowych danych związanych z Zdarzenie Analytics. Mogą to być na przykład przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma konkretne potrzeby, których nie uwzględnia zalecany typu zdarzenia Analytics – możesz rejestrować własne, niestandardowe zdarzenia Analytics. Jak w tym przykładzie:

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

Wyświetl zdarzenia w danych wyjściowych dziennika

Android

Logowanie szczegółowe możesz włączyć w dzienniku debugowania Android Studio, Sprawdź, czy pakiet SDK prawidłowo rejestruje zdarzenia. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak 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 dzienniku Androida Studio, co ułatwia od razu upewnisz się, że zdarzenia są wysyłane.

iOS+

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

Wyświetlanie zdarzeń analitycznych w panelu

Zbiorcze statystyki zdarzeń Analytics 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.

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

  1. W konsoli Firebase otwórz projekt.
  2. Aby wyświetlić statystyki, wybierz z menu Statystyki. panelu raportowania.

Na karcie Zdarzenia znajdziesz raporty o zdarzeniach, tworzone automatycznie dla każdego rodzaju zdarzenia Analytics rejestrowanego przez do aplikacji. Dowiedz się więcej o panelu.