Analitik Pusat Aplikasi (Apache Cordova)

Artikel
03/17/2024

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Catatan

Dukungan untuk Aplikasi Cordova telah berakhir pada April 2022. Temukan informasi selengkapnya di blog App Center.

App Center Analytics membantu Anda memahami perilaku pengguna dan keterlibatan pelanggan untuk meningkatkan aplikasi Anda. SDK secara otomatis menangkap jumlah sesi dan properti perangkat seperti model, versi OS, dll. Anda dapat menentukan peristiwa kustom Anda sendiri untuk mengukur hal-hal yang penting bagi Anda. Semua informasi yang diambil tersedia di portal App Center bagi Anda untuk menganalisis data.

Ikuti bagian Memulai jika Anda belum menyiapkan SDK di aplikasi Anda.

Informasi sesi dan perangkat

Setelah Anda menambahkan App Center Analytics ke aplikasi anda dan SDK dimulai, itu akan secara otomatis melacak sesi dan properti perangkat seperti Versi OS, model, dll.

Peristiwa kustom

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

Setelah Anda memulai SDK, gunakan trackEvent metode untuk melacak peristiwa Anda dengan properti. Anda dapat mengirim hingga 200 nama peristiwa yang berbeda. Selain itu, ada batas maksimum 256 karakter per nama peristiwa dan 125 karakter per nama properti peristiwa dan nilai properti peristiwa.

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}
AppCenter.Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, success, error);

Fungsi ini menggunakan parameter ketiga sebagai panggilan balik keberhasilan yang mengembalikan string kosong dan parameter keempat sebagai panggilan balik kesalahan yang mengembalikan kesalahan.

Properti untuk peristiwa sepenuhnya opsional. Jika Anda hanya ingin melacak peristiwa, gunakan sampel ini sebagai gantinya:

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.trackEvent('Video clicked', success, error);

Mengaktifkan atau menonaktifkan Analitik App Center saat runtime

Anda dapat mengaktifkan dan menonaktifkan Analitik App Center saat runtime. Jika Anda menonaktifkannya, SDK tidak akan mengumpulkan informasi analitik untuk aplikasi lagi.

var success = function() {
    console.log("Analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(false, success, error);

Fungsi ini menggunakan parameter kedua sebagai panggilan balik keberhasilan yang mengembalikan string kosong dan parameter ketiga sebagai panggilan balik kesalahan yang mengembalikan kesalahan. Untuk mengaktifkan Analitik App Center lagi, gunakan API yang sama tetapi lewati true sebagai parameter.

var success = function() {
    console.log("Analytics enabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.

Periksa apakah Analitik App Center diaktifkan

Anda juga dapat memeriksa apakah App Center Analytics diaktifkan.

var success = function(result) {
    console.log("analytics " + (result) ? "enabled" : "disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.isEnabled(success, error);

Fungsi ini menggunakan parameter pertama sebagai panggilan balik keberhasilan yang mengembalikan boolean parameter dan kedua sebagai panggilan balik kesalahan yang mengembalikan kesalahan.

Tunggu hingga JS mengaktifkan App Center Analytics

Dalam beberapa kasus, aplikasi mungkin ingin bertanya kepada pengguna apakah mereka ingin berbagi informasi analitik. Dalam hal ini, Anda harus mengubah preferensi APPCENTER_ANALYTICS_ENABLE_IN_JS ke true di config.xml Anda

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

Ini berarti bahwa untuk informasi apa pun yang akan dikirim ke App Center (bahkan informasi sesi dasar), pengembang harus terlebih dahulu mengaktifkan App Center Analytics di dalam aplikasi dengan menambahkan baris berikut ke kodenya.

var success = function() {
    console.log("analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

Ukuran penyimpanan lokal

Secara default, SDK menyimpan hingga 10 MB log dalam penyimpanan.

Tidak ada akses internet

Ketika tidak ada konektivitas jaringan, SDK menyimpan hingga 10 MB log di penyimpanan lokal. Setelah penyimpanan penuh, SDK akan mulai membuang log lama untuk memberi ruang bagi log baru. Setelah perangkat mendapatkan akses internet kembali, SDK akan mengirim log dalam batch 50 atau setelah setiap 3 detik.

Batching log peristiwa

App Center SDK mengunggah log dalam batch 50 dan jika SDK tidak memiliki 50 log untuk dikirim, SDK masih akan mengirim log setelah 3 detik. Mungkin ada maksimal tiga batch yang dikirim secara paralel.

Logika coba lagi dan back-off

App Center SDK mendukung percobaan ulang back-off pada kesalahan jaringan yang dapat dipulihkan. Di bawah ini adalah logika coba lagi:

3 mencoba maksimum per permintaan.
Setiap permintaan memiliki mesin status coba lagi sendiri.
Semua saluran transmisi dinonaktifkan (hingga proses aplikasi berikutnya) setelah satu permintaan habis semua percobaan ulangnya.

Logika back-off

Pengacakan 50%, coba lagi pertama antara 5 detik dan 10 detik, coba lagi kedua antara 2,5 dan 5 menit, terakhir coba antara 10 dan 20 menit.
Jika jaringan beralih dari nonaktif ke aktif (atau dari wi-fi ke seluler), status coba lagi diatur ulang dan permintaan segera dicoba ulang.

Bagikan melalui