Analitik Pusat Aplikasi (React Native)

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.

• Android
• Ios
• React Native
• Windows
• MAUI/Xamarin
• Persatuan
• macOS
• tvOS

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 dan SDK dimulai, app Center Analytics secara otomatis melacak sesi dan properti perangkat seperti Versi OS, model, dll.

Peristiwa kustom

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

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

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

Fungsi ini mengembalikan janji, kasus keberhasilan mengembalikan string kosong dan kasus kesalahan mengembalikan kesalahan.

Properti untuk peristiwa bersifat opsional; jika Anda hanya ingin melacak peristiwa, gunakan ini sebagai gantinya:

Analytics.trackEvent('Video clicked');

Mengaktifkan atau menonaktifkan App Center Analytics saat runtime

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

await Analytics.setEnabled(false);

Fungsi ini mengembalikan janji yang diselesaikan menjadi kosong.

Untuk mengaktifkan kembali Analitik App Center, gunakan API yang sama tetapi masukkan true sebagai parameter.

await Analytics.setEnabled(true);

Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.

Periksa apakah App Center Analytics diaktifkan

Anda juga dapat memeriksa apakah App Center Analytics diaktifkan atau tidak.

const enabled = await Analytics.isEnabled();

Fungsi ini mengembalikan janji yang diselesaikan ke boolean.

Tunggu hingga JS mengaktifkan App Center Analytics

Jika Anda ingin mengumpulkan informasi analitik untuk pengguna aplikasi Anda tetapi ingin mendapatkan izin pengguna terlebih dahulu, Anda memiliki opsi untuk tidak mengaktifkan analitik saat startup, tetapi tunggu hingga waktu yang tepat dan aktifkan di JavaScript sebagai gantinya.

1. Buka file proyek ios/YourAppName/AppDelegate.m dan ganti [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; dengan [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
2. Buka file proyek android/app/src/main/res/values/strings.xml dan ganti <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> dengan <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Ini berarti bahwa untuk informasi apa pun yang akan dikirim ke App Center (bahkan informasi sesi dasar), Anda harus terlebih dahulu mengaktifkan App Center Analytics dengan menambahkan baris kode berikut:

await Analytics.setEnabled(true);

Mengelola sesi mulai

Secara default, ID sesi tergantung pada siklus hidup aplikasi. Jika Anda ingin mengontrol awal sesi baru secara manual, ikuti langkah-langkah berikutnya:

Nota

Perhatikan bahwa setiap panggilan API Analytics.StartSession() akan menghasilkan sesi baru. Jika dalam mode pelacak sesi manual, API ini tidak akan dipanggil maka semua log pengiriman akan memiliki nilai sesi null.

Nota

Perhatikan bahwa setelah aplikasi baru meluncurkan id sesi akan diregenerasi.

Untuk mengonfigurasi SDK untuk sesi pelacakan secara manual, Anda harus menggunakan API Analitik enableManualSessionTracker asli:

• Di iOS, panggil [MSACAnalytics enableManualSessionTracker]; sebelum [AppCenterReactNative register]; dalam metode delegasi aplikasi didFinishLaunchingWithOptions di AppDelegate.m. Tambahkan @import AppCenterAnalytics jika hilang dalam file tersebut.

• Di Android, panggil Analytics.enableManualSessionTracker(); sebelum SoLoader.init dalam metode onCreate di MainApplication.java. Tambahkan impor com.microsoft.appcenter.analytics.Analytics jika hilang dalam file tersebut.

Kemudian Anda dapat menggunakan startSession API dalam proyek React Native Anda:

Analytics.startSession();

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

Pengelompokan catatan peristiwa

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

Coba lagi dan logika penundaan

App Center SDK mendukung percobaan ulang dengan penundaan sementara pada kesalahan jaringan yang dapat diperbaiki. Di bawah ini adalah logika coba lagi:

• Maksimum 3 percobaan per permintaan.
• Setiap permintaan memiliki mesin status coba lagi sendiri.
• Semua saluran transmisi dinonaktifkan (hingga proses aplikasi berikutnya) setelah satu permintaan habis semua kesempatan pengulangannya.

Logika penundaan

• 50% pengacakan, coba lagi pertama antara 5 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.