Pierwsze kroki z Google Analytics dla Unity

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


Google Analytics zbiera dane o używaniu aplikacji i zachowaniach użytkowników. 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ć w niej do 25 różnych Analyticswłaściwości użytkownika i rejestrować do 500 różnych Analyticstypów zdarzeń. Nie ma limitu łącznej ilości zdarzeń rejestrowanych przez aplikację.

Dostęp do tych danych możesz uzyskać na stronach Analytics w konsoli Firebase.

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

Aby ułatwić Ci rozpoczęcie pracy, pakiet SDK Analyticsdefiniuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, podróży oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Polecane zdarzenia. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje, rejestruj sugerowane Analytics zdarzenia, które mają znaczenie w przypadku Twojej aplikacji, oraz ich określone parametry. Dzięki temu będziesz mieć też dostęp do najnowszych funkcjiGoogle Analytics, gdy tylko zostaną udostępnione.

Zanim zaczniesz

Zanim zaczniesz korzystać z Google Analytics, musisz:

  • Zarejestruj projekt Unity i skonfiguruj go tak, aby korzystał z Firebase.

    • Jeśli Twój projekt 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ć przykładową aplikację.

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

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

Zdarzenia z dziennika

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