Jika aplikasi Anda menggunakan ApsaraVideo Player SDK untuk memutar video, Anda dapat memanfaatkan layanan Pemantauan Kualitas Pemutaran guna memantau kualitas pemutaran dan perilaku menonton pengguna. Layanan ini menganalisis data instrumentasi yang dilaporkan oleh ApsaraVideo Player SDK serta menyediakan berbagai metrik—seperti laju kegagalan pemutaran, laju tampilan frame pertama, dan laju tersendat—untuk membantu Anda menilai kualitas pemutaran video secara cepat.
Deskripsi metrik
Metrik QoS
Metrik Quality of Service (QoS) membantu Anda memahami kualitas layanan pemutaran aplikasi Anda.
Metric | Calculation method | Description |
Playback count | Jumlah total kali video diputar. Hitungan tercatat setiap kali ApsaraVideo Player SDK dipanggil untuk memulai pemutaran. | Pemutaran dihitung ketika aplikasi memanggil ApsaraVideo Player SDK untuk memulai pemutaran ( |
Actual playback count | Actual playback count = Total playback count - Total playback failures - Playback start churns | Laju kegagalan memulai pemutaran biasanya dapat diabaikan. |
First frame time (ms) | Waktu dari saat pengguna memulai permintaan pemutaran dengan memanggil ApsaraVideo Player SDK hingga frame pertama dirender. | Jika pemutaran tidak dimulai, tidak ada first frame time. |
Metrik QoE
Metrik Quality of Experience (QoE) membantu Anda memahami perilaku menonton pengguna aplikasi Anda.
Metric | Calculation method | Description |
Number of users | Hitungan unik berdasarkan ID pengguna. ApsaraVideo Player SDK menghasilkan universally unique identifier (UUID). | Jumlah total pengguna yang menonton video dalam rentang waktu tertentu. Ini adalah jumlah Pengguna aktif aplikasi yang memanggil ApsaraVideo Player SDK. Untuk klien mobile, pengguna unik diidentifikasi berdasarkan device ID. |
Playbacks per user | Playbacks per user = Playback count ÷ Number of users | - |
Average video duration (seconds) | AVG(Video duration) | Durasi rata-rata semua video yang ditonton pengguna. |
Prasyarat
Sebelum menggunakan fitur Pemantauan Kualitas Pemutaran:
Fitur Pemantauan Kualitas Pemutaran hanya tersedia untuk versi ApsaraVideo Player SDK berikut: V5.4.9.2 atau lebih baru untuk Android dan iOS, serta V2.16.0 atau lebih baru untuk Web. Untuk informasi selengkapnya, lihat Download the ApsaraVideo Player SDK.
ApsaraVideo Player SDK untuk Android, iOS, dan Web memerlukan lisensi yang valid. Untuk informasi selengkapnya, lihat Obtain a license.
Pastikan fitur pelaporan log ApsaraVideo Player SDK telah diaktifkan. Fitur ini diaktifkan secara default.
Opsional: Saat membuat player, sertakan traceId. Anda kemudian dapat menggunakan single-point tracking untuk melokalisasi pengguna atau perangkat tertentu, menganalisis perilaku pemutaran mereka, dan mengidentifikasi masalah—seperti error pemutaran—secara cepat. Untuk informasi tentang cara menyertakan traceId, lihat Basic features of ApsaraVideo Player for Android, Basic features of ApsaraVideo Player for iOS, dan Web player API reference.
Batasan
Anda dapat mengkueri data pemutaran untuk 3 hari terakhir. Satu kueri tidak boleh mencakup beberapa hari sekaligus.
Prosedur
Masuk ke ApsaraVideo VOD console.
Di panel navigasi sebelah kiri, pilih Data Center > Playback Quality Monitoring untuk membuka halaman Pemantauan Kualitas Pemutaran.
Anda dapat melihat data metrik berdasarkan dimensi.

Anda dapat memfilter dan mengkueri data menggunakan dimensi berikut:
Filter dan kueri data berdasarkan dimensi seperti jenis terminal, jenis sistem, resolusi, dan jenis jaringan.
Kueri data untuk rentang waktu kustom mulai dari jam terakhir hingga 3 hari terakhir.
Anda dapat mengklik Add Filter Condition untuk mengatur kondisi filter, seperti versi SDK, format video, hardware decoding, ISP, nama domain, dan provinsi. Aturan filter yang sering digunakan dapat disimpan untuk penggunaan di masa mendatang. Tabel berikut menjelaskan kondisi filter tersebut.
Condition
Description
SDK version
Nomor versi ApsaraVideo Player SDK yang diintegrasikan ke dalam aplikasi saat ini.
Video format
Mengacu pada format file video, seperti HLS atau FLV.
Hardware decoding
Menunjukkan apakah hardware decoding diaktifkan untuk decoding video.
Carrier
Membedakan data pemutaran berdasarkan internet service provider (ISP).
Domain name
Alamat server tempat konten video berada.
Country
Membagi data pemutaran berdasarkan lokasi geografis pengguna.
Chinese provinces
Mempersempit cakupan data pemutaran ke wilayah administratif provinsi.