Aracılığıyla paylaş


App Center SDK'ları Tarafından Toplanan Veriler

Ö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 SDK'ları App Center hizmetlerine veri gönderir. Gönderilen veriler kullanılan SDK/hizmete, SDK'nın nasıl yapılandırıldığına ve kilitlenme hizmeti için uygulamanız tarafından işlenen verilere göre değişir. Bazı hizmetlerin kullanımı, hizmetin çalışması için belirli verilerin gönderilmesini gerektirir. App Center'a gönderilen tüm veriler merkezi bir alım hizmetinden geçer.

Ortak veriler

SDK'dan Veri Toplama'ya istek başlıkları aracılığıyla gönderilen veriler

Gerekli veriler – Uygulama Gizli Anahtarı, Install-ID

  • Uygulama Gizli Anahtarı (App-Secret) Uygulamayı tanımlamak için kullanılan benzersiz bir anahtar.

  • Yükleme Tanımlayıcısı (Install-ID) App Center SDK'sı ile bir uygulamanın her yüklemesi, yeni, benzersiz bir yükleme tanımlayıcısı oluşturur. Bu kimlik, verileri benzersiz cihazlardan ayırt etmek için kullanılır. App Center hizmetleri, kimliğin düzgün çalışmasını gerektirir.

SDK'dan Veri Alma'ya istek gövdesi aracılığıyla gönderilen veriler

Gerekli veriler - sdkName, sdkVersion, osName, osVersion, locale, timeZoneOffset, appVersion, appBuild

  • Zaman damgası (timestamp) Kayıt zaman damgası, örnek: '2017-03-13T18:05:42Z'

  • Oturum Tanımlayıcısı (sid) Analiz günlükleri, bu tanımlayıcıyı belirterek aynı oturumun bir parçası olabilir.

  • Kullanıcı Tanımlayıcısı (userId) Günlükleri kullanıcılarla ilişkilendirmek için kullanılan isteğe bağlı bir dize.

  • SDK Adı (sdkName) SDK'nın adı. SDK'nın ve platformun adından oluşur; örneğin, "appcenter.ios", "hockeysdk.android"

  • SDK Sürümü (sdkVersion) SDK'nın semver biçimindeki sürümü, örneğin "1.2.0" veya "0.12.3-alfa.1"

  • SDK Sarmalayıcı Sürümü (wrapperSdkVersion) Sarmalayıcı SDK'sının semver biçimindeki sürümü. SDK bir temel SDK'yı sarmaladığında, sarmalayan SDK sürümü bu alanda yakalanırken, temel SDK sürümü sdkVersion'dır. Örneğin, Xamarin.Android yerel Android'i sarmalar.

  • SDK Sarmalayıcı Adı (wrapperSdkName) Sarmalayıcı SDK'sının adı. SDK'nın ve sarmalayıcı platformunun adından oluşur; örneğin, "appcenter.xamarin", "hockeysdk.cordova".

  • Model (model) Cihaz modeli (örnek: iPad2,3)

  • OEM Adı (oemName) Cihaz üreticisinin adı (örnek: HTC)

  • İşletim Sistemi Adı (osName) İşletim sistemi adı (örnek: iOS)

  • İşletim Sistemi Sürümü (osVersion) İşletim sistemi sürümü (örnek: 9.3.0)

  • İşletim Sistemi Derleme Kodu (osBuild) İşletim sistemi derleme kodu (örnek: LMY47X)

  • İşletim Sistemi API Düzeyi (osApiLevel) Android'de olduğu gibi uygulanabilir olduğunda API düzeyi (örnek: 15)

  • Dil ve Ülke Kodu (yerel ayar) ISO dili ve ülke kodu (örnek: en-US)

  • Saat Dilimi Uzaklığı (timeZoneOffset) Gün ışığından yararlanma saati de dahil olmak üzere cihaz saat dilimi için UTC'den dakika cinsinden uzaklık.

  • Ekran Boyutu (screenSize) Cihaz ekranının piksel cinsinden boyutu (örnek: 640x480).

  • Uygulama Sürümü (appVersion) Uygulamanın sürümü genellikle ana, alt ve yapı numarasıyla belirlenir (örnek: 1.1.42)

  • Taşıyıcı Adı (carrierName) Hücre hizmeti sağlayıcısının adı.

  • Taşıyıcı Ülke (carrierCountry) Hücre hizmeti sağlayıcısının ülkesi.

  • Uygulama Derlemesi (appBuild) Uygulamanın derleme numarası. (örnek: 42)

  • Uygulama Ad Alanı (appNamespace) Tek tek platformun ne kullandığına bağlı olarak paket tanımlayıcısı, paket tanımlayıcısı veya ad alanı (örnek: com.microsoft.example)

  • Canlı Güncelleştirme Yayın Etiketi (liveUpdateReleaseLabel) Cihazda çalışan Live Update işareti aracılığıyla yayınlanan 'version' uygulama kodunu tanımlamak için kullanılan etiket.

  • Live Update Dağıtım Anahtarı (liveUpdateDeploymentKey) Geçerli uygulama sürümünün ait olduğu ortamın tanımlayıcısı, dağıtım anahtarı daha sonra Üretim, Hazırlama gibi bir ortama eşler

  • Canlı Güncelleştirme Paketi Karması (liveUpdatePackageHash) LiveUpdate işareti aracılığıyla cihaza dağıtılan tüm dosyaların (ReactNative veya Cordova) karması. Cihazdaki Sürüm sürümünü tanımlamaya yardımcı olur veya gelecekte güncelleştirmeleri indirmesi gerekir

  • Çalışma Zamanı Sarmalayıcı Sürümü (wrapperRuntimeVersion) Sarmalayıcı teknoloji çerçevesinin sürümü (Xamarin çalışma zamanı sürümü, ReactNative, Cordova vb.). Bu sürümün Xamarin'e mi yoksa ReactNative'e mi yoksa başka bir sürüme mi başvurduğuna bakmak için wrappersdkname bölümüne bakın.

  • Jailbreak (jailbreak) Cihazın jailbreak uygulanıp kaldırılmadığını gösteren bir bayrak.

