App Center Analytics (Apache Cordova)

Ö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.

Not

Cordova Uygulamaları desteği Nisan 2022'de sona erdi. App Center blogunda daha fazla bilgi bulabilirsiniz.

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 Başlarken bölümünü izleyin.

Oturum ve cihaz bilgileri

App Center Analytics'i uygulamanıza eklediğinizde ve SDK başlatıldıktan sonra oturumları ve işletim sistemi sürümü, model gibi cihaz özelliklerini otomatik olarak izler.

Özel olaylar

Kullanıcılarınızla uygulama arasındaki etkileşimi anlamak için en fazla 20 özelliğe sahip kendi özel olaylarınızı izleyebilirsiniz.

SDK'yı başlattıktan sonra, özelliklerini kullanarak olaylarınızı izlemek için yöntemini kullanın trackEvent . En fazla 200 ayrı olay adı gönderebilirsiniz. Ayrıca, olay adı başına en fazla 256 karakter, olay özelliği adı ve olay özelliği değeri başına 125 karakter üst sınırı vardır.

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}
AppCenter.Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, success, error);

Bu işlev, başarı geri çağırması olarak üçüncü parametreyi kullanır ve bu da hata döndüren hata geri çağırması olarak boş bir dize ve dördüncü parametreyi döndürür.

Olayların özellikleri tamamen isteğe bağlıdır. Yalnızca bir olayı izlemek istiyorsanız, bunun yerine şu örneği kullanın:

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.trackEvent('Video clicked', success, error);

Ç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 artık uygulama için analiz bilgilerini toplamaz.

var success = function() {
    console.log("Analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(false, success, error);

Bu işlev, başarı geri çağırması olarak ikinci parametreyi kullanır ve bu da boş bir dizeyi ve hata döndüren hata geri çağırması olarak üçüncü parametreyi döndürür. App Center Analytics'i yeniden etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin true .

var success = function() {
    console.log("Analytics enabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı hale getirilir.

App Center Analytics'in etkinleştirilip etkinleştirilmediğini denetleyin

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

var success = function(result) {
    console.log("analytics " + (result) ? "enabled" : "disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.isEnabled(success, error);

Bu işlev, hata döndüren hata geri çağırma olarak bir boolean ve ikinci parametreyi döndüren başarılı geri çağırma olarak ilk parametreyi kullanır.

JS'nin App Center Analytics'i etkinleştirmesini bekleyin

Bazı durumlarda, bir uygulama kullanıcılara analiz bilgilerini paylaşmak isteyip istemediğini sormak isteyebilir. Bu durumda, tercihinizi APPCENTER_ANALYTICS_ENABLE_IN_JStrueconfig.xml

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

Başka bir deyişle, App Center'a tüm bilgilerin (hatta temel oturum bilgileri) gönderilmesi için geliştiricinin önce koduna aşağıdaki satırı ekleyerek uygulama içinde App Center Analytics'i etkinleştirmesi gerekir.

var success = function() {
    console.log("analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

Yerel depolama boyutu

Varsayılan olarak SDK, depolama alanında en fazla 10 MB günlük depolar.

İ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 3 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önderilecek 50 günlüğü yoksa, günlükleri 3 saniye sonra göndermeye devam eder. Paralel olarak gönderilen en fazla üç toplu iş olabilir.

Yeniden deneme ve geri kapatma mantığı

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 (sonraki uygulama işlemine kadar).

Geri kapatma mantığı

  • %50 rastgelelik, ilk olarak 5'ler ve 10'lar arasında yeniden deneme, ikinci yeniden deneme 2,5 ile 5 dakika arasında, son deneme 10 ile 20 dakika arasında.
  • Ağ kapalıdan açık (veya wi-fi'den mobil ağa) geçerse yeniden deneme durumları sıfırlanır ve istekler hemen yeniden denenır.