Metrics

Dokumen ini menentukan metrik yang dapat Anda ambil menggunakan YouTube Analytics API. API ini mendukung kueri real-time untuk membuat laporan YouTube Analytics kustom.

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 Analytics 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, setiap metrik yang merupakan metrik inti secara eksplisit diidentifikasi seperti itu.

Daftar di bawah ini mengidentifikasi metrik inti API.

Catatan: Metrik inti berikut sepenuhnya tidak digunakan lagi:
  • Metrik inti earnings tidak digunakan lagi pada tanggal 4 Agustus 2016, dan mengganti nama estimatedRevenue. Sesuai dengan Kebijakan Penghentian Layanan yang ditetapkan dalam Persyaratan Layanan, metrik earnings dan estimatedRevenue secara serentak didukung hingga 10 Agustus 2017.
  • Metrik inti favoritesAdded dan favoritesRemoved tidak digunakan lagi pada 31 Maret 2015. Metrik ini hanya dapat diambil melalui YouTube Analytics API.

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

Melihat metrik

penayangan (metrik inti)
Metrik ini mewakili angka yang berbeda di berbagai jenis laporan:
  • Dalam laporan video, metrik ini menentukan berapa kali video ditonton.
  • Dalam laporan playlist yang tidak menggunakan dimensi isCurated, metrik ini menentukan jumlah total penayangan untuk video dalam playlist, terlepas dari apakah penayangan tersebut terjadi dalam konteks playlist atau tidak. Perhatikan bahwa nilai metrik hanya mencakup penayangan video pemilik channel.

    Dalam laporan ini, metrik playlistViews menunjukkan frekuensi video dari playlist tersebut ditonton dalam konteks playlist tertentu.
  • Dalam laporan playlist yang menggunakan dimensi isCurated, metrik ini menunjukkan berapa kali video ditonton dalam konteks playlist tertentu. Perhatikan bahwa metrik playlistViews tidak didukung untuk laporan ini.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Metrik ini ditentukan di bagian metrik playlist.
redViews
Berapa kali video ditonton oleh pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red).
uniques (tidak digunakan lagi mulai 27 September 2016)
Jumlah penonton unik yang menonton video. Penghitungan ini didasarkan pada jumlah cookie unik dan, oleh karena itu, akan menghitung lebih banyak pengguna yang menggunakan beberapa perangkat atau browser.
Metrik uniques tidak digunakan lagi pada tanggal 27 September 2016. Metrik ini bukan metrik inti dan akan didukung hingga 31 Oktober 2016.
viewerPercentage (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

estimatedMinutesWatched (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.
estimatedRedMinutesWatched
Jumlah menit saat pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) menonton video.
averageViewDuration (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.
averageViewPercentage
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.
subscribersGained (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. Dalam laporan channel, metrik ini menyertakan subscriber yang diperoleh dari salah satu tempat tersebut. Namun, dalam laporan yang menggunakan dimensi video atau parameter filter untuk membatasi respons agar hanya menyertakan data untuk video tertentu, metrik subscribersGained hanya akan menyertakan statistik dari halaman tonton video yang ditentukan.
subscribersLost (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 subscribersGained. Di laporan channel, metrik ini mencakup pelanggan yang hilang melalui mekanisme yang dapat digunakan pengguna untuk berhenti berlangganan dari suatu channel. Namun, dalam laporan yang menggunakan dimensi video atau parameter filter untuk membatasi respons agar hanya menyertakan data untuk video tertentu, metrik ini hanya menyertakan pengguna yang berhenti berlangganan dari halaman tonton video yang ditentukan.
videosAddedToPlaylists
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.
videosRemovedFromPlaylists
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 engagement yang tidak digunakan lagi

Kedua metrik berikut adalah metrik inti yang tidak digunakan lagi pada tanggal 31 Maret 2015.

favoritesAdded (metrik inti) (tidak digunakan lagi mulai 31 Maret 2015)
Berapa kali pengguna menandai video sebagai video favorit. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (metrik inti) (tidak digunakan lagi mulai 31 Maret 2015)
Berapa kali pengguna menghapus video dari daftar video favorit mereka. Buka Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya. This is a core metric and is subject to the Deprecation Policy.

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.

averageTimeInPlaylist
Estimasi jumlah waktu rata-rata, dalam menit, yang dihabiskan penonton untuk menonton video dalam playlist setelah playlist dimulai. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
playlistAverageViewDuration
Estimasi durasi rata-rata, dalam detik, ditonton per penayangan playlist. Perhatikan bahwa metrik ini merepresentasikan durasi rata-rata penayangan setiap video dalam playlist; sedangkan metrik averageTimeInPlaylist merepresentasikan waktu rata-rata yang dihabiskan setiap penonton untuk menonton playlist secara keseluruhan. Metrik ini mencakup data untuk video playlist yang dimiliki oleh channel lain.
playlistEstimatedMinutesWatched
Jumlah menit saat pengguna menonton konten playlist sebagai bagian dari playlist. Waktu tonton yang terjadi dalam konteks lain—misalnya, waktu tonton dari penayangan yang terjadi saat penonton menonton video yang sama sebagai bagian dari playlist lain—tidak dihitung. Metrik ini mencakup data untuk video playlist yang dimiliki oleh channel lain.
playlistSaves
Frekuensi bersih berapa kali pengguna menyimpan playlist. Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut tentang playlist yang disimpan. Metrik ini menampilkan jumlah perubahan bersih, yang berarti bahwa jika pengguna menyimpan playlist, menghapusnya dari daftar playlist yang disimpan, dan menyimpannya lagi, nilai metrik akan mencerminkan satu penyimpanan playlist yang ditambahkan.
playlistStarts
Berapa kali penonton memulai pemutaran playlist. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
playlistViews
Berapa kali video dalam playlist ditonton dalam konteks playlist tersebut. Metrik ini mencakup data untuk video playlist yang dimiliki oleh channel lain.
viewsPerPlaylistStart
Jumlah rata-rata penayangan video yang terjadi setiap kali playlist dimulai. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.

Metrik anotasi

Catatan: Laporan YouTube Analytics API hanya menampilkan data untuk metrik annotationClickThroughRate dan annotationCloseRate per 10 Juni 2012. Selain itu, laporan YouTube Analytics API hanya menampilkan data untuk metrik anotasi yang tersisa per 16 Juli 2013.

annotationImpressions
Jumlah total tayangan anotasi.
annotationClickableImpressions
Jumlah anotasi yang muncul dan dapat diklik.
annotationClicks
Jumlah anotasi yang diklik.
annotationClickThroughRate (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.
annotationClosableImpressions
Jumlah anotasi yang muncul dan dapat ditutup.
annotationCloses
Jumlah anotasi yang ditutup.
annotationCloseRate (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.

cardImpressions
Berapa kali kartu ditampilkan. Saat panel kartu dibuka, tayangan kartu dicatat untuk setiap kartu video.
cardClicks
Berapa kali kartu diklik.
cardClickRate
Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik pada kartu terhadap tayangan kartu.
cardTeaserImpressions
Berapa kali teaser kartu ditampilkan. Penayangan video dapat menghasilkan beberapa tayangan teaser.
cardTeaserClicks
Jumlah klik pada teaser kartu. Jumlah klik pada ikon kartu dikaitkan dengan teaser terakhir yang ditampilkan kepada pengguna.
cardTeaserClickRate
Rasio klik-tayang untuk teaser kartu, yang dihitung sebagai rasio klik pada teaser kartu dan total jumlah tayangan teaser kartu.

Metrik retensi audiens

audienceWatchRatio
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 elapsedVideoTimeRatio 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.
relativeRetentionPerformance
Pengukuran yang menunjukkan seberapa baik video mempertahankan penonton selama pemutaran dibandingkan dengan semua video YouTube yang berdurasi hampir sama. Metrik ini memiliki nilai antara 0 dan 1 yang mengidentifikasi performa retensi relatif pada video pada titik tertentu dalam video. Titik dalam video disediakan oleh dimensi elapsedVideoTimeRatio.

Nilai 0 menunjukkan bahwa video ini mempertahankan penonton dengan lebih buruk daripada video lain dengan durasi serupa, sedangkan nilai 1 menunjukkan bahwa video ini mempertahankan penonton dengan lebih baik daripada video lain dengan durasi yang serupa. Nilai median 0.5 menunjukkan bahwa setengah dari video dengan durasi yang serupa mempertahankan penonton dengan lebih baik, sementara separuhnya mempertahankan penonton dengan lebih buruk.

Contoh hipotesis berikut menggambarkan tampilan nilai dalam laporan. Rata-rata, 90 persen penonton yang menonton video berdurasi 10 menit masih menonton setelah tiga menit dan 70 persen masih menonton setelah delapan menit. Namun, untuk video berdurasi 10 menit, hanya 80 persen penonton yang masih menonton setelah tiga menit, tetapi semua penonton masih menonton setelah delapan menit.
  • Pada nilai elapsedVideoTimeRatio yang sesuai dengan poin yang berjarak tiga menit setelah video diputar, metrik relativeRetentionPerformance akan memiliki nilai di bawah 0.5 karena pada saat itu, performa video tersebut lebih buruk daripada video rata-rata.
  • Pada nilai elapsedVideoTimeRatio yang sesuai dengan titik delapan menit ke dalam video, metrik relativeRetentionPerformance akan memiliki nilai yang lebih tinggi dari 0.5 karena, pada saat itu, video berperforma lebih baik daripada video lain dengan durasi yang serupa.

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.

Secara default, semua estimasi angka pendapatan dilaporkan dalam USD. Namun, YouTube Analytics API mendukung parameter currency untuk beberapa metrik estimasi pendapatan dan performa iklan, sehingga Anda dapat mengambil data estimasi pendapatan dalam mata uang lain.
estimatedRevenue (metrik inti) (sebelumnya bernama earnings)
Total estimasi pendapatan bersih dari semua sumber iklan yang dijual Google serta dari sumber non-iklan untuk rentang tanggal dan wilayah yang dipilih. This is a core metric and is subject to the Deprecation Policy.

Metrik estimasi pendapatan dapat disesuaikan hingga akhir bulan dan tidak mencakup iklan yang dijual dan ditayangkan oleh partner.
estimatedAdRevenue (sebelumnya bernama adEarnings)
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.
estimatedRedPartnerRevenue (sebelumnya bernama redPartnerRevenue)
Total estimasi pendapatan yang diperoleh dari langganan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) untuk dimensi laporan yang dipilih. Nilai metrik mencerminkan pendapatan dari konten musik dan non-musik serta dapat dikenai penyesuaian akhir bulan.

Metrik performa iklan

grossRevenue
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.
cpm (sebelumnya bernama impressionBasedCpm)
Estimasi pendapatan kotor per seribu tayangan iklan.
adImpressions (sebelumnya bernama impressions)
Jumlah tayangan iklan terverifikasi yang ditayangkan.
monetizedPlaybacks
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%.
playbackBasedCpm
Estimasi pendapatan kotor per seribu pemutaran.