Etkinlikleri günlüğe kaydetme

Uygulamanızda neler olduğuna dair analizler sağlayan etkinlikler. Örnek olarak, kullanıcı işlemleri, sistem etkinlikleri veya hatalar gösterilebilir.

Google Analytics bazı etkinlikleri sizin için otomatik olarak kaydeder. Bu etkinlikleri almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa uygulamanıza 500 farklı türde Analytics etkinliği kaydedebilirsiniz. Uygulamanızın kaydettiği etkinliklerin toplam hacminin sınırı yoktur. Etkinlik adlarının büyük/küçük harfe duyarlı olduğunu ve adları arasında büyük/küçük harf kullanımı dışında bir fark olmayan iki etkinliğin kaydedilmesinin iki ayrı etkinliğe 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 projeniz zaten Firebase kullanıyorsa Firebase için 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.

Bu ilk kurulum görevleri için ayrıntılı talimatları Firebase'i Unity projenize ekleme başlıklı makalede bulabilirsiniz.

Firebase'i Unity projenize eklemenin hem Firebase konsolunda 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öntemiyle etkinlikleri günlüğe kaydetmek için kullanabilirsiniz.

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 çeşitli önerilen etkinlikler 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 makalelerine bakın.

Not: Raporlarda maksimum düzeyde ayrıntı elde etmek için uygulamanız için anlamlı olan önerilen Analytics etkinlikleri ve bunların belirtilen parametrelerini günlüğe kaydedin. Bu sayede, kullanıma sunulan en yeni Google Analytics özelliklerinden de yararlanabilirsiniz.

Önerilen etkinliklerin uygulama ayrıntılarını aşağıdaki konumlarda bulabilirsiniz:

• Önerilen etkinlikler: Event sabitlerinin listesine bakın.
• Önerilen 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)
);

Önerilen parametrelere ek olarak, tüm etkinliklere aşağıdaki parametreleri ekleyebilirsiniz:

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

• VALUE Parametresi: VALUE, Analytics Etkinliği ile ilgili önemli bir metriği toplamak için yararlı olan genel amaçlı bir parametredir. Gelir, mesafe, süre ve puanlar buna örnek verilebilir.

Uygulamanızda, önerilen bir Analytics etkinlik türü tarafından karşılanmayan 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 çıkışında etkinlikleri görüntüleme

Android

Etkinliklerin SDK tarafından doğru şekilde günlüğe kaydedildiğini doğrulamak için Android Studio hata ayıklama günlüğünde ayrıntılı günlük kaydını etkinleştirebilirsiniz. Hem otomatik olarak hem de manuel olarak günlüğe kaydedilen etkinlikler bu kapsamdadır.

Ayrıntılı günlük kaydını bir dizi adb komutuyla 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, etkinliklerinizi Android Studio logcat'te gösterir. Böylece, etkinliklerin gönderildiğini hemen doğrulayabilirsiniz.

iOS+

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

Kontrol panelinde analiz etkinliklerini görüntüleme

Analytics etkinliklerinizle ilgili toplu istatistikleri Firebase konsolu kontrol panellerinde görüntüleyebilirsiniz. Bu gösterge tabloları gün içinde düzenli aralıklarla güncellenir. Anında test etmek için, logcat çıkışlarını önceki bölümde açıklandığı şekilde kullanın.

Firebase konsolunda bu verilere erişmek için:

1. Firebase konsolunda projenizi açın.
2. Analytics raporlama kontrol panelini görüntülemek için menüden Analytics'i seçin.

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