Etkinlikleri günlüğe kaydetme

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


Etkinlikler, uygulamanızda neler olduğuna (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar) dair bilgi verir.

Google Analytics sizin için bazı etkinlikleri otomatik olarak günlüğe kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veriler toplaması gerekiyorsa uygulamanızda 500'e kadar farklı Analyticsetkinlik türünü günlüğe kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği etkinliklerin toplam hacmiyle ilgili bir sınır yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları yalnızca büyük/küçük harf kullanımı bakımından farklı iki etkinliğin kaydedilmesinin, iki ayrı etkinliğin kaydedilmesine neden olacağını unutmayın.

Başlamadan önce

Google Analytics özelliğini kullanabilmek için:

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

    • Unity projenizde Firebase kullanılıyorsa proje Firebase için kaydedilmiş ve yapılandırılmış demektir.

    • Unity projeniz yoksa örnek bir uygulama indirebilirsiniz.

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

Firebase'i Unity projenize eklemenin hem Firebase konsolda hem de açık Unity projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Unity projenize taşırsınız).

Günlük etkinlikleri

Firebase.Analytics.FirebaseAnalytics modülünü başlattıktan sonra, LogEvent() yöntemini kullanarak etkinlikleri günlüğe kaydetmek için bu modülü kullanabilirsiniz.

Başlamanıza yardımcı olmak için Analytics SDK, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türlerinde yaygın olarak kullanılan bir dizi önerilen etkinlik tanımlar. Bu etkinlikler ve ne zaman kullanılacakları hakkında daha fazla bilgi edinmek için Google Analytics Yardım Merkezi'ndeki Önerilen etkinlikler başlıklı makalelere bakın.

Önerilen etkinliklerle ilgili uygulama ayrıntılarını aşağıdaki yerlerde bulabilirsiniz:

  • Önerilen etkinlikler: Event sabitlerinin listesine bakın.
  • Belirlenen parametreler: Parameters sabitlerinin listesine bakın.

Aşağıdaki örnekte, önerilen bir SELECT_CONTENT etkinliğinin nasıl kaydedileceği gösterilmektedir:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

Belirlenen parametrelere ek olarak, aşağıdaki parametreleri herhangi bir etkinliğe ekleyebilirsiniz:

  • Özel parametreler: Özel parametreler raporlarınızda Analytics doğrudan gösterilmez ancak her rapora uygulanabilen kitle tanımlarında filtre olarak kullanılabilir. Uygulamanız bir BigQuery projesine bağlıysa özel parametreler de BigQuery'ye aktarılan verilere dahil edilir.

  • VALUE Parametre: VALUE, bir parametre olup Analytics etkinliğiyle ilgili önemli bir metriği biriktirmek için kullanılır. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

Uygulamanızın, önerilen bir Analytics etkinlik türü kapsamına girmeyen belirli ihtiyaçları varsa bu örnekte gösterildiği gibi kendi özel Analytics etkinliklerinizi günlüğe kaydedebilirsiniz:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Günlük çıktısındaki etkinlikleri görüntüleme

iOS+

Etkinlikler konsola kaydedilir ve uygulama XCode üzerinden çalıştırılırken görüntülenebilir.

Android

Android Studio hata ayıklama günlüğünde ayrıntılı günlüğü etkinleştirerek etkinliklerin SDK tarafından düzgün şekilde günlüğe kaydedildiğini doğrulayabilirsiniz. Otomatik olarak ve manuel olarak kaydedilen etkinlikler de buna dahildir.

Bir dizi adb komutuyla ayrıntılı günlük kaydını etkinleştirebilirsiniz:

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

Bu komut, etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olarak etkinliklerinizi Android Studio logcat'te gösterir.

Kontrol panelinde Analytics etkinliklerini görüntüleme

Firebase konsolunda, etkinliklerinizle ilgili toplu istatistikleri Analytics > Etkinlikler kontrol panelinde görüntüleyebilirsiniz.

Bu kontrol paneliyle ilgili aşağıdaki noktaları göz önünde bulundurun:

  • Kontrol panelinde, uygulamanız tarafından kaydedilen her farklı etkinlik türü için otomatik olarak oluşturulan etkinlik raporları gösterilir.

  • Kontrol paneli gün boyunca düzenli aralıklarla güncellenir. Anında test için bu kılavuzun önceki bölümünde açıklandığı gibi Xcode hata ayıklama konsolunu veya logcat çıkışını kullanın.

Kontrol paneli hakkında daha fazla bilgi edinin.