Pierwsze kroki z Google Analytics dla Unity

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 aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika:atrybuty służące do opisywania segmentów Twoich użytkowników, np. ich ustawień języka lub położenia geograficznego.

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ć maksymalnie 25 różnych właściwości użytkownika Analytics i rejestrować maksymalnie 500 różnych typów zdarzeń Analytics. Łączna liczba zdarzeń rejestrowanych przez aplikację nie jest ograniczona.

Aby uzyskać dostęp do tych danych:

  1. W konsoli Firebase otwórz projekt.
  2. W menu kliknij Analytics, aby wyświetlić panel raportowania Analytics.

Na karcie Zdarzenia znajdziesz raporty o zdarzeniach tworzone automatycznie dla każdego rodzaju zdarzenia Analytics zarejestrowanego przez Twoją aplikację. Więcej informacji o panelu.

Aby ułatwić Ci rozpoczęcie korzystania z pakietu SDK, Analytics definiuje on kilka zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do zakupów i e-commerce, aplikacji podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy warto ich używać, znajdziesz w artykule [GA4] Zdarzenia rekomendowane. 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 się pojawią.

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 w 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ć próbną aplikację.

  • Dodaj pakiet SDK Firebase Unity (szczególnie plik FirebaseAnalytics.unitypackage) do projektu Unity.

Pamiętaj, że dodanie Firebase do projektu Unity wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie Unity (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu Unity).

Zdarzenia z dziennika

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

W tym przykładzie zdarzenia są rejestrowane 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