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 Twojej aplikacji. Pakiet SDK rejestruje 2 główne typy informacji:

  • Zdarzenia: co dzieje się w Twojej 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 Analytics właściwości użytkownika i rejestrować w niej do 500 różnych Analytics zdarzeń typów. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację.

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

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

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 artykule Zalecane zdarzenia. Aby uzyskać jak najbardziej szczegółowe raporty, 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 Google Analytics funkcji, gdy tylko zostaną udostępnione.

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ć pakiet SDK Firebase Unity (w szczególności FirebaseAnalytics.unitypackage) do projektu w Unity.

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

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

Poniższy przykład rejestruje 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