Analitik App Center (Unity)
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.
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 instruksi di bagian Memulai Unity jika Anda belum menyiapkan SDK di aplikasi Anda.
Catatan
Untuk menggunakan API yang disajikan di bawah ini, Anda harus menambahkan pernyataan berikut using
ke file Anda .cs
:
using Microsoft.AppCenter.Unity.Analytics;
Anda juga harus memastikan bahwa Gunakan Analitik dicentang di pengaturan objek game App Center Anda.
Setelah Anda menambahkan App Center Analytics dan memulai SDK, app Center Analytics akan secara otomatis melacak sesi dan properti perangkat seperti Versi OS, model, dll. tanpa memerlukan kode tambahan apa pun di aplikasi Anda.
Anda dapat melacak peristiwa kustom Anda sendiri dengan hingga 20 properti untuk mengetahui apa yang terjadi di aplikasi Anda, memahami tindakan pengguna, dan melihat agregat di portal App Center.
TrackEvent()
Gunakan metode untuk melacak peristiwa Anda dengan properti. Anda dapat mengirim hingga 200 nama peristiwa yang berbeda. Ada batas maksimum 256 karakter per nama peristiwa dan 125 karakter per nama dan nilai properti peristiwa.
Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
{ "Category", "Music" },
{ "FileName", "favorite.avi" }
});
Properti untuk peristiwa bersifat opsional – jika Anda hanya ingin melacak peristiwa, gunakan sampel ini sebagai gantinya:
Analytics.TrackEvent("Video clicked");
Peringatan
Analytics.TrackEvent()
akan berprilaku tidak konsisten di seluruh platform jika dipanggil sebelum Awake()
metode dalam skrip AppCenterBehavior.cs
. Agar aman, Anda hanya boleh mengandalkan peristiwa yang akan dikirim setelah adegan pertama dalam aplikasi Anda telah membangunkan semua MonoBehaviour
skrip. Untuk melacak peristiwa bersama dengan MonoBehavour
inisialisasi , pertimbangkan untuk menambahkan API ke metode skrip Start()
Anda alih-alih Awake()
.
Anda dapat mengaktifkan dan menonaktifkan Analitik App Center saat runtime. Jika Anda menonaktifkannya, SDK akan berhenti mengumpulkan informasi analitik untuk aplikasi. Untuk menonaktifkan Analytics, gunakan API berikut, meneruskan false
sebagai parameter.
Analytics.SetEnabledAsync(false);
Untuk mengaktifkan Analitik App Center lagi, gunakan API yang sama tetapi teruskan true
sebagai parameter.
Analytics.SetEnabledAsync(true);
Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.
API ini asinkron, Anda dapat membaca lebih lanjut di panduan API Asinkron App Center kami.
Anda juga dapat memeriksa apakah App Center Analytics diaktifkan atau tidak.
bool isEnabled = await Analytics.IsEnabledAsync();
Anda dapat melacak peristiwa penting bisnis yang memiliki kepentingan lebih tinggi daripada peristiwa lain.
Pengembang dapat menetapkan persistensi peristiwa sebagai Normal (Flags.PersistenceNormal
di API) atau Kritis (Flags.PersistenceCritical
di API).
Anda dapat menggunakan API berikut untuk melacak peristiwa sebagai Kritis:
Analytics.TrackEvent("eventName", Flags.PersistenceCritical);
Jika Anda menggunakan properti:
Analytics.TrackEvent("eventName", new Dictionary<string, string> {
{ "Category", "Music" },
{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);
Menjeda transmisi peristiwa dapat berguna dalam skenario ketika aplikasi perlu mengontrol bandwidth jaringan untuk kebutuhan yang lebih penting bagi bisnis. Anda dapat menjeda pengiriman log ke backend App Center. Saat dijeda, peristiwa masih dapat dilacak dan disimpan, tetapi tidak segera dikirim. Setiap peristiwa yang dilacak aplikasi Anda saat dijeda hanya akan dikirim setelah Anda memanggil Analytics.Resume
.
Analytics.Pause();
Analytics.Resume();
API ini asinkron, Anda dapat membaca lebih lanjut di panduan API Asinkron App Center kami.
Secara default, ID sesi tergantung pada siklus hidup aplikasi. Jika Anda ingin mengontrol awal sesi baru secara manual, ikuti langkah-langkah berikutnya:
Catatan
Perhatikan bahwa setiap panggilan Analytics.StartSession() API akan menghasilkan sesi baru. Jika dalam mode pelacak sesi manual, API ini tidak akan dipanggil maka semua log pengiriman akan memiliki nilai sesi null.
Catatan
Perhatikan bahwa setelah aplikasi baru meluncurkan id sesi akan diregenerasi.
- Hapus centang pada kotak aktifkan Pelacak Sesi Manual di bawah bagian Analitik pada objek game dengan AppCenterBehavior terlampir.
- Kemudian Anda dapat menggunakan
StartSession
API setelahAppCenter.Start
:
Analytics.StartSession();
Secara default, SDK menyimpan hingga 10 MB log di penyimpanan.
Ketika tidak ada konektivitas jaringan, SDK menghemat 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.
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.
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 ulang.
Logika back-off
- Pengacakan 50%, 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.