Zdarzenia w dzienniku

Wybierz platformę:

iOS+ Android Web Flutter Unity C++

Zdarzenia pozwalają uzyskać wgląd w to, 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, 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 typów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie. Zarejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 osobnych 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 Unity korzysta już z Firebase, jest 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 SDK Firebase Unity (a konkretnie FirebaseAnalytics.unitypackage).

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

Zdarzenia z dzienników

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, pakiet SDK Analytics definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji handlowych i e-commerce, podróżniczych oraz gier mobilnych. 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ółowe informacje o implementacji zalecanych zdarzeń znajdziesz w tych miejscach:

• Sugerowane zdarzenia: zobacz listę stałych Event.
• Zdefiniowane parametry: zobacz listę 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 zalecanych parametrów możesz dodać do dowolnego zdarzenia te parametry:

• Parametry niestandardowe: parametry niestandardowe nie są bezpośrednio widoczne w raportach Analytics, 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 przydaje się do gromadzenia kluczowych danych dotyczących zdarzenia Analytics. Przykłady: przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje sugerowany typ zdarzenia Analytics, 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 logu

Wyświetlanie zdarzeń analitycznych w panelu

W konsoli Firebase możesz wyświetlać zbiorcze statystyki dotyczące zdarzeń w panelu Analytics > Zdarzenia.

Pamiętaj o tych kwestiach dotyczących tego panelu:

• Panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego typu zdarzenia zarejestrowanego przez aplikację.

• Panel jest aktualizowany okresowo w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, użyj konsoli debugowania Xcode lub danych wyjściowych logcat, jak opisano w poprzedniej sekcji tego przewodnika.

Dowiedz się więcej o panelu.