App Center Analytics (iOS)
Ö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.
Not
SIM kartı olmayan iOS cihazları, taşıyıcı ülke kodu içeren raporu App Center portalına göndermez. Ülke değeri sağlamak istiyorsanız, cihazınızın konumundan setCountryCode
ülke kodunu geçersiz kılmak için yöntemini kullanın.
Not
4.0.0
App Center sürümünde hataya neden olan değişiklikler kullanıma sunulmuştur. App Center'ı önceki sürümlerden geçirmek için App Center SDK 4.0.0 ve üzeri sürümlere geçiş bölümünü izleyin.
Uygulamanızda SDK'yı henüz ayarlamadıysanız Başlarken bölümünü izleyin.
Uygulamanıza App Center Analytics'i ekleyip SDK'yı başlattıktan sonra, ek kod olmadan işletim sistemi sürümü, model vb. dahil olmak üzere oturumları ve cihaz özelliklerini otomatik olarak izler.
Not
Mac Catalyst uygulamalarında oturum miktarı iOS uygulamalarından daha düşük olabilir. Mac Catalyst'te oturumları izlemek için kullanılan yaşam döngüsü olayları, iOS'ta olanlardan farklı davranır.
Cihazda mobil veri modem ve SIM kart yüklüyse SDK kullanıcının ülke kodunu otomatik olarak bildirir. Yalnızca WiFi kullanan cihazlar varsayılan olarak ülke kodunu bildirmez. Bu kullanıcıların ülke kodunu ayarlamak için, kullanıcınızın konumunu kendiniz almanız ve SDK'daki yöntemini kullanmanız setCountryCode:
gerekir. Kullanıcı konumlarını izleme ve düşük konum çözünürlüğü kullanma konusunda dikkatli olmanız önerilir. Aşağıdaki örnekte kullanılır kCLLocationAccuracyKilometer
.
- Cihazda Konum Hizmetleri'ni etkinleştirdiğinizden emin olun.
- kullanarak
CLLocationManager
cihazın geçerli konumunu alın. - kullanarak
CLGeocoder
konumu ISO ülke koduna dönüştürün. - SDK'nın
setCountryCode
yöntemini kullanarak taşıyıcı ülke kodunu geçersiz kılın.
Cihazın konumunu almak ve uygulamadaki taşıyıcı ülke kodunu geçersiz kılmak için aşağıdaki kodu kullanın:
CLLocationManagerDelegate protokolünü AppDelegate'e ekleyin ve locationManager özelliğini ekleyin:
@interface AppDelegate () <CLLocationManagerDelegate>
@property(nonatomic) CLLocationManager *locationManager;
@end
class AppDelegate: CLLocationManagerDelegate {
private var locationManager: CLLocationManager = CLLocationManager()
}
didFinishLaunchingWithOptions: yönteminde konum yöneticisini ayarlama:
self.locationManager = [[CLLocationManager alloc] init];
self.locationManager.delegate = self;
self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer;
[self.locationManager requestWhenInUseAuthorization];
self.locationManager.delegate = self
self.locationManager.desiredAccuracy = kCLLocationAccuracyKilometer
self.locationManager.requestWhenInUseAuthorization()
Not
requestWhenInUseAuthorization
yöntemi macOS için kullanılamıyor. macOS için geliştirme yaparken bu yönteme yapılan çağrıları kaldırın.
Temsilci yöntemlerini ekleyin:
- (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status {
if (status == kCLAuthorizationStatusAuthorizedWhenInUse) {
[manager requestLocation];
}
}
- (void)locationManger:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations {
CLLocation *location = [locations lastObject];
CLGeocoder *geocoder = [[CLGeocoder alloc] init];
[geocoder reverseGeocodeLocation:location
completionHandler:^(NSArray *placemarks, NSError *error) {
if (placemarks.count == 0 || error)
return;
CLPlacemark *pm = [placemarks firstObject];
[MSACAppCenter setCountryCode:pm.ISOcountryCode];
}]
}
- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error {
NSLog(@"Failed to find user's location: \(error.localizedDescription)");
}
func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
if (status == kCLAuthorizationStatusAuthorizedWhenInUse) {
manager.requestLocation()
}
}
func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
let userLocation:CLLocation = locations[0] as CLLocation
CLGeocoder().reverseGeocodeLocation(userLocation) { (placemarks, error) in
if error == nil {
AppCenter.countryCode = placemarks?.first?.isoCountryCode
}
}
}
func locationManager(_ Manager: CLLocationManager, didFailWithError error: Error) {
print("Failed to find user's location: \(error.localizedDescription)")
}
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.
SDK'yı başlattıktan sonra, olaylarınızı özelliklerle izlemek için yöntemini kullanın trackEvent:withProperties
. En fazla 200 farklı olay adı gönderebilirsiniz. Ayrıca, olay adı başına en fazla 256 karakter, olay özellik adı ve olay özelliği değeri başına 125 karakter sınırı vardır.
NSDictionary *properties = @{@"Category" : @"Music", @"FileName" : @"favorite.avi"};
[MSACAnalytics trackEvent:@"Video clicked" withProperties: properties];
Analytics.trackEvent("Video clicked", withProperties: ["Category" : "Music", "FileName" : "favorite.avi"])
Olayların özellikleri tamamen isteğe bağlıdır; yalnızca bir olayı izlemek istiyorsanız, bunun yerine şu örneği kullanın:
[MSACAnalytics trackEvent:@"Video clicked"];
Analytics.trackEvent("Video clicked")
Diğer olaylardan daha yüksek öneme sahip iş açısından kritik olayları izleyebilirsiniz.
- Geliştiriciler olayların önceliğini Normal (
FlagsNormal
API'de) veya Kritik (FlagsCritical
API'de) olarak ayarlayabilir. - Öncelikleri Kritik olarak ayarlanmış olaylar önce depolama alanından alınır ve Normal olaylardan önce gönderilir.
- Yerel depolama alanı dolu olduğunda ve yeni olayların depolanması gerektiğinde. En düşük önceliğe sahip en eski olaylar yeni olaylara yer açmak için önce silinir.
- Depolama alanı Kritik önceliğe sahip günlüklerle doluysa SDK bu durumda yer açamadığını için Normal önceliğe sahip bir olayı izleme işlemi 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:
NSDictionary *properties = @{@"Category" : @"Music", @"FileName" : @"favorite.avi"};
[MSACAnalytics trackEvent:@"Video clicked" withProperties:properties flags:MSACFlagsCritical];
// If you're using name only, you can pass nil as properties.
let properties = ["Category" : "Music", "FileName" : "favorite.avi"];
Analytics.trackEvent("Video clicked", withProperties: properties, flags: .critical)
// If you're using name only, you can pass nil as properties.
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ı resume
yaptığınızda gönderilir.
[MSACAnalytics pause];
[MSACAnalytics resume];
Analytics.pause()
Analytics.resume()
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.
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
App Center Analytics'i yeniden etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin YES
/true
.
[MSACAnalytics setEnabled:YES];
Analytics.enabled = true
Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı hale geldi.
Not
Bu yöntem yalnızca başlatıldıktan sonra Analytics
kullanılmalıdır.
App Center Analytics'in etkinleştirilip etkinleştirilmediğini de de kontrol edebilirsiniz.
[MSACAnalytics isEnabled];
Analytics.enabled
Not
Bu yöntem yalnızca başlatıldıktan sonra Analytics
kullanılmalıdır, her zaman veya false
başlamadan önce döndürülecektirNO
.
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 başlatılmadan önce aşağıdaki yöntemi çağırın:
[MSACAnalytics enableManualSessionTracker];
Analytics.enableManualSessionTracker()
- Ardından API'yi
startSession
aşağıdakindenAppCenter.start
sonra kullanabilirsiniz:
[MSACAnalytics startSession];
Analytics.startSession()
Varsayılan olarak, SDK tüm günlükleri 10 MB'a kadar depolar. Geliştiriciler depolama boyutunu artırmak için bir API kullanabilir ve SDK, depolama alanı dolana kadar günlükleri depolamaya devam eder.
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. Ağ bağlantısı geri döndüğünde SDK günlükleri 50 toplu iş olarak veya 6 saniyede bir (varsayılan olarak) sonra gönderir.
Not
25 günden eski günlükler atılır.
App Center SDK 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 (varsayılan olarak) günlükleri göndermeye devam eder. Paralel olarak gönderilen en fazla üç toplu iş olabilir. İletim aralığı değiştirilebilir:
// Change transmission interval to 10 seconds.
[MSACAnalytics setTransmissionInterval:10000];
// Change transmission interval to 10 seconds.
Analytics.transmissionInterval = 10000
İletim aralığı değeri 6 saniye ile 86400 saniye (bir gün) arasında olmalıdır ve hizmet başlatılmadan önce bu yöntem çağrılmalıdır.
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 üç 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 saniye 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.