Analisis Data Pemutaran VOD melalui DescribeVodMediaPlayData - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Mengambil data pemutaran file audio atau video pada tanggal tertentu berdasarkan ID media (ID audio atau video), termasuk jumlah pengunjung unik, rata-rata pemutaran per pengguna, total pemutaran, rata-rata durasi pemutaran per pengguna, dan total durasi pemutaran.

Deskripsi operasi

Saat ini, operasi ini hanya tersedia di wilayah China (Shanghai).
Hanya data pemutaran yang dikumpulkan oleh SDK Pemutar Video Apsara yang didukung. Statistik trafik untuk stream audio saja tidak didukung.
Hanya data dalam 30 hari terakhir yang dapat dikueri.

Penting - Sebelum memanggil operasi ini, pastikan bahwa SDK Pemutar Video Apsara memenuhi kondisi berikut:

SDK Pemutar Android atau SDK Pemutar iOS
- Versi SDK Pemutar adalah 5.4.9.2 atau lebih baru.
- Lisensi untuk SDK Pemutar telah diperoleh dan diintegrasikan. Untuk informasi selengkapnya, lihat Manajemen lisensi.
- Fitur pelaporan log pelacakan event pada SDK Pemutar diaktifkan. Secara default, fitur ini diaktifkan di SDK Pemutar Video Apsara. Untuk informasi selengkapnya, lihat Membuat pemutar untuk Android dan Membuat pemutar untuk iOS.
SDK Pemutar Web
- Versi SDK Pemutar adalah 2.16.0 atau lebih baru.
- Lisensi untuk Pemantauan Kualitas Pemutaran telah diperoleh dan diintegrasikan. Kirimkan formulir aplikasi layanan bernilai tambah SDK Pemutar Web untuk mengajukan permohonan. Untuk metode integrasi Lisensi, lihat properti license di Referensi API SDK Web.
- Fitur pelaporan log pelacakan event pada SDK Pemutar diaktifkan. Secara default, fitur ini diaktifkan di SDK Pemutar Video Apsara.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vod:DescribeVodMediaPlayData

none

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
PlayDate	string	No	Tanggal pemutaran. Unit: hari. Format: yyyyMMdd. Catatan Hanya kueri harian yang didukung. Hanya data dalam 30 hari terakhir yang dapat dikueri.	20240322
TerminalType	string	No	Tipe terminal SDK Pemutar. Tentukan parameter ini untuk melakukan kueri terfilter bagi data pemutaran semua file audio dan video berdasarkan tipe terminal. Nilai valid: Native: SDK Pemutar Android atau SDK Pemutar iOS. Web: SDK Pemutar Web.	Native.
Os	string	No	Sistem operasi perangkat pemutaran. Tentukan parameter ini untuk melakukan kueri terfilter bagi data pemutaran semua file audio dan video berdasarkan sistem operasi. Nilai valid: Android iOS Windows macOS Linux	Android.
Region	string	No	Wilayah layanan. Tentukan parameter ini untuk melakukan kueri terfilter bagi data pemutaran semua file audio dan video berdasarkan wilayah layanan. Nilai valid: cn-beijing: China (Beijing) cn-shanghai: China (Shanghai) cn-shenzhen: China (Shenzhen) ap-northeast-1: Jepang (Tokyo) ap-southeast-1: Singapura ap-southeast-5: Indonesia (Jakarta) eu-central-1: Jerman (Frankfurt)	cn-beijing.
MediaId	string	No	ID media, yaitu ID audio atau video (VideoId). Tentukan parameter ini untuk mengueri data pemutaran terfilter untuk file media tertentu. Hanya satu ID media yang dapat ditentukan. Anda dapat memperoleh ID media dengan menggunakan metode berikut: Untuk file audio atau video yang diunggah melalui konsol, masuk ke Konsol ApsaraVideo VOD dan pilih File Media > Audio/Video untuk melihat ID audio atau video. Saat Anda mengunggah file audio atau video dengan memanggil operasi CreateUploadVideo, ID audio atau video adalah nilai dari parameter respons VideoId. Setelah file audio atau video diunggah, Anda dapat memanggil operasi SearchMedia untuk mengueri ID audio atau video terfilter, yaitu nilai dari parameter respons VideoId.	9ae2af636ca6c10412f44891fc****
PageNo	integer	Yes	Nomor halaman data yang akan dikembalikan. Tentukan parameter ini untuk mengatur halaman mulai dari mana data dikembalikan.	1
PageSize	integer	Yes	Jumlah entri per halaman. Tentukan parameter ini untuk mengatur jumlah entri yang ditampilkan pada setiap halaman. Nilai maksimum: 100.	20
OrderType	string	No	Urutan pengurutan. Parameter ini digunakan bersama dengan parameter `OrderName`. Tentukan parameter ini untuk mengurutkan data yang dikembalikan secara menaik atau menurun berdasarkan data deret waktu tertentu. Nilai valid: ASC: urutan menaik. Data yang dikembalikan diurutkan dari terkecil ke terbesar. DESC: urutan menurun. Data yang dikembalikan diurutkan dari terbesar ke terkecil.	ASC.
OrderName	string	No	Nama data deret waktu. Parameter ini digunakan bersama dengan parameter `OrderType`. Tentukan parameter ini untuk mengurutkan data yang dikembalikan secara menaik atau menurun berdasarkan data deret waktu tertentu. Nilai valid: PlaySuccessVv: total pemutaran. PlayPerVv: rata-rata pemutaran per pengguna. PlayDuration: total durasi pemutaran. PlayDurationPerUv: rata-rata durasi pemutaran per pengguna.	PlaySuccessVv.

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	25818875-5F78-4AF6-D7393642CA58****
TotalCount	integer	Jumlah total entri yang dikembalikan.	1
PageNo	integer	Nomor halaman data yang dikembalikan.	1
PageSize	integer	Jumlah entri per halaman.	20
QoeInfoList	array<object>	Daftar data yang dikembalikan.
	object	Detail data yang dikembalikan.
VideoTitle	string	Judul file audio atau video.	Judul video Alibaba Cloud VOD.
VideoDuration	number	Durasi file audio atau video. Unit: detik.	246
MediaId	string	ID media, yaitu ID audio atau video (VideoId).	9ae2af636ca6c10412f44891fc****
DAU	number	Jumlah pengunjung unik untuk file audio atau video.	5
PlaySuccessVv	number	Jumlah total pemutaran untuk file audio atau video.	20
PlayDurationPerUv	number	Rata-rata durasi pemutaran per pengguna untuk file audio atau video. Unit: detik.	120
PlayDuration	number	Total durasi pemutaran untuk file audio atau video. Unit: detik.	2400
PlayPerVv	number	Rata-rata jumlah pemutaran per pengguna untuk file audio atau video.	4

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "TotalCount": 1,
  "PageNo": 1,
  "PageSize": 20,
  "QoeInfoList": [
    {
      "VideoTitle": "Alibaba Cloud VOD video title",
      "VideoDuration": 246,
      "MediaId": "9ae2af636ca6c10412f44891fc****",
      "DAU": 5,
      "PlaySuccessVv": 20,
      "PlayDurationPerUv": 120,
      "PlayDuration": 2400,
      "PlayPerVv": 4
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Meter.ParamError	Param Error:%s,Please Check Again.	One or more parameters are invalid.
500	Meter.ServerInternalError	The Request Processing Has Failed Due To Some Unknown Error.	An internal error occurred.
500	Meter.DataSourceQueryError	Data Source Error:%s,Please Try Again.	An internal data source error occurred.
403	Meter.AuthError	Authentication Failed,Please Try Again.	You do not have permissions to perform this operation.
502	Meter.ReadyTsError	Get ReadyTs Failed,Please Try Again.	The data is not prepared.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.