App Center Analytics (React Native)

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

• Android
• iOS
• React Native
• Windows
• MAUI/Xamarin
• Unity
• macOS
• tvOS
• Cordova

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 vb. 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ı izleyin.

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.

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

Bu işlev bir promise döndürür, başarı durumu boş bir dize döndürür ve hata durumu da hatayı döndürür.

Olayların özellikleri isteğe bağlıdır; Yalnızca bir olayı izlemek istiyorsanız, bunun yerine şunu kullanın:

Analytics.trackEvent('Video clicked');

Ç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 daha fazla analiz bilgisi toplamaz.

await Analytics.setEnabled(false);

Bu işlev, void olarak çözümlenebilen bir promise döndürür.

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

await Analytics.setEnabled(true);

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 kontrol edebilirsiniz.

const enabled = await Analytics.isEnabled();

Bu işlev, için çözümleyen bir booleanpromise döndürür.

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

Uygulama kullanıcılarınız için analiz bilgilerini toplamak ancak önce kullanıcı izni almak istiyorsanız, başlangıçta analizi etkinleştirmeme, doğru zamana kadar bekleme ve javascript'te etkinleştirme seçeneğiniz vardır.

1. Projenin ios/YourAppName/AppDelegate.m dosyasını açın ve değerini ile [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];değiştirin[AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true];.
2. Projenin android/app/src/main/res/values/strings.xml dosyasını açın ve değerini ile <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>değiştirin<string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string>.

Başka bir deyişle, App Center'a gönderilecek tüm bilgiler (hatta temel oturum bilgileri) için önce aşağıdaki kod satırını ekleyerek App Center Analytics'i etkinleştirmeniz gerekir:

await Analytics.setEnabled(true);

Başlatma 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:

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.

SDK'yı izleme oturumunu el ile yapılandırmak için yerel Analiz API'lerini enableManualSessionTracker kullanmanız gerekir:

• iOS'ta, içinde uygulamanın didFinishLaunchingWithOptions temsilci yönteminden önce [AppCenterReactNative register]; öğesini çağırınAppDelegate.m[MSACAnalytics enableManualSessionTracker];. Bu dosyada eksikse ekleyin @import AppCenterAnalytics .

• Android'de, içinde yönteminde onCreate önce SoLoader.init çağrısında Analytics.enableManualSessionTracker(); bulunurMainApplication.java. Bu dosyada eksikse içeri aktarma com.microsoft.appcenter.analytics.Analytics ekleyin.

Ardından API'yi startSession React Native projenizde kullanabilirsiniz:

Analytics.startSession();

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