Etkinlikleri günlüğe kaydetme

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


Etkinlikler; kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olup bittiğine dair analizler sağlar.

Google Analytics, bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder. Bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa uygulamanızda 500'e kadar farklı Analytics etkinlik türünü günlüğe kaydedebilirsiniz. Uygulamanızın günlüğe kaydettiği toplam etkinlik 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 farklı etkinliğe neden olacağını unutmayın.

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

Firebase.Analytics.FirebaseAnalytics modülünü başlattıktan sonra LogEvent() yöntemini kullanarak etkinlikleri günlüğe kaydedebilirsiniz.

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 Google Analytics Yardım Merkezi'ndeki Önerilen etkinlikler makalelerine bakın.

Önerilen etkinliklerin uygulama ayrıntılarını aşağıdaki konumlarda 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 günlüğe 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, herhangi bir etkinliğe aşağıdaki parametreleri ekleyebilirsiniz:

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

  • VALUE Parametresi: VALUE, bir Analytics etkinlikle ilgili önemli bir metriği toplamak için kullanışlı olan genel amaçlı bir parametredir. Gelir, mesafe, zaman ve puanlar buna örnek verilebilir.

Uygulamanızın, önerilen bir Analytics etkinlik türü tarafından karşılanmayan özel ihtiyaçları varsa kendi özel Analytics etkinliklerinizi bu örnekte gösterildiği gibi günlüğe kaydedebilirsiniz:

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

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

iOS+

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

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 hem de manuel olarak günlüğe kaydedilen etkinlikler buna dahildir.

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östererek etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Kontrol panelinde analiz etkinliklerini görüntüleme

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

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

  • Kontrol panelinde, uygulamanız tarafından günlüğe 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 etmek 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.