Pierwsze kroki z Google Analytics dla Unity

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Google Analytics zbiera dane o użytkowaniu i zachowaniu w aplikacji. Pakiet SDK rejestruje 2 główne typy informacji:

  • Zdarzenia: co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: atrybuty, które definiujesz, aby opisywać segmenty użytkowników, np. ustawienia języka lub położenie geograficzne.

Analytics automatycznie rejestruje niektóre zdarzenia i właściwości użytkownika. Nie musisz dodawać żadnego kodu, aby je włączyć. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz skonfigurować do 25 różnych właściwości użytkownika Analytics i rejestrować do 500 różnych typów zdarzeń Analytics w aplikacji. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację.

Te dane są dostępne na stronach Statystyki w konsoli Firebase.

Na stronie Analytics > Zdarzenia znajdziesz raporty o zdarzeniach, które są automatycznie tworzone dla każdego typu zdarzenia Analytics zarejestrowanego przez aplikację. Dowiedz się więcej o panelu.

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 artykule [GA4] Polecane zdarzenia. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje, rejestruj sugerowane zdarzenia Analytics, które mają sens w przypadku Twojej aplikacji, oraz ich określone parametry. Dzięki temu możesz też korzystać z najnowszych funkcji Google Analytics, gdy tylko stają się dostępne.

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

Możesz od razu zacząć rejestrować zdarzenia za pomocą metody LogEvent().

W tym przykładzie rejestrowane są zdarzenia z różnymi typami argumentów:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Następne kroki