Veri Analitiği

  • Görevlendirme Ölçümleri Katılım, kullanıcı başına günlük oturumları ve oturum süresini ölçer.

    • Kullanıcı başına günlük oturum sayısı: Kullanıcı başına günlük ortalama oturum sayısı.

    • Toplam oturum sayısı: Toplam oturum sayısı.

    • Günlük ortalama oturum sayısı: Gün başına ortalama oturum sayısı, zaman aralığına göre ortalamadır.

    • Oturum süresi: Birkaç süre aralığındaki oturum sayısının dağılımı.

    • Ortalama oturum uzunluğu: Seçilen zaman aralığındaki tüm oturum sürelerinin ortalaması.

  • Olay ölçümleri Kullanıcılarınızla uygulama arasındaki etkileşimi anlamak için 20'ye kadar özellik içeren kendi olay ölçümlerinizi izleyebilirsiniz.

Tanılama

  • Kilitlenme ve hata günlükleri verileri Bu veriler kilitlenmeyle ilgili işlemlerin, iş parçacıklarının, çerçevelerin kimliğini ve adını ve Ortak Veriler bölümünde tanımlanan özel durum türü ile ileti ve cihaz verilerini içerir

  • Kilitlenme ekleri Bu ekler, geliştiricilerin isteğe bağlı olarak kilitlenme raporuna ekleyebileceği ikili dosyalar veya metin dosyalarıdır.

  • Özel özellikler Bu özel anahtar değer çiftleri isteğe bağlı olarak hata raporlarına ek bağlam eklemek için belirtilebilir.

  • Kilitlenme ve hata Kullanıcı Kimliği Bu benzersiz tanımlayıcı isteğe bağlı olarak geliştirici tarafından kilitlenme raporlarına belirli bir kullanıcının kimliğini eklemek üzere ayarlanır.

  • Sembol dosyaları Bu sembol dosyaları, App Center'ın çökme raporlarını anlaşılır hale getirmesi için geliştirici tarafından sağlanır.

Dağıt

  • Jeton Bu GUID, uygulamanın yeni bir sürümünü denetlemek için dağıtım hizmetine gönderilir. GUID yalnızca uygulama App Center kullanılarak yüklendiyse gönderilir.