Bagikan melalui


Data yang Dikumpulkan oleh App Center SDK

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

App Center SDK mengirim data ke layanan App Center. Data yang dikirim bervariasi menurut SDK/layanan yang digunakan, bagaimana SDK dikonfigurasi, dan untuk layanan crash, pada data yang ditangani oleh aplikasi Anda. Penggunaan beberapa layanan mengharuskan data tertentu dikirim agar layanan berfungsi. Semua data yang dikirim ke App Center mengalir melalui layanan penerimaan pusat.

Data umum

Data yang dikirim melalui header permintaan dari SDK ke Ingestion

Data yang diperlukan - Rahasia Aplikasi, Install-ID

  • Rahasia Aplikasi (App-Secret) Kunci unik yang digunakan untuk mengidentifikasi aplikasi.

  • Pengidentifikasi Penginstalan (Install-ID) Setiap penginstalan aplikasi dengan App Center SDK menghasilkan pengidentifikasi penginstalan unik yang baru. ID ini digunakan untuk membedakan data dari perangkat unik. Layanan App Center mengharuskan ID berfungsi dengan baik.

Data yang dikirim melalui isi permintaan dari SDK ke Pemasukan

Data yang diperlukan - sdkName, sdkVersion, osName, osVersion, locale, timeZoneOffset, appVersion, appBuild

  • Tanda waktu (tanda waktu) Tanda waktu log, contoh: '2017-03-13T18:05:42Z'

  • Pengidentifikasi Sesi (sid) Log analitik dapat menjadi bagian dari sesi yang sama dengan menentukan pengidentifikasi ini.

  • Pengidentifikasi Pengguna (userId) String opsional yang digunakan untuk mengaitkan log dengan pengguna.

  • Nama SDK (sdkName) Nama dari SDK. Terdiri dari nama SDK dan platform, misalnya "appcenter.ios", "hockeysdk.android"

  • Versi SDK (sdkVersion) Versi SDK dalam format semver, misalnya "1.2.0" atau "0.12.3-alpha.1"

  • Versi Pembungkus SDK (wrapperSdkVersion) Versi Pembungkus SDK dalam format semver. Ketika SDK membungkus SDK dasar, versi SDK pembungkus ditangkap di bidang ini sementara versi SDK dasar adalah sdkVersion. Misalnya, Xamarin.Android membungkus Android asli.

  • Nama Pembungkus SDK (wrapperSdkName) Nama Pembungkus SDK. Terdiri dari nama SDK dan platform pembungkus, misalnya "appcenter.xamarin", "hockeysdk.cordova".

  • Model (model) Model perangkat (misalnya: iPad2,3)

  • Nama OEM (oemName) Nama produsen perangkat (misalnya: HTC)

  • Nama Sistem Operasi (osName) Nama OS (contoh: iOS)

  • Versi Sistem Operasi (osVersion) Versi OS (misalnya: 9.3.0)

  • Kode Build Sistem Operasi (osBuild) Kode build OS (contoh: LMY47X)

  • Tingkat API Sistem Operasi (osApiLevel) Tingkat API jika berlaku seperti di Android (misalnya: 15)

  • Kode Bahasa dan Negara (lokal) Bahasa ISO dan kode negara (misalnya: en-US)

  • Offset Zona Waktu (timeZoneOffset) Offset dalam hitungan menit dari UTC untuk zona waktu perangkat, termasuk waktu musim panas.

  • Ukuran Layar (ukuran layar) Ukuran layar perangkat dalam piksel (misalnya: 640x480).

  • Versi Aplikasi (appVersion) Versi aplikasi biasanya di utama, minor, build (misalnya: 1.1.42)

  • Nama Operator (carrierName) Nama penyedia layanan sel.

  • Negara Operator (carrierCountry) Negara penyedia layanan seluler.

  • Build Aplikasi (appBuild) Nomor build aplikasi. (contoh: 42)

  • Application Namespace (appNamespace) Pengidentifikasi bundel, pengidentifikasi paket, atau namespace layanan, tergantung pada apa yang digunakan platform individual (misalnya: com.microsoft.example)

  • Label Rilis Pembaruan Langsung (liveUpdateReleaseLabel) Label yang digunakan untuk mengidentifikasi kode aplikasi 'versi' yang dirilis melalui suar Pembaruan Langsung yang berjalan di perangkat.

  • Kunci Penyebaran Pembaruan Langsung (liveUpdateDeploymentKey) Pengidentifikasi lingkungan tempat rilis aplikasi saat ini berada, kunci penyebaran kemudian memetakan ke lingkungan seperti Produksi, Penahapan

  • Hash Paket Pembaruan Langsung (liveUpdatePackageHash) Hash semua file (ReactNative atau Cordova) yang disebarkan ke perangkat melalui suar LiveUpdate. Membantu mengidentifikasi versi Rilis pada perangkat atau perlu mengunduh pembaruan di masa mendatang

  • Versi Pembungkus Runtime (wrapperRuntimeVersion) Versi kerangka kerja teknologi pembungkus (versi runtime Xamarin, ReactNative, Cordova, dan sebagainya). Lihat wrappersdkname untuk melihat apakah versi ini mengacu pada Xamarin atau ReactNative atau lainnya.

  • Jailbreak (jailbreak) Bendera yang menunjukkan apakah perangkat telah di-jailbroken.

Analitik

  • Metrik Keterlibatan Keterlibatan mengukur sesi harian per pengguna dan durasi sesi.

    • Sesi harian per pengguna: Jumlah rata-rata sesi harian per pengguna.

    • Total sesi: Jumlah total sesi.

    • Sesi rata-rata per hari: Jumlah sesi per hari rata-rata selama rentang waktu.

    • Durasi sesi: Distribusi jumlah sesi selama beberapa interval durasi.

    • Panjang sesi rata-rata: Rata-rata semua durasi sesi dalam rentang waktu yang dipilih.

  • Metrik peristiwa Anda dapat melacak metrik peristiwa Anda sendiri dengan hingga 20 properti untuk memahami interaksi antara pengguna dan aplikasi Anda.

Diagnostik

  • Data log crash dan kesalahan Data ini mencakup ID dan nama proses, utas, bingkai, yang terkait dengan crash dan jenis pengecualian serta pesan dan data perangkat seperti yang didefinisikan di bagian Data Umum

  • Lampiran crash Lampiran ini adalah file biner atau teks yang dapat dilampirkan oleh pengembang secara opsional ke laporan crash.

  • Properti kustom Pasangan nilai kunci kustom ini dapat secara opsional ditentukan untuk menambahkan konteks tambahan ke laporan kesalahannya.

  • ID Pengguna untuk Crash dan Kesalahan Pengidentifikasi unik ini secara opsional diatur oleh pengembang untuk melampirkan identifikasi pengguna tertentu ke laporan crash dan kesalahan.

  • File simbol File simbol ini disediakan oleh pengembang untuk App Center untuk melambangkan crash.

Distribusikan

  • Token GUID ini dikirim ke layanan distribusi untuk memeriksa versi baru dari aplikasi. GUID hanya dikirim jika aplikasi diinstal menggunakan App Center.