App Center Analytics (Unity)
Önemli
Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.
Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.
App Center Analytics, uygulamanızı geliştirmek için kullanıcı davranışını ve müşteri katılımını anlamanıza yardımcı olur. SDK, oturum sayısını ve model, işletim sistemi sürümü gibi cihaz özelliklerini otomatik olarak yakalar. Sizin için önemli olan şeyleri ölçmek için kendi özel olaylarınızı tanımlayabilirsiniz. Yakalanan tüm bilgileri App Center portalında kullanarak verileri analiz edebilirsiniz.
Uygulamanızda SDK'yı henüz ayarlamadıysanız Unity Kullanmaya Başlama bölümündeki yönergeleri izleyin.
Not
Aşağıda sunulan API'leri kullanmak için dosyanıza .cs
aşağıdaki using
deyimi eklemeniz gerekir:
using Microsoft.AppCenter.Unity.Analytics;
Ayrıca App Center oyun nesnenizin ayarlarında Analizi Kullan seçeneğinin işaretli olduğundan emin olmanız gerekir.
App Center Analytics'i ekleyip SDK'yı başlattıktan sonra, uygulamanızda ek kod gerektirmeden oturumları ve işletim sistemi sürümü, model vb. gibi cihaz özelliklerini otomatik olarak izler.
Uygulamanızda neler olduğunu öğrenmek, kullanıcı eylemlerini anlamak ve App Center portalında toplamaları görmek için 20'ye kadar özelliği olan kendi özel olaylarınızı izleyebilirsiniz.
Özelliklerini kullanarak TrackEvent()
olaylarınızı izlemek için yöntemini kullanın. En fazla 200 farklı olay adı gönderebilirsiniz. Olay adı başına en fazla 256 karakter, olay özellik adı ve değeri başına 125 karakter sınırı vardır.
Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
{ "Category", "Music" },
{ "FileName", "favorite.avi" }
});
Olayların özellikleri isteğe bağlıdır; yalnızca bir olayı izlemek istiyorsanız, bunun yerine şu örneği kullanın:
Analytics.TrackEvent("Video clicked");
Uyarı
Analytics.TrackEvent()
betiğindeki AppCenterBehavior.cs
yönteminden önce Awake()
çağrılırsa platformlar arasında tutarsız davranır. Güvende olmak için yalnızca uygulamanızdaki ilk sahne tüm betikleri uyandırdıktan sonra gönderilecek olaylara MonoBehaviour
güvenmeniz gerekir. Bir olayı başlatma işlemiyle MonoBehavour
birlikte izlemek için API'yi yerine betiğinizin Start()
yöntemine Awake()
eklemeyi göz önünde bulundurun.
App Center Analytics'i çalışma zamanında etkinleştirebilir ve devre dışı bırakabilirsiniz. Devre dışı bırakırsanız SDK, uygulama için analiz bilgilerini toplamayı durdurur. Analytics'i devre dışı bırakmak için parametre olarak geçirerek false
aşağıdaki API'yi kullanın.
Analytics.SetEnabledAsync(false);
App Center Analytics'i yeniden etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin true
.
Analytics.SetEnabledAsync(true);
Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı hale geldi.
Bu API zaman uyumsuzdur, hakkında daha fazla bilgiyi App Center Zaman Uyumsuz API'ler kılavuzumuzdan okuyabilirsiniz.
App Center Analytics'in etkinleştirilip etkinleştirilmediğini de de kontrol edebilirsiniz.
bool isEnabled = await Analytics.IsEnabledAsync();
Diğer olaylardan daha yüksek öneme sahip iş açısından kritik olayları izleyebilirsiniz.
Geliştiriciler olayların kalıcılığını Normal (Flags.PersistenceNormal
API'de) veya Kritik (Flags.PersistenceCritical
API'de) olarak ayarlayabilir.
Bir olayı Kritik olarak izlemek için aşağıdaki API'yi kullanabilirsiniz:
Analytics.TrackEvent("eventName", Flags.PersistenceCritical);
Özellikleri kullanıyorsanız:
Analytics.TrackEvent("eventName", new Dictionary<string, string> {
{ "Category", "Music" },
{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);
Olay iletimini duraklatmak, uygulamanın iş açısından daha kritik gereksinimler için ağ bant genişliğini denetlemesi gereken senaryolarda yararlı olabilir. Günlükleri App Center arka ucuna göndermeyi duraklatabilirsiniz. Duraklatıldığında, olaylar yine izlenip kaydedilebilir, ancak hemen gönderilmez. Uygulamanızın duraklatılırken izlediği tüm olaylar yalnızca çağrısı Analytics.Resume
yaptığınızda gönderilir.
Analytics.Pause();
Analytics.Resume();
Bu API zaman uyumsuzdur, hakkında daha fazla bilgiyi App Center Zaman Uyumsuz API'ler kılavuzumuzdan okuyabilirsiniz.
Varsayılan olarak, oturum kimliği uygulamanın yaşam döngüsüne bağlıdır. Yeni oturumun başlangıcını el ile denetlemek istiyorsanız, sonraki adımları izleyin:
Not
Analytics.StartSession() API'sinin her çağrısının yeni bir oturum oluşturacağını dikkate alın. El ile oturum izleyici modunda bu API çağrılmazsa, tüm gönderen günlükler null oturum değerine sahip olur.
Not
Yeni bir uygulama başlatıldıktan sonra oturum kimliğinin yeniden oluşturulacağını dikkate alın.
- AppCenterBehavior ekli oyun nesnesinin Analiz bölümündeki El ile Oturum İzleyicisini Etkinleştir onay kutusunun işaretini kaldırın.
- Ardından API'yi
StartSession
aşağıdakindenAppCenter.Start
sonra kullanabilirsiniz:
Analytics.StartSession();
Varsayılan olarak SDK, depolama alanında en fazla 10 MB günlük depolar.
Ağ bağlantısı olmadığında SDK, yerel depolama alanına en fazla 10 MB günlük kaydeder. Depolama alanı dolduktan sonra SDK, yeni günlüklere yer açmak için eski günlükleri atmaya başlar. Cihaz İnternet erişimini geri aldıktan sonra SDK günlükleri 50 veya her 6 saniyede bir toplu iş olarak gönderir.
App Center SDK'sı günlükleri 50 toplu iş olarak karşıya yükler ve SDK'da gönderilecek 50 günlük yoksa, 6 saniye sonra günlükleri göndermeye devam eder. Paralel olarak gönderilen en fazla üç toplu iş olabilir.
App Center SDK kurtarılabilir ağ hatalarında geri alma yeniden denemelerini destekler. Yeniden deneme mantığı aşağıda verilmiştir:
- İstek başına en fazla 3 deneme.
- Her isteğin kendi yeniden deneme durum makinesi vardır.
- Bir istek tüm yeniden denemelerini tükettiğinde tüm iletim kanalları devre dışı bırakılır (bir sonraki uygulama işlemine kadar).
Geri kapatma mantığı
- %50 rastgelelik, ilk olarak 5 ile 10 arasında yeniden deneme, ikinci yeniden deneme 2,5 ile 5 dakika arasında, son deneme 10 ile 20 dakika arasında.
- Ağ kapalıyken açıksa (veya wi-fi'den mobil ağa), yeniden deneme durumları sıfırlanır ve istekler hemen yeniden denenır.