App Center Analizi (Android)

  • Makale
  • Okumak için 2 dakika

App Center Analytics, uygulamanızı geliştirmek için Kullanıcı davranışını ve müşteri etkileşimini 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 işlemleri ölçmek üzere kendi özel olaylarınızı tanımlayabilirsiniz. Yakalanan tüm bilgiler, verileri analiz etmeniz için App Center portalında kullanılabilir.

Uygulamanızda SDK 'Yı henüz ayarlamadıysanız SDK Başlarken bölümünü izleyin.

Oturum ve cihaz bilgileri

Uygulamanıza App Center Analizi ekleyip SDK 'yı başlattığınızda, hiçbir ek kod yazmadan işletim sistemi sürümü, model vb. gibi oturumları ve cihaz özelliklerini otomatik olarak izler.

Özel olaylar

Kullanıcılarınız ve uygulamalar arasındaki etkileşimi anlamak için, en fazla 20 Özellik ile kendi özel olaylarınızı izleyebilirsiniz.

SDK 'Yı başlattığınızda, trackEvent() olaylarınızı özelliklerle izlemek için yöntemini kullanın. En fazla 200 ayrı olay adı gönderebilirsiniz. Ayrıca, en fazla karakter sınırı vardır:

  • başına 256 karakter event name .
  • başına 125 karakter event property name & event property value .
Map<String, String> properties = new HashMap<>();
properties.put("Category", "Music");
properties.put("FileName", "favorite.avi");

Analytics.trackEvent("Video clicked", properties);

val properties = hashMapOf("Category" to "Music", "FileName" to "favorite.avi")
Analytics.trackEvent("Video clicked", properties)

Olaylara yönelik özellikler tamamen isteğe bağlıdır; yalnızca bir olayı izlemek istiyorsanız, bunun yerine bu örneği kullanın:

Analytics.trackEvent("Video clicked");

Analytics.trackEvent("Video clicked")

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

Diğer olaylardan daha yüksek önem taşıyan iş açısından önemli olayları izleyebilirsiniz.

  • Geliştiriciler olayların önceliğini normal ( Flags.NORMAL API 'de) veya kritik ( Flags.CRITICAL API 'de) olarak ayarlayabilir.
  • Önem derecesi kritik olarak ayarlanan olaylar, önce depolamadan alınır ve normal olaylardan önce gönderilir.
  • Yerel depolama alanı dolu olduğunda ve yeni olayların depolanması gerekdiğinde, önce en düşük önceliğe sahip en eski olaylar silinir.
  • Depolama kritik önceliğe sahip günlüklerle dolu ise, SDK bu durumda yer alamayaya sahip olduğu için Normal önceliğe sahip bir olayı izleme başarısız olur.
  • Kilitlenmeler hizmetini de kullanıyorsanız, kilitlenme günlükleri Kritik olarak ayarlanır ve olaylarla aynı depolama alanını paylaşır.
  • İletim aralığı yalnızca Normal olaylara uygulanır, Kritik olaylar 3 saniye sonra gönderilir.

Bir olayı Kritik olarak izlemek için aşağıdaki API'yi kullanabilirsiniz:

Map<String, String> properties = new HashMap<>();
properties.put("Category", "Music");
properties.put("FileName", "favorite.avi");

Analytics.trackEvent("eventName", properties, Flags.CRITICAL);

// If you're using name only, you can pass null as properties.

val properties = hashMapOf("Category" to "Music", "FileName" to "favorite.avi")
Analytics.trackEvent("Video clicked", properties, Flags.CRITICAL)

// If you're using name only, you can pass null as properties.

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

Olay iletimini duraklatma, uygulamanın daha iş açısından kritik ihtiyaçlar için ağ bant genişliğini denetlemesi gereken senaryolarda yararlı olabilir. Günlüklerin arka end'e gönderilmesini App Center durdurebilirsiniz. Duraklatılırken olaylar yine de izlenilebilir ve kaydedilebilir, ancak hemen gönderilmez. Duraklatılmış durumdayken uygulamanıza gönderilen tüm olaylar yalnızca çağrısı yapılan bir kez resume gönderilir.

Analytics.pause();
Analytics.resume();

Analytics.pause()
Analytics.resume()

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

Çalışma zamanında App Center Analytics'i etkinleştirebilirsiniz ve devre dışı ağlayabilirsiniz. Bunu devre dışı bıraksanız, SDK uygulama için daha fazla analiz bilgisi toplamaz.

Analytics.setEnabled(false);

Analytics.setEnabled(false)

App Center Analytics'i yeniden etkinleştirmek için aynı API'yi kullanın ancak true parametre olarak geçişin.

Analytics.setEnabled(true);

Analytics.setEnabled(true)

Durum, uygulama başlatan tüm cihaz depolamalarında kalıcıdır.

Bu API zaman uyumsuz bir işlemdir, bu konuda daha fazla bilgi için App Center API'ler kılavuzumuza bakabilirsiniz.

Not

Bu yöntem yalnızca başlatıldıktan Analytics sonra kullanılmalıdır.

App Center Analytics'in etkinleştirildikten sonra

Ayrıca Analytics'in etkin App Center olmadığını da kontrol edin.

Analytics.isEnabled();

Analytics.isEnabled()

Bu API zaman uyumsuz bir işlemdir, bu konuda daha fazla bilgi için App Center API'ler kılavuzumuza bakabilirsiniz.

Not

Bu yöntem yalnızca başlatıldıktan Analytics sonra kullanılmalıdır, her zaman başlamadan false önce geri döner.

Yerel depolama boyutu

Varsayılan olarak SDK, tüm olay günlüklerini 10 MB 'a kadar depolar. Geliştiriciler depolama boyutunu artırmak IÇIN bir API kullanabilir ve depolama alanı dolu olana kadar SDK günlükleri depolamaya devam eder.

İnternet erişimi yok

Ağ bağlantısı olmadığında, SDK yerel depolamada 10 MB 'a kadar günlüğü kaydeder. Depolama alanı dolduğunda, SDK yeni Günlükler için yer açmak üzere eski günlükleri atmaya başlar. Ağ bağlantısı döndüğünde SDK, günlükleri 50 toplu işinde veya her 3 saniyede bir (varsayılan olarak) gönderir.

Not

25 günden eski olan Günlükler arka uç tarafından kabul edilmez.

Olay günlüklerini toplu işleme

App Center SDK, günlükleri bir 50 toplu karşıya yükler ve SDK 'nın gönderilmek üzere 50 günlüğü yoksa, günlükleri yine de 3 saniye sonra gönderir (varsayılan olarak). Paralel olarak en fazla üç toplu işlem gönderilebilir. İletim aralığı değiştirilebilir:

// Change transmission interval to 10 minutes.
Analytics.setTransmissionInterval(600);

// Change transmission interval to 10 minutes.
Analytics.setTransmissionInterval(600)

İletim aralığı değeri 3 saniye ile 86400 saniye (bir gün) arasında olmalıdır ve hizmet başlatılmadan önce bu yöntemin çağrılması gerekir.

Yeniden deneme ve geri dönme mantığı

App Center SDK, kurtarılabilir ağ hatalarında yeniden denemeleri destekler. Yeniden deneme mantığı aşağıda verilmiştir:

  • 3 istek başına en fazla dener.
  • Her isteğin kendi yeniden deneme durumu makinesi vardır.
  • Tüm iletim kanalları, bir istek tüm yeniden denemelerini tüketdikten sonra devre dışı bırakılır (sonraki uygulama işlemine kadar).

Geri dönüş mantığı

  • %50 rastgele seçme, 5 ve 10 saniye arasında ilk kez deneme yapın, sonraki 2,5 ila 5 dakika arasında deneyin, son olarak 10 ila 20 dakika sürer.
  • Ağ kapalıdan açık (veya wi-fi'den mobile) geçiş olursa, yeniden deneme durumları sıfırlanır ve istekler hemen yeniden denenır.