Zdarzenia w dzienniku

Zdarzenia pozwalają poznać działania w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.

Google Analytics automatycznie rejestruje niektóre zdarzenia. Aby je otrzymywać, nie musisz dodawać kodu. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować 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. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje zarejestrowanie 2 różnych zdarzeń.

Zanim zaczniesz

Zanim zaczniesz korzystać z Google Analytics, musisz:

• Zarejestruj projekt Unity i skonfiguruj go tak, aby używał Firebase.

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

  • Jeśli nie masz projektu Unity, możesz pobrać próbną aplikację.

• Dodaj pakiet SDK Firebase Unity (szczególnie plik FirebaseAnalytics.unitypackage) do projektu Unity.

Szczegółowe instrukcje dotyczące tych początkowych zadań konfiguracyjnych znajdziesz w artykule Dodawanie Firebase 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. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu 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 korzystania z pakietu SDK, Analytics definiuje on kilka zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do zakupów i e-commerce, aplikacji 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.

Uwaga: aby w raportach pojawiały się jak najbardziej szczegółowe informacje, rejestruj sugerowane AnalyticsZdarzenia, które mają sens w przypadku Twojej aplikacji, oraz ich określone parametry. Dzięki temu będziesz korzystać z najnowszych funkcji Google Analytics, gdy tylko będą dostępne.

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

• Zasugerowane zdarzenia: zobacz listę stałych Event.
• Parametry narzucone: zobacz listę stałych Parameters.

Ten 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)
);

Oprócz parametrów zalecanych możesz dodawać do dowolnego zdarzenia te parametry:

• Parametry niestandardowe: parametry niestandardowe nie są widoczne bezpośrednio w raportach Analytics, ale można ich używać jako filtrów w definicjach odbiorców, które można stosować w każdym raporcie. 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 parametr ogólnego przeznaczenia, który przydaje się do gromadzenia kluczowych danych dotyczących Analytics zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.

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

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

Wyświetlanie zdarzeń w wyjściu z logu

Android

Aby sprawdzić, czy zdarzenia są prawidłowo rejestrowane przez pakiet SDK, możesz włączyć szczegółowe logowanie w dzienniku debugowania Android Studio. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć szczegółowe logowanie 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, dzięki czemu możesz od razu sprawdzić, czy są one wysyłane.

iOS+

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

Wyświetlanie zdarzeń analitycznych w panelu

Zbiorcze statystyki dotyczące zdarzeń Analytics możesz wyświetlać w panelach konsoli Firebase. Te panele są okresowo aktualizowane w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, 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 znajdziesz raporty o zdarzeniach tworzone automatycznie dla każdego rodzaju zdarzenia Analytics zarejestrowanego przez Twoją aplikację. Więcej informacji o panelu.