Zdarzenia w dzienniku

Zdarzenia pozwalają stwierdzić, co dzieje się w aplikacji. Dostarczają informacji m.in. o działaniach użytkowników, zdarzeniach systemowych i błędach.

Google Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie. Nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej maksymalnie 500 różnych typów zdarzeń Analytics. Nie ma limitu łącznej 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 wielkością liter, powoduje powstawanie 2 różnych zdarzeń.

Zanim zaczniesz

Zanim zaczniesz korzystać z Google Analytics:

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

  • Jeśli Twój projekt w Unity korzysta już z Firebase, oznacza to, że został zarejestrowany i skonfigurowany pod kątem Firebase.

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

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

Pamiętaj, że dodanie Firebase do projektu Unity wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie Unity (np. musisz pobrać z konsoli pliki konfiguracyjne Firebase, a następnie przenieść je do 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ć Ci rozpoczęcie pracy, pakiet SDK Analytics definiuje kilka zalecanych zdarzeń, które są typowe w różnych rodzajach aplikacji, m.in. w aplikacjach zajmujących się handlem detalicznym i e-commerce, a także w aplikacjach podróżniczych i grach. 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óły implementacji zalecanych zdarzeń znajdziesz w tych miejscach:

• Sugerowane zdarzenia: zobacz listę stałych Event.
• Zalecane parametry: patrz lista 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 każdego zdarzenia możesz dodać te parametry:

• Parametry niestandardowe: parametry niestandardowe nie są odzwierciedlane bezpośrednio w raportach Analytics, ale można ich używać jako filtrów w definicjach odbiorców, które można stosować we wszystkich raportach. Parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery, jeśli aplikacja jest połączona z projektem BigQuery.

• Parametr VALUE: VALUE to parametr ogólnego przeznaczenia, który przydaje się do gromadzenia kluczowych danych związanych ze zdarzeniem Analytics. Mogą to być na przykład przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma konkretne potrzeby, których nie obejmuje sugerowany typ 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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

Wyświetlanie zdarzeń analitycznych w panelu

Zbiorcze statystyki zdarzeń Analytics możesz wyświetlać w panelach konsoli Firebase. Panele są aktualizowane okresowo 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. W menu kliknij Analytics, aby wyświetlić panel raportowania Analytics.

Na karcie Zdarzenia wyświetlają się raporty zdarzeń, które są tworzone automatycznie dla każdego rodzaju zdarzenia Analytics rejestrowanego przez Twoją aplikację. Dowiedz się więcej o panelu.