Dokumen ini menentukan metrik yang diambil oleh YouTube Reporting API. API ini mengambil laporan data massal yang berisi data YouTube Analytics untuk channel atau pemilik konten.
Metrik adalah pengukuran individual aktivitas pengguna, performa iklan, atau estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah tontonan video dan rating (suka dan tidak suka).
Metrik inti
Meskipun YouTube Reporting API tunduk pada Kebijakan Penghentian Layanan yang ditentukan dalam Persyaratan Layanan, metrik non-inti (dan dimensi non-inti) tidak tunduk pada kebijakan tersebut. Dalam definisi di halaman ini, metrik apa pun yang merupakan metrik inti akan diidentifikasi secara eksplisit sebagai metrik inti.
Daftar di bawah mengidentifikasi metrik inti API. Metrik ini yang juga digunakan di YouTube Analytics API juga merupakan metrik inti di API tersebut.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk mengetahui informasi selengkapnya.
Metrik penayangan
- engaged_views (metrik inti)
- Jumlah video channel yang ditonton setelah bingkai pertama, atau pengguna mengklik/mengetuk untuk memutar.
- views (metrik inti)
- Jumlah video yang ditonton. Dalam laporan playlist, metrik ini menunjukkan
jumlah video yang ditonton dalam konteks playlist.
Pusat Bantuan YouTube
memberikan informasi tambahan tentang cara penayangan dilaporkan.
This is a core metric and is subject to the Deprecation Policy.
- red_views
- Jumlah video yang ditonton oleh pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red).
- views_percentage (metrik inti)
- Persentase penonton yang login saat menonton video atau playlist. This is a core metric and is subject to the Deprecation Policy.
Metrik jangkauan
- video_thumbnail_impressions
- Jumlah thumbnail video yang ditampilkan kepada penonton. Tayangan dihitung jika thumbnail ditampilkan selama lebih dari 1 detik dan setidaknya 50% thumbnail terlihat di layar. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya.
- video_thumbnail_impressions_ctr
- Persentase tayangan yang menghasilkan klik untuk menonton video. Metrik ini dihitung sebagai klik dibagi dengan tayangan.
Metrik waktu tonton
- watch_time_minutes (metrik inti)
- Jumlah menit yang dihabiskan pengguna untuk menonton video untuk channel, pemilik konten, video, atau playlist yang ditentukan. 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 menyertakan traffic klip berulang. Dalam laporan playlist, metrik ini menunjukkan durasi rata-rata, dalam detik, pemutaran video yang terjadi dalam konteks playlist. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- Persentase rata-rata video yang ditonton selama pemutaran video. Mulai 13 Desember 2021, metrik ini tidak menyertakan traffic klip berulang.
Metrik engagement
- comments (metrik inti)
- Jumlah komentar yang diberikan pengguna pada video. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy.
- suka (metrik inti)
- Jumlah pengguna yang menunjukkan bahwa mereka menyukai video dengan memberikan rating positif. This is a core metric and is subject to the Deprecation Policy.
- tidak suka (metrik inti)
- Jumlah pengguna yang menunjukkan bahwa mereka tidak menyukai video dengan memberikan rating negatif. This is a core metric and is subject to the Deprecation Policy.
- Jumlah pengguna yang membagikan video melalui tombol
Share. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained (metrik inti)
- Jumlah pengguna yang subscribe ke 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. - subscribers_lost (metrik inti)
- Jumlah pengguna yang berhenti subscribe dari channel. This is a core metric and is subject to the Deprecation Policy.
Data untuk metrik ini dilaporkan dengan cara yang sama seperti metriksubscribers_gained. Untuk mengidentifikasi jumlah pengguna yang berhenti subscribe tetapi tidak berhenti subscribe di halaman tonton video, laporan aktivitas pengguna dasar berisi baris yang tidak menentukan nilai dimensi video_id. Baris tersebut juga menentukan nilai untuk metriksubscribers_gained, tetapi tidak menentukan nilai untuk metrik lainnya. - videos_added_to_playlists
- Jumlah video yang ditambahkan ke playlist YouTube mana pun. Video dapat ditambahkan ke playlist pemilik video atau ke playlist channel lain.
Nilai metrik ini mencakup jumlah video yang ditambahkan ke playlist default seperti playlist "Tonton Nanti". Namun, metrik ini tidak menghitung playlist yang otomatis ditambahkan ke video, seperti playlist video yang diupload channel atau histori tontonan pengguna.
Metrik ini menampilkan angka absolut, yang berarti bahwa jika pengguna menambahkan video ke playlist, 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
- Jumlah video yang dihapus dari playlist YouTube mana pun. Video dapat dihapus dari playlist pemilik video atau dari playlist channel lain.
Nilai metrik ini mencakup jumlah video yang dihapus dari playlist default seperti playlist "Tonton Nanti".
Metrik ini menampilkan angka absolut, yang berarti bahwa jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya lagi, nilai metrik akan mencerminkan video yang dihapus dari playlist dua kali. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014.
Metrik playlist
Laporan playlist berisi dua jenis metrik yang menjelaskan cara penonton berinteraksi dengan video dalam playlist:
-
Metrik video gabungan memberikan metrik aktivitas pengguna dan tayangan yang digabungkan untuk semua video dalam playlist yang juga dimiliki oleh channel yang memiliki playlist tersebut. Metrik untuk video yang dimiliki channel lain tidak dihitung dalam gabungan. Oleh karena itu, jika channel membuat playlist yang hanya berisi video yang dimiliki channel lain, laporan untuk playlist tersebut tidak akan memberikan nilai untuk metrik ini.
Lihat bagian metrik penayangan dan metrik waktu tonton dalam dokumen ini untuk mengetahui definisi metrik video gabungan yang didukung.
-
Metrik dalam playlist mencerminkan aktivitas dan engagement pengguna dalam konteks halaman playlist. Metrik ini mencakup penayangan untuk semua video dalam playlist, terlepas dari channel mana yang memilikinya, tetapi hanya menghitung penayangan yang terjadi dalam konteks playlist.
Sebagian besar metrik berikut adalah metrik dalam playlist; metrik yang tersisa dalam daftar, seperti metrik playlistSaves, adalah tentang interaksi pengguna dengan playlist itu sendiri, bukan dengan video dalam playlist. Oleh karena itu, metrik tersebut tidak akan dikategorikan sebagai
metrik video gabungan atau metrik dalam playlist.
- playlist_starts
- Jumlah penonton yang memulai pemutaran playlist. Perhatikan bahwa metrik ini
hanya mencakup penayangan playlist yang terjadi di web.
- playlist_saves_added (hanya didukung di YouTube Reporting API)
- Jumlah pengguna yang menyimpan playlist. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang playlist yang disimpan. Metrik ini menampilkan angka absolut, yang berarti bahwa jika pengguna menyimpan playlist, menghapusnya dari daftar playlist yang disimpan, dan menyimpannya lagi, nilai metrik akan mencerminkan dua playlist yang disimpan ditambahkan.
- playlist_saves_removed (hanya didukung di YouTube Reporting API)
- Jumlah pengguna yang menghapus playlist dari daftar playlist yang disimpan. Metrik ini menampilkan angka absolut, yang berarti bahwa jika pengguna menyimpan playlist, menghapusnya dari daftar playlist yang disimpan, menyimpannya lagi, dan menghapusnya lagi, nilai metrik akan mencerminkan dua playlist yang disimpan dihapus.
Metrik anotasi
- annotation_impressions
- Total jumlah tayangan anotasi.
- annotation_clickable_impressions
- 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 total jumlah tayangan anotasi yang dapat diklik. This is a core metric and is subject to the Deprecation Policy. Pusat Bantuan YouTube memiliki informasi selengkapnya tentang cara membuat anotasi dan menggunakan anotasi link.
- annotation_closable_impressions
- Jumlah anotasi yang muncul dan dapat ditutup.
- annotation_closes
- Jumlah anotasi yang ditutup.
- annotation_close_rate (metrik inti)
- Rasio anotasi yang ditutup penonton terhadap total jumlah 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 Anda dan Laporan Kartu YouTube Analytics.
- card_impressions
- Jumlah kartu yang ditampilkan. Saat panel kartu dibuka, tayangan kartu akan dicatat untuk setiap kartu video.
- card_clicks
- Jumlah kartu yang diklik.
- card_click_rate
- Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik kartu terhadap tayangan kartu.
- Jumlah teaser kartu yang 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 untuk teaser kartu, yang dihitung sebagai rasio klik pada teaser kartu terhadap total jumlah tayangan teaser kartu.
Metrik layar akhir
Layar akhir adalah elemen yang ditampilkan selama lima hingga 20 detik terakhir pemutaran video untuk mempromosikan konten, channel, dan situs Anda. Pusat Bantuan YouTube berisi petunjuk yang lebih mendetail untuk menambahkan layar akhir ke video Anda dan Laporan Layar Akhir YouTube Analytics.
- end_screen_element_impressions
- Jumlah elemen layar akhir yang ditampilkan. Satu tayangan dicatat untuk setiap elemen layar akhir yang ditampilkan.
- end_screen_element_clicks
- Jumlah elemen layar akhir yang diklik.
- end_screen_element_click_rate
- Rasio klik-tayang untuk elemen layar akhir, yang dihitung sebagai rasio klik elemen layar akhir terhadap tayangan elemen layar akhir.
Metrik pembatalan langganan
- membershipsCancellationSurveyResponses
- Jumlah survei yang diselesaikan oleh pengguna YouTube yang membatalkan langganan channel mereka untuk channel tertentu selama periode pelaporan.
Metrik estimasi pendapatan
Catatan: Metrik estimasi pendapatan tunduk pada penyesuaian akhir bulan dan tidak mencakup iklan yang dijual partner dan ditayangkan partner. Lihat 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 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 Google untuk rentang tanggal dan wilayah yang dipilih.
Metrik estimasi pendapatan tunduk pada penyesuaian akhir bulan dan tidak mencakup iklan yang dijual partner dan ditayangkan 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_reserved_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi penghasilan (pendapatan bersih) dari iklan reservasi yang terjual melalui DoubleClick (DCLK) dan sumber lain yang dijual YouTube. Metrik ini sebelumnya bernama
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (hanya didukung di YouTube Reporting API)
- Estimasi total penghasilan (pendapatan bersih) dari langganan YouTube Premium (sebelumnya dikenal sebagai YouTube Red).
- estimated_partner_transaction_revenue (hanya didukung di YouTube Reporting API)
- Total estimasi pendapatan dari transaksi, seperti konten berbayar dan Pendanaan Penggemar, dikurangi pengembalian dana yang dikenakan biaya partner.
Metrik performa iklan
- estimated_youtube_ad_revenue
- Estimasi pendapatan kotor, dalam USD, dari semua iklan yang dijual Google atau iklan yang dijual partner DoubleClick untuk rentang tanggal dan wilayah yang dipilih. Pendapatan kotor tunduk pada penyesuaian akhir bulan dan tidak mencakup iklan yang ditayangkan partner. Pendapatan kotor tidak sama dengan estimasi pendapatan, atau pendapatan bersih, yang memperhitungkan bagian kepemilikan dan perjanjian bagi hasil Anda.
- estimated_cpm
- Estimasi pendapatan kotor per seribu tayangan iklan.
- ad_impressions
- Jumlah tayangan iklan terverifikasi yang ditayangkan.
- estimated_monetized_playbacks
- Jumlah instance saat penonton memutar video Anda dan melihat setidaknya satu tayangan iklan. Pemutaran yang dimonetisasi dihitung jika penonton melihat iklan pre-roll tetapi berhenti menonton iklan sebelum video Anda dimulai. Estimasi error yang diharapkan untuk angka ini adalah ±2,0%.
- estimated_playback_based_cpm
- Estimasi pendapatan kotor per seribu pemutaran.