Unity için Google Analytics'i kullanmaya başlama

Platform seçin: iOS+ Android Web Flutter Unity C++


Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:

  • Etkinlikler: Kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğu.
  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özelliklerdir (ör. dil tercihi veya coğrafi konum).

Analytics, bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder. Bunları etkinleştirmek için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa 25'e kadar farklı Analytics kullanıcı özelliği ayarlayabilir ve uygulamanızda 500'e kadar farklı Analytics etkinlik türü kaydedebilirsiniz. Uygulamanızın kaydettiği toplam etkinlik hacmiyle ilgili bir sınır yoktur.

Bu verilere Firebase konsolunun Analytics sayfalarından erişebilirsiniz.

Analytics > Etkinlikler sayfasında, uygulamanız tarafından günlüğe kaydedilen her farklı Analytics olay günlüğü türü için otomatik olarak oluşturulan etkinlik raporları gösterilir. Kontrol paneli hakkında daha fazla bilgi edinin.

Başlamanıza yardımcı olmak için Analytics SDK'sı, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türleri arasında yaygın olan bir dizi önerilen etkinlik tanımlar. Bu etkinlikler ve ne zaman kullanılacakları hakkında daha fazla bilgi edinmek için Önerilen etkinlikler başlıklı makaleye bakın. Raporlarda maksimum düzeyde ayrıntı elde etmek için uygulamanız için anlamlı olan önerilen Analytics etkinlikleri ve bunların belirlenmiş parametrelerini günlüğe kaydedin. Bu sayede, kullanıma sunulan en yeni Google Analytics özelliklerinden de yararlanabilirsiniz.

Başlamadan önce

Google Analytics kullanmaya başlamak için şunları yapmanız gerekir:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz Firebase'i kullanıyorsa Firebase için zaten kayıtlı ve yapılandırılmış demektir.

    • Unity projeniz yoksa örnek uygulama indirebilirsiniz.

  • Firebase Unity SDK'sını (özellikle FirebaseAnalytics.unitypackage) Unity projenize ekleyin.

Unity projenize Firebase eklemek için hem Firebase konsolunda hem de açık Unity projenizde görevler gerçekleştirmeniz gerekir (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Unity projenize taşımanız gerekir).

Günlük etkinlikleri

LogEvent() yöntemini kullanarak etkinlikleri hemen günlüğe kaydetmeye başlayabilirsiniz.

Aşağıdaki örnekte, çeşitli bağımsız değişken türlerine sahip etkinlikler günlüğe kaydedilmektedir:

// 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);

Sonraki adımlar