Metrics

Dokumen ini menentukan metrik yang diambil YouTube Reporting API. API ini mengambil laporan data massal yang berisi data YouTube Analytics untuk pemilik konten atau channel.

Metrik adalah pengukuran individual dari 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 ditetapkan dalam Persyaratan Layanan, metrik non-inti (dan dimensi non-core) tidak tunduk pada kebijakan tersebut. Dalam definisi di halaman ini, setiap metrik yang merupakan metrik inti secara eksplisit diidentifikasi seperti itu.

Daftar di bawah ini mengidentifikasi metrik inti API. Setiap metrik ini yang juga digunakan dalam YouTube Analytics API juga merupakan metrik inti di API tersebut.

Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk mengetahui informasi lebih lanjut.

Melihat metrik

penayangan (metrik inti)
Berapa kali video ditonton. Dalam laporan playlist, metrik tersebut menunjukkan berapa kali video 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
Berapa kali video 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 waktu tonton

watch_time_minutes (metrik inti)
Jumlah menit yang dihabiskan pengguna untuk 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 saat pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) menonton video.
average_view_duration_seconds (metrik inti)
Durasi rata-rata pemutaran video dalam detik. Mulai 13 Desember 2021, metrik ini tidak menyertakan traffic klip loop. Dalam laporan playlist, metrik tersebut menunjukkan durasi rata-rata pemutaran video yang terjadi dalam konteks playlist, dalam detik. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
Persentase rata-rata video ditonton selama pemutaran video. Mulai 13 Desember 2021, metrik ini tidak menyertakan traffic klip loop.

Metrik engagement

komentar (metrik inti)
Berapa kali 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)
Berapa kali pengguna menunjukkan bahwa mereka menyukai suatu video dengan memberikan rating positif. This is a core metric and is subject to the Deprecation Policy.
tidak suka (metrik inti)
Berapa kali pengguna menunjukkan bahwa mereka tidak menyukai suatu video dengan memberikan rating negatif. This is a core metric and is subject to the Deprecation Policy.
bagian (metrik inti)
Berapa kali 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)
Berapa kali 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 metrik subscribersLost, tetapi tidak menentukan nilai untuk metrik lainnya.
subscribers_lost (metrik inti)
Berapa kali pengguna berhenti berlangganan dari channel. This is a core metric and is subject to the Deprecation Policy.

Data untuk metrik ini dilaporkan sama seperti metrik subscribers_gained. Untuk mengidentifikasi jumlah pengguna yang berhenti berlangganan, tetapi tidak berhenti berlangganan di halaman tonton video, laporan aktivitas pengguna dasar berisi baris yang tidak menentukan nilai dimensi video_id. Baris tersebut juga menentukan nilai untuk metrik subscribers_gained, tetapi tidak menentukan nilai untuk metrik lainnya.
videos_added_to_playlists
Berapa kali video ditambahkan ke playlist YouTube. Video dapat ditambahkan ke playlist pemilik video atau ke playlist channel lain.

Nilai metrik mencakup berapa kali video ditambahkan ke playlist default seperti playlist "Tonton Nanti". Namun, metrik ini tidak menghitung playlist yang ditambahkan video secara otomatis, seperti playlist upload channel atau histori tontonan pengguna.

Metrik ini menampilkan angka mutlak, artinya jika pengguna menambahkan video ke playlist, menghapusnya, lalu menambahkannya lagi, nilai metrik mencerminkan video yang ditambahkan ke playlist dua kali. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014.
videos_removed_from_playlists
Berapa kali video dihapus dari playlist YouTube. Video dapat dihapus dari playlist pemilik video atau dari playlist channel lain.

Nilai metrik mencakup berapa kali video dihapus dari playlist default, seperti playlist "Tonton Nanti".

Metrik ini menampilkan angka mutlak, artinya jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya, nilai metrik mencerminkan video yang telah 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 dan tayangan pengguna 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 agregasi. 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 tampilan dan metrik waktu tonton dalam dokumen ini untuk mengetahui definisi metrik video gabungan yang didukung.

  • Metrik dalam playlist mencerminkan aktivitas dan interaksi pengguna dalam konteks halaman playlist. Metrik ini mencakup penayangan untuk semua video dalam playlist, terlepas dari channel yang memilikinya, tetapi hanya menghitung penayangan yang terjadi dalam konteks playlist.

Sebagian besar metrik yang tercantum di bawah ini adalah metrik dalam playlist; metrik lainnya dalam daftar, seperti metrik playlistSaves, adalah tentang interaksi pengguna dengan playlist itu sendiri, bukan dengan video dalam playlist. Dengan demikian, metrik tersebut tidak akan dikarakterisasi sebagai metrik video gabungan atau metrik dalam playlist.

playlist_starts
Berapa kali 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)
Berapa kali pengguna menyimpan playlist. Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut tentang playlist yang disimpan. Metrik ini menampilkan angka mutlak, artinya jika pengguna menyimpan playlist, menghapusnya dari daftar playlist yang disimpan, dan menyimpannya lagi, nilai metrik akan mencerminkan dua penyimpanan playlist yang ditambahkan.
playlist_saves_removed (hanya didukung di YouTube Reporting API)
Berapa kali pengguna menghapus playlist dari daftar playlist yang mereka simpan. Metrik ini menampilkan angka mutlak, artinya jika pengguna menyimpan playlist, menghapusnya dari daftar playlist yang disimpan, menyimpannya lagi, dan menghapusnya lagi, nilai metrik mencerminkan dua file yang disimpan di playlist dan telah dihapus.

Metrik anotasi

annotation_impressions
Jumlah total 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 jumlah total tayangan anotasi yang dapat diklik. This is a core metric and is subject to the Deprecation Policy. Pusat Bantuan YouTube memiliki informasi selengkapnya tentang 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 pelihat 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 terperinci untuk menambahkan kartu pada video Anda dan Laporan Kartu YouTube Analytics.

card_impressions
Berapa kali kartu ditampilkan. Saat panel kartu dibuka, tayangan kartu dicatat untuk setiap kartu video.
card_clicks
Berapa kali kartu diklik.
card_click_rate
Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik pada kartu terhadap tayangan kartu.
card_teaser_impressions
Berapa kali teaser kartu ditampilkan. Penayangan video dapat menghasilkan beberapa tayangan teaser.
card_teaser_clicks
Jumlah klik pada teaser kartu. Jumlah klik pada ikon kartu dikaitkan dengan teaser terakhir yang ditampilkan kepada pengguna.
card_teaser_click_rate
Rasio klik-tayang untuk teaser kartu, yang dihitung sebagai rasio klik pada teaser kartu dan total jumlah tayangan teaser kartu.

Metrik layar akhir

Layar akhir adalah elemen yang muncul pada 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 dan Laporan Layar Akhir YouTube Analytics.

Catatan: Data untuk metrik layar akhir tersedia mulai 1 Mei 2016.

end_screen_element_impressions
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.
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 retensi audiens

audience_retention_percentage
Rasio absolut jumlah penonton yang menonton video pada titik tertentu dalam video. Rasio ini dihitung dengan membandingkan berapa kali suatu bagian video ditonton dengan total jumlah penayangan video. Dimensi elapsed_video_time_percentage mengidentifikasi bagian video yang sesuai dengan metrik.

Perhatikan bahwa sebagian video dapat ditonton lebih dari satu kali (atau tidak sama sekali) dalam penayangan video tertentu. Misalnya, jika pengguna memundurkan dan menonton bagian yang sama dari video beberapa kali, maka rasio absolut untuk bagian video tersebut bisa lebih besar dari 1.

Contoh berikut menggambarkan cara penghitungan nilai:
  • Video berdurasi satu menit ditonton 100 kali. Setengah dari penonton berhenti menonton setelah 15 detik dan sisanya menonton video sampai selesai. Tidak ada penonton yang menonton bagian mana pun di video lebih dari sekali. Dalam hal ini, nilai metrik ini adalah 1 untuk bucket waktu pada kuartal pertama video, dan nilainya adalah 0.50 untuk sisa video tersebut.
  • Video berdurasi satu menit ditonton 100 kali. Semua penonton menonton keseluruhan video, tetapi 20 dari penonton menonton video sampai tanda 45 detik, kemudian melewati video kembali ke tanda 30 detik, kemudian menonton sisa video. Dalam hal ini, nilai metrik adalah 1 untuk bucket waktu pada paruh pertama atau kuartal terakhir video. Namun, nilainya akan menjadi 1.2 untuk periode waktu pada kuartal ketiga video karena 100 persen penonton menonton segmen video tersebut, tetapi 20% dari penonton tersebut menonton segmen tersebut dua kali.

Metrik estimasi pendapatan

Catatan: Metrik estimasi pendapatan dapat disesuaikan di akhir bulan dan tidak menyertakan iklan yang dijual dan ditayangkan oleh partner. Lihat Pusat Bantuan YouTube untuk mengetahui informasi dan catatan tambahan tentang estimasi angka pendapatan.

YouTube Reporting API melaporkan semua angka estimasi pendapatan dan penghasilan dalam USD.
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.

Estimasi metrik pendapatan tunduk pada penyesuaian akhir bulan dan tidak mencakup iklan yang dijual dan 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)
Total estimasi penghasilan (pendapatan bersih) dari iklan AdSense yang dijual lelang untuk rentang tanggal dan wilayah yang dipilih.
estimated_partner_ad_reserved_revenue (hanya didukung di YouTube Reporting API)
Total estimasi penghasilan (pendapatan bersih) dari iklan yang terjual melalui reservasi melalui DoubleClick (DCLK) dan sumber lainnya 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 melalui reservasi 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 dikenal sebagai 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 ditagih partner.

Metrik performa iklan

estimated_youtube_ad_revenue
Estimasi pendapatan kotor, dalam USD, dari semua iklan yang dijual Google atau 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 dalam pembagian kepemilikan dan perjanjian pembagian keuntungan Anda.
estimated_cpm
Estimasi pendapatan kotor per seribu tayangan iklan.
ad_impressions
Jumlah tayangan iklan terverifikasi yang ditayangkan.
estimated_monetized_playbacks
Frekuensi 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 dimulai. Estimasi kesalahan yang diharapkan untuk gambar ini adalah ±2,0%.
estimated_playback_based_cpm
Estimasi pendapatan kotor per seribu pemutaran.