Dokumen ini menentukan metrik yang diambil YouTube Reporting API. API ini mengambil laporan data massal yang berisi data YouTube Analytics untuk channel atau pemilik konten.
Metrik adalah pengukuran individual dari aktivitas pengguna, performa iklan, atau estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah penayangan video dan rating (suka dan tidak suka).
Metrik inti
Meskipun YouTube Reporting API tunduk pada Kebijakan Penghentian Layanan yang ditetapkan dalam Persyaratan Layanan, metrik non-inti (dan dimensi non-inti) tidak tunduk pada kebijakan ini. Dalam definisi di halaman ini, setiap metrik yang merupakan metrik inti diidentifikasi secara eksplisit.
Daftar di bawah ini mengidentifikasi metrik inti API. Setiap metrik ini yang juga digunakan di YouTube Analytics API juga merupakan metrik inti di API tersebut.
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk informasi selengkapnya.
Lihat metrik
- tampilan (metrik inti)
- Frekuensi video ditonton. Dalam laporan playlist, metrik menunjukkan frekuensi video ditonton dalam konteks playlist. Pusat Bantuan YouTube memberikan informasi tambahan tentang cara pelaporan jumlah penayangan. This is a core metric and is subject to the Deprecation Policy.
- tampilan_merah
- Frekuensi video ditonton oleh pelanggan YouTube Premium (sebelumnya disebut YouTube Red).
- views_percent (metrik inti)
- Persentase penonton yang login saat menonton video atau playlist. This is a core metric and is subject to the Deprecation Policy.
Metrik waktu tonton
- watch_time_minutes (metrik inti)
- Jumlah menit pengguna menonton video untuk channel, pemilik konten, video, atau playlist tertentu. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- Jumlah menit yang dihabiskan pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) untuk menonton video.
- average_view_duration_seconds (metrik inti)
- Durasi rata-rata, dalam detik, pemutaran video. Mulai 13 Desember 2021, metrik ini tidak mencakup traffic klip berulang. Dalam laporan playlist, metrik menunjukkan rata-rata durasi pemutaran video yang terjadi dalam konteks playlist dalam hitungan detik. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percent
- Persentase rata-rata video yang ditonton selama pemutaran video. Mulai 13 Desember 2021, metrik ini tidak mencakup traffic klip berulang.
Metrik engagement
- komentar (metrik inti)
- Frekuensi pengguna mengomentari video. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy.
- suka (metrik inti)
- Frekuensi pengguna menunjukkan bahwa mereka menyukai video dengan memberinya rating positif. This is a core metric and is subject to the Deprecation Policy.
- tidak suka (metrik inti)
- Frekuensi pengguna menunjukkan bahwa mereka tidak menyukai video dengan memberikan rating negatif. This is a core metric and is subject to the Deprecation Policy.
- Frekuensi pengguna membagikan video melalui tombol
Share
. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained (metrik inti)
- Frekuensi pengguna subscribe ke sebuah channel. This is a core metric and is subject to the Deprecation Policy.
Channel dapat memperoleh atau kehilangan subscriber di beberapa tempat, termasuk halaman tonton video, halaman channel, dan panduan yang muncul di halaman beranda YouTube. Untuk mengidentifikasi jumlah subscriber channel baru yang tidak subscribe melalui halaman tonton video, laporan aktivitas pengguna dasar berisi baris yang tidak menentukan nilai dimensi video_id. Baris tersebut juga menentukan nilai untuk metriksubscribersLost
, tetapi tidak menentukan nilai untuk metrik lainnya. - subscriber_lost (metrik inti)
- Frekuensi pengguna berhenti berlangganan dari sebuah channel. This is a core metric and is subject to the Deprecation Policy.
Data untuk metrik ini dilaporkan mirip dengan metriksubscribers_gained
. Untuk mengidentifikasi jumlah pengguna yang berhenti berlangganan tetapi tidak unsubscribe di halaman tonton video, laporan aktivitas pengguna dasar berisi baris yang tidak menetapkan nilai dimensi video_id. Baris tersebut juga menentukan nilai untuk metriksubscribers_gained
, tetapi tidak menentukan nilai untuk metrik lainnya. - videos_menambahkan_ke_playlist
- Frekuensi video ditambahkan ke playlist YouTube mana pun. Video dapat ditambahkan ke playlist pemilik video atau di playlist channel lain.
Nilai metrik mencakup frekuensi penambahan video ke playlist default seperti playlist "Tonton Nanti". Namun, metrik ini tidak menghitung playlist yang otomatis ditambahkan ke video, seperti playlist yang diupload channel atau histori tontonan pengguna.
Metrik ini menampilkan angka absolut, artinya jika pengguna menambahkan video ke playlist, lalu menghapusnya, lalu menambahkannya lagi, nilai metrik akan mencerminkan video yang ditambahkan ke playlist dua kali. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014. - videos_removed_from_playlists
- Frekuensi video dihapus dari playlist YouTube mana pun. Video dapat dihapus dari playlist pemilik video atau dari playlist channel lain.
Nilai metrik mencakup frekuensi video dihapus dari playlist default seperti playlist "Tonton Nanti".
Metrik ini menampilkan angka absolut, artinya jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya lagi, nilai metrik mencerminkan video yang dihapus dua kali dari playlist. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014.
Metrik playlist
- playlist_starts
- Frekuensi penonton memulai pemutaran playlist. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
- playlist_saves_ added (hanya didukung di YouTube Reporting API)
- Frekuensi pengguna menyimpan playlist. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang playlist yang disimpan. Metrik ini menampilkan angka absolut, artinya jika pengguna menyimpan playlist, menghapusnya dari daftar playlist tersimpan, dan menyimpannya lagi, nilai metrik akan mencerminkan dua penyimpanan playlist yang akan ditambahkan.
- playlist_saves_removed (hanya didukung di YouTube Reporting API)
- Frekuensi pengguna menghapus playlist dari daftar playlist tersimpan mereka. Metrik ini menampilkan angka absolut, artinya jika pengguna menyimpan playlist, menghapusnya dari daftar playlist tersimpan, menyimpannya lagi, dan menghapusnya lagi, nilai metrik akan mencerminkan dua penyimpanan playlist yang akan dihapus.
Metrik anotasi
- annotation_tayangan
- Jumlah total tayangan anotasi.
- annotation_clickable_impression
- Jumlah anotasi yang muncul dan dapat diklik.
- annotation_clicks
- Jumlah anotasi yang diklik.
- annotation_click_through_rate (metrik inti)
- Rasio anotasi yang diklik penonton terhadap jumlah total tayangan anotasi yang dapat diklik. This is a core metric and is subject to the Deprecation Policy. Pusat Bantuan YouTube memiliki informasi lebih lanjut tentang cara membuat anotasi dan menggunakan anotasi link.
- annotation_closable_impression
- Jumlah anotasi yang muncul dan dapat ditutup.
- annotation_closes
- Jumlah anotasi yang ditutup.
- annotation_close_rate (metrik inti)
- Rasio anotasi yang ditutup penonton terhadap jumlah total tayangan anotasi. This is a core metric and is subject to the Deprecation Policy.
Metrik kartu
Pusat Bantuan YouTube berisi petunjuk yang lebih mendetail untuk menambahkan kartu ke video dan Laporan Kartu YouTube Analytics.
- kartu_tayangan
- Frekuensi kartu ditampilkan. Saat panel kartu dibuka, tayangan kartu akan dicatat untuk setiap kartu video.
- kartu_klik
- Frekuensi kartu diklik.
- rasio_kartu_klik
- Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik kartu terhadap tayangan kartu.
- Frekuensi teaser kartu ditampilkan. Jumlah tontonan video dapat menghasilkan beberapa tayangan teaser.
- Jumlah klik pada teaser kartu. Jumlah klik pada ikon kartu dikaitkan dengan teaser terakhir yang ditampilkan kepada pengguna.
- Rasio klik-tayang teaser kartu, yang dihitung sebagai rasio klik pada teaser kartu terhadap jumlah total tayangan teaser kartu.
Metrik layar akhir
Layar akhir adalah elemen yang ditampilkan selama lima hingga 20 detik terakhir video untuk mempromosikan konten, saluran, dan situs web Anda. Pusat Bantuan YouTube berisi petunjuk yang lebih mendetail untuk menambahkan layar akhir ke video dan Laporan Layar Akhir YouTube Analytics.
Catatan: Data untuk metrik layar akhir tersedia mulai 1 Mei 2016.
- tayangan_elemen_layar_akhir
- Jumlah elemen layar akhir yang ditampilkan. Satu tayangan dicatat untuk setiap elemen layar akhir yang ditampilkan.
- end_screen_element_clicks
- Frekuensi elemen layar akhir diklik.
- rasio_klik_elemen_layar_akhir
- Rasio klik-tayang untuk elemen layar akhir, yang dihitung sebagai rasio klik elemen layar akhir terhadap tayangan elemen layar akhir.
Metrik retensi audiens
- audience_retention_Percentage
- Rasio mutlak penonton yang menonton video pada titik tertentu dalam video. Rasio ini dihitung dengan membandingkan berapa kali bagian video telah ditonton terhadap total jumlah penayangan video. Dimensi
elapsed_video_time_percentage
mengidentifikasi bagian video yang sesuai dengan metrik.
Perhatikan bahwa sebagian video dapat ditonton lebih dari sekali (atau tidak sama sekali) di penayangan video tertentu. Misalnya, jika pengguna memutar ulang dan menonton bagian video yang sama beberapa kali, maka rasio mutlak untuk bagian video tersebut bisa lebih besar dari1
.
Contoh berikut menggambarkan cara penghitungan nilai:- Video satu menit ditonton sebanyak 100 kali. Setengah dari penonton berhenti menonton setelah 15 detik dan sisanya menonton keseluruhan video. Tidak ada penonton yang menonton bagian video yang lebih dari sekali. Dalam kasus ini, nilai metrik ini adalah
1
untuk bucket waktu pada kuartal pertama video, dan nilainya adalah0.50
untuk sisa video. - Video satu menit ditonton sebanyak 100 kali. Semua penonton menonton keseluruhan video, tetapi 20 penonton menontonnya hingga durasi video 45 detik, lalu melewatinya ke detik 30 detik, lalu menonton sisa video. Dalam hal ini, nilai metrik adalah
1
untuk bucket waktu pada paruh pertama atau kuartal terakhir video. Namun, nilainya akan menjadi1.2
untuk rentang waktu pada kuartal ketiga video sejak 100 persen penonton menonton segmen video tersebut, tetapi 20% dari penonton tersebut menonton segmen tersebut dua kali.
- Video satu menit ditonton sebanyak 100 kali. Setengah dari penonton berhenti menonton setelah 15 detik dan sisanya menonton keseluruhan video. Tidak ada penonton yang menonton bagian video yang lebih dari sekali. Dalam kasus ini, nilai metrik ini adalah
Metrik estimasi pendapatan
Catatan: Metrik estimasi pendapatan tunduk pada penyesuaian akhir bulan serta tidak termasuk iklan yang dijual dan ditayangkan oleh partner. Harap buka Pusat Bantuan YouTube untuk mengetahui informasi dan catatan tambahan tentang angka estimasi pendapatan.
- estimated_partner_revenue (metrik inti)
- Total estimasi pendapatan bersih dari semua sumber iklan yang dijual oleh Google, serta dari sumber non-iklan untuk rentang tanggal dan wilayah yang dipilih.
- estimated_partner_ad_revenue
- Total estimasi pendapatan bersih dari semua sumber iklan yang dijual oleh Google untuk rentang tanggal dan wilayah yang dipilih.
Metrik pendapatan yang diperkirakan akan disesuaikan dengan akhir bulan dan tidak mencakup iklan yang dijual serta ditayangkan oleh partner. - estimated_partner_ad_auction_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi penghasilan (pendapatan bersih) dari iklan yang dijual lewat lelang melalui AdSense untuk rentang tanggal dan wilayah yang dipilih. Metrik ini sebelumnya bernama
estimated_partner_ad_sense_revenue
. - estimated_partner_ad_sense_revenue (hanya didukung di YouTube Reporting API)
- Estimasi total penghasilan (pendapatan bersih) dari iklan AdSense yang dijual melalui lelang untuk rentang tanggal dan wilayah yang dipilih.
- estimated_partner_ad_CAD_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi penghasilan (pendapatan bersih) dari iklan pesanan yang terjual melalui DoubleClick (DCLK) dan sumber lain yang dijual YouTube. Metrik ini sebelumnya bernama
estimated_partner_double_click_revenue
. - estimated_partner_double_click_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi penghasilan (pendapatan bersih) dari iklan yang dijual khusus melalui DoubleClick (DCLK) dan sumber lain yang dijual YouTube.
- estimated_partner_red_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi penghasilan (pendapatan bersih) dari langganan YouTube Premium (sebelumnya disebut YouTube Red).
- estimated_partner_transaction_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi pendapatan dari transaksi, seperti konten berbayar dan Fan Funding, dikurangi pengembalian dana yang ditagihkan oleh partner.
Metrik performa iklan
- estimated_youtube_ad_revenue
- Estimasi pendapatan kotor, dalam USD, dari semua iklan yang dijual Google atau yang dijual partner DoubleClick untuk rentang tanggal dan wilayah yang dipilih. Pendapatan kotor dikenakan penyesuaian akhir bulan dan tidak termasuk iklan yang ditayangkan partner. Pendapatan kotor tidak sama dengan estimasi pendapatan, atau pendapatan bersih, yang dihitung berdasarkan saham kepemilikan dan perjanjian bagi hasil Anda.
- estimated_cpm
- Estimasi pendapatan kotor per seribu tayangan iklan.
- tayangan_iklan
- Jumlah tayangan iklan terverifikasi yang ditayangkan.
- estimated_monetizationd_playbacks
- Jumlah instance saat penonton memutar video Anda dan minimal satu tayangan iklan ditayangkan. Pemutaran yang dimonetisasi dihitung jika penonton melihat iklan preroll, tetapi berhenti menonton iklan tersebut sebelum video Anda dimulai. Perkiraan kesalahan untuk angka ini adalah ±2,0%.
- estimasi_play_based_cpm
- Estimasi pendapatan kotor per seribu pemutaran.