Aracılığıyla paylaş

App Center Analytics (Unity)

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. 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.

Uyarı

Aşağıda sunulan API'leri kullanmak için dosyanıza using aşağıdaki .cs deyimi eklemeniz gerekir:

using Microsoft.AppCenter.Unity.Analytics;

Ayrıca App Center oyun nesnenizin ayarlarında Analiz Kullan seçeneğinin işaretli olduğundan da emin olmanız gerekir.

Oturum ve cihaz bilgileri

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.

Özel olaylar

Uygulamanızda neler olduğunu öğrenmek, kullanıcı eylemlerini anlamak ve App Center portalında toplamaları görmek için 20'ye kadar özelliğe sahip kendi özel olaylarınızı izleyebilirsiniz.

TrackEvent() yöntemini, olaylarınızı özelliklerle izlemek için kullanın. En fazla 200 ayrı 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() yöntemi Awake() betiğinde AppCenterBehavior.cs yönteminden önce çağrılırsa platformlar arasında tutarsız davranır. İşinizi garantiye almak için, yalnızca uygulamanızdaki ilk sahne tüm MonoBehaviour betikleri uyandırdıktan sonra gönderilecek olan olaylara dayanmanız gerekir. Olayı bir MonoBehavour'nin başlatılmasıyla birlikte izlemek için, API'yi betiğinizin Start() yöntemine eklemeyi Awake()yerine göz önünde bulundurun.

Çalışma zamanında App Center Analytics'i etkinleştirme veya devre dışı bırakma

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ı olur.

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 denetleyin

App Center Analytics'in etkinleştirilip etkinleştirilmediğini de de kontrol edebilirsiniz.

bool isEnabled = await Analytics.IsEnabledAsync();

Olay önceliği ve kalıcılığı

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, aşağıdaki adımları izleyin:

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Günlükleri göndermeyi duraklatma ve sürdürme

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 planına göndermeyi duraklatabilirsiniz. Duraklatıldığında, olaylar yine de izlenebilir ve kaydedilebilir, ancak hemen gönderilmez. Uygulamanız duraklatıldığında izlenen tüm olaylar, yalnızca Analytics.Resume çağrıldığında gönderilir.

Analytics.Pause();
Analytics.Resume();

Bu API zaman uyumsuzdur, hakkında daha fazla bilgiyi App Center Zaman Uyumsuz API'ler kılavuzumuzdan okuyabilirsiniz.

Başlangıç oturumlarını yönetme

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:

Uyarı

Analytics.StartSession() API'sinin her çağrısının yeni bir oturum oluşturacağını dikkate alın. El ile oturum takip modu etkinken bu API çağrılmazsa, tüm gönderim günlüklerinin oturum değeri null olur.

Uyarı

Yeni bir uygulama başlatıldıktan sonra oturum kimliğinin yeniden oluşturulacağını dikkate alın.

  • AppCenterBehavior'ın ekli olduğu oyun nesnesinin Analiz bölümünün altındaki El ile Oturum İzleyicisini Etkinleştir onay kutusunun işaretini kaldırın.
  • Ardından, StartSession API'yi AppCenter.Start sonra kullanabilirsiniz.
Analytics.StartSession();

Yerel depolama boyutu

SDK, varsayılan olarak, depolama alanında en fazla 10 MB log saklar.

İnternet erişimi yok

Ağ bağlantısı olmadığında SDK, yerel depolama alanına 10 MB'a kadar 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 toplu iş olarak veya her 6 saniyede bir gönderir.

Olay günlüklerini toplu iş oluşturma

App Center SDK'sı günlükleri 50 toplu iş olarak karşıya yükler ve SDK'nın göndereceği 50 günlük yoksa, 6 saniye sonra günlükleri göndermeye devam eder. Paralel olarak gönderilen en fazla üç toplu iş olabilir.

Yeniden deneme ve geri kapatma mantığı

App Center SDK'sı 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 bir isteğin kendi yeniden deneme durum yapısı vardır.
  • Bir istek tüm yeniden denemelerini tükettiğinde tüm iletim kanalları devre dışı bırakılır (sonraki uygulama işlemine kadar).

Geri çekilme mantığı

  • Başlangıçta 50% rastgeleleme, ardından ilk yeniden deneme 5 saniye ile 10 saniye arasında, ikinci yeniden deneme 2,5 ile 5 dakika arasında ve son deneme 10 ile 20 dakika arasında yapılır.
  • Ağ kapalıdan açığa (veya wi-fi'dan mobil ağa) geçerse, yeniden deneme durumları sıfırlanır ve istekler hemen yeniden denenir.
  • Last updated on