Zdarzenia w dzienniku

Wybierz platformę:

iOS+ Android Web Flutter Unity C++

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 dla Ciebie, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej do 500 różnych Analytics typów zdarzeń. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter – 2 zdarzenia, których nazwy różnią się tylko wielkością liter, będą traktowane jako 2 różne zdarzenia.

Zanim zaczniesz

Zanim zaczniesz korzystać z Google Analytics, musisz:

• zarejestrować projekt w Unity i skonfigurować go do korzystania 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 w Unity, możesz pobrać przykładową aplikację.

• dodać do projektu w Unity pakiet Firebase Unity SDK (a konkretnie FirebaseAnalytics.unitypackage).

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

Zdarzenia w dzienniku

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 Analytics definiuje kilka zalecanych zdarzeń, które są wspólne dla różnych typó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 o zalecanych zdarzeniach w Centrum pomocy Google Analytics.

Szczegóły implementacji zalecanych zdarzeń znajdziesz w tych miejscach:

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

Poniższy przykład pokazuje, jak zarejestrować sugerowane 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ć do dowolnego zdarzenia te parametry:

• Parametry niestandardowe: parametry niestandardowe nie są bezpośrednio reprezentowane w Twoich Analytics raportach, 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 parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia.Analytics Przykłady to przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma szczególne potrzeby, których nie spełnia sugerowany Analytics typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe Analytics jak pokazano w tym przykładzie:

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

Wyświetlanie zdarzeń w danych wyjściowych dziennika

Wyświetlanie zdarzeń Analytics w panelu

Zagregowane 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 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 FirebaseFirebase otwórz swój projekt.
2. W menu wybierz Analytics , aby wyświetlić panel raportowania Analytics.

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