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 sizin için bazı etkinlikleri otomatik olarak günlüğe kaydeder; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa, uygulamanıza 500 farklı türde Analytics etkinlik 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ı 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 kullanabilmek için:

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

  • Unity projeniz zaten Firebase kullanıyorsa 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.

Bu ilk kurulum görevleriyle ilgili 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üğe kaydedilen etkinlikler

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, perakende ve e-ticaret, seyahat ve oyun uygulamaları dahil olmak üzere farklı uygulama türlerinde yaygın olan 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 makalelerine bakın.

Not: Raporlarda maksimum ayrıntı düzeyine ulaşmak için uygulamanız açısından anlamlı olan önerilen Analytics etkinlikleri ve belirlenmiş parametrelerini günlüğe kaydedin. Bu sayede, kullanıma sunulan en yeni Google Analytics özelliklerden de yararlanabilirsiniz.

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

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

Aşağıdaki örnekte, önerilen bir SELECT_CONTENT etkinliğin 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, Analytics raporlarınızda 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 BigQuery'ye aktarılan verilere de dahil edilir.

• VALUE Parametresi: VALUE, bir Analytics Etkinliği ile ilgili önemli bir metriği biriktirmek için yararlı olan genel amaçlı bir parametredir. 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 kaydedebilirsiniz:

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

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

Android

Android Studio hata ayıklama günlüğünde ayrıntılı günlük kaydını etkinleştirerek etkinliklerin SDK tarafından düzgün şekilde kaydedildiğini doğrulayabilirsiniz. Bu, hem otomatik olarak hem de manuel olarak kaydedilen etkinlikleri içerir.

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.

iOS+

Etkinlikler konsola kaydedilir ve uygulama XCode üzerinden çalıştırılı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 simgesini seçin.

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