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 aktivitas pengguna, performa iklan, atau perkiraan pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah penayangan video dan rating (suka dan tidak suka).

Metrik utama

Meskipun YouTube Analytics API tunduk pada Kebijakan Penghentian Penggunaan yang ditentukan dalam Persyaratan Layanan, metrik non-inti (dan dimensi non-inti) tidak tunduk pada kebijakan tersebut. Dalam definisi di halaman ini, setiap metrik inti diidentifikasi secara eksplisit sebagai metrik inti.

Daftar di bawah mengidentifikasi metrik inti API.

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

Lihat metrik

engagedViews (metrik inti)
Frekuensi video channel ditonton setelah beberapa detik awal.
penayangan (metrik inti)
Metrik ini menampilkan angka yang berbeda dalam berbagai jenis laporan. This is a core metric and is subject to the Deprecation Policy.
playlistViews
Metrik ini ditentukan di bagian metrik playlist.
redViews
Jumlah berapa kali video ditonton oleh pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red).
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 pengguna 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 video yang ditonton oleh pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red).
averageViewDuration (metrik inti)
Durasi rata-rata pemutaran video dalam detik. Mulai 13 Desember 2021, metrik ini mengecualikan 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.
averageViewPercentage
Persentase rata-rata video yang ditonton selama pemutaran video. Mulai 13 Desember 2021, metrik ini mengecualikan traffic klip berulang.

Metrik engagement

komentar (metrik inti)
Frekuensi pengguna mengomentari video. Lihat 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 memberikan 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.
pembagian (metrik inti)
Frekuensi pengguna 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.
subscribersGained (metrik inti)
Frekuensi pengguna 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. Dalam laporan channel, metrik ini mencakup subscriber yang diperoleh dari salah satu tempat ini. 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)
Frekuensi pengguna berhenti berlangganan dari suatu channel. This is a core metric and is subject to the Deprecation Policy.

Data untuk metrik ini dilaporkan dengan cara yang sama seperti metrik subscribersGained. Dalam laporan channel, metrik ini mencakup subscriber yang hilang melalui mekanisme apa pun yang memungkinkan pengguna berhenti berlangganan dari 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
Frekuensi video ditambahkan ke playlist YouTube mana pun. Video tersebut mungkin telah ditambahkan ke playlist pemilik video atau ke playlist channel lain.

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

Metrik ini menampilkan angka absolut, yang berarti 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
Jumlah berapa kali video dihapus dari playlist YouTube. Video tersebut mungkin telah dihapus dari playlist pemilik video atau dari playlist channel lain.

Nilai metrik mencakup jumlah video yang dihapus dari playlist default seperti playlist "Tonton Nanti".

Metrik ini menampilkan angka absolut, yang berarti jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya lagi, nilai metrik 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 penggabungan. Akibatnya, 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. Dengan demikian, metrik tersebut tidak akan dikategorikan sebagai metrik video gabungan atau metrik dalam playlist.

averageTimeInPlaylist
Estimasi rata-rata jumlah waktu, dalam menit, yang dihabiskan penonton untuk menonton video dalam playlist setelah playlist dimulai. Perhatikan bahwa metrik ini hanya mencakup penayangan playlist yang terjadi di web.
playlistAverageViewDuration
Estimasi durasi rata-rata, dalam detik, yang ditonton per penayangan playlist. Perhatikan bahwa metrik ini menunjukkan rata-rata durasi penayangan setiap video dalam playlist; metrik averageTimeInPlaylist, sebaliknya, menunjukkan rata-rata waktu yang dihabiskan setiap penonton untuk menonton playlist secara keseluruhan. Metrik ini mencakup data untuk video playlist yang dimiliki oleh channel lain.
playlistEstimatedMinutesWatched
Jumlah menit 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 pengguna menyimpan playlist. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang playlist tersimpan. Metrik ini menampilkan angka perubahan bersih, yang berarti jika pengguna menyimpan playlist, menghapusnya dari daftar playlist tersimpan, dan menyimpannya lagi, nilai metrik mencerminkan satu penyimpanan playlist yang ditambahkan.
playlistStarts
Jumlah berapa kali penonton memulai pemutaran playlist. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
playlistViews
Frekuensi 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 mencakup penayangan playlist yang terjadi di web.

Metrik anotasi

Catatan: Laporan YouTube Analytics API hanya menampilkan data untuk metrik annotationClickThroughRate dan annotationCloseRate mulai 10 Juni 2012. Selain itu, laporan YouTube Analytics API hanya menampilkan data untuk metrik anotasi yang tersisa mulai 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 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.
annotationClosableImpressions
Jumlah anotasi yang muncul dan dapat ditutup.
annotationCloses
Jumlah anotasi yang ditutup.
annotationCloseRate (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.

cardImpressions
Jumlah kartu yang ditampilkan. Saat panel kartu dibuka, tayangan kartu akan dicatat untuk setiap kartu video.
cardClicks
Frekuensi kartu diklik.
cardClickRate
Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik kartu terhadap tayangan kartu.
cardTeaserImpressions
Jumlah frekuensi teaser kartu ditampilkan. Penayangan video dapat menghasilkan beberapa tayangan promosi.
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 terhadap total jumlah tayangan teaser kartu.

Metrik live stream (penonton serentak)

averageConcurrentViewers
Jumlah rata-rata penonton serentak untuk video tertentu. Jika dimensi livestreamPosition ditentukan untuk laporan, maka nilai averageConcurrentViewers menentukan jumlah rata-rata penonton serentak selama segmen tertentu
peakConcurrentViewers
Jumlah maksimum penonton serentak untuk video tertentu. Jika dimensi livestreamPosition ditentukan untuk laporan, maka nilai peakConcurrentViewers menentukan jumlah puncak penonton serentak selama segmen video tertentu.

Metrik retensi audiens

audienceWatchRatio
Rasio absolut penonton yang menonton video pada titik tertentu dalam video. Rasio ini dihitung dengan membandingkan frekuensi sebagian video ditonton dengan total jumlah penayangan video. Dimensi elapsedVideoTimeRatio mengidentifikasi bagian video yang sesuai dengan metrik.

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

Contoh berikut mengilustrasikan cara penghitungan nilai:
  • Video berdurasi satu menit ditonton 100 kali. Setengah dari penonton berhenti menonton setelah 15 detik dan sisanya menonton seluruh video. Tidak ada penonton yang menonton bagian video lebih dari sekali. Dalam hal ini, nilai metrik ini adalah 1 untuk bucket waktu di seperempat bagian awal video, dan nilainya adalah 0.50 untuk bagian video lainnya.
  • Video berdurasi satu menit ditonton 100 kali. Semua penonton menonton seluruh video, tetapi 20 penonton menonton hingga tanda 45 detik video, lalu melewati kembali ke tanda 30 detik video, dan kemudian menonton sisa video. Dalam hal ini, nilai metriknya adalah 1 untuk bucket waktu di paruh pertama atau kuartal terakhir video. Namun, nilainya adalah 1.2 untuk rentang waktu di kuartal ketiga video karena 100% 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 durasinya sama. Metrik ini memiliki nilai antara 0 dan 1 yang mengidentifikasi performa retensi relatif video pada titik tertentu dalam video. Titik dalam video diberikan oleh dimensi elapsedVideoTimeRatio.

Nilai 0 menunjukkan bahwa video mempertahankan penonton lebih buruk daripada video lain yang durasinya sama, sedangkan nilai 1 menunjukkan bahwa video mempertahankan penonton lebih baik daripada video lain yang durasinya sama. Nilai median 0.5 menunjukkan bahwa setengah dari video dengan durasi yang sama lebih baik dalam mempertahankan penonton, sementara setengahnya lebih buruk.

Contoh hipotetis berikut menggambarkan bagaimana nilai dapat muncul 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 tertentu, hanya 80 persen penonton yang masih menonton setelah tiga menit, tetapi semua penonton tersebut masih menonton setelah delapan menit.
  • Pada nilai elapsedVideoTimeRatio yang sesuai dengan titik tiga menit ke dalam video, metrik relativeRetentionPerformance akan memiliki nilai di bawah 0.5 karena, pada saat itu, performa video lebih buruk daripada video rata-rata.
  • Pada nilai elapsedVideoTimeRatio yang sesuai dengan titik yang berada delapan menit ke dalam video, metrik relativeRetentionPerformance akan memiliki nilai yang lebih tinggi daripada 0.5 karena, pada saat itu, video berperforma lebih baik daripada video lain dengan durasi serupa.
startedWatching
Frekuensi segmen tertentu video menjadi segmen pertama yang dilihat selama pemutaran video.

Misalnya, anggaplah durasi Video X adalah 5 menit. Untuk tujuan laporan ini, YouTube membagi video menjadi 100 segmen 3 detik, yang diidentifikasi dengan dimensi elapsedVideoTimeRatio. Penonton membuka YouTube dan menonton satu menit sepuluh detik pertama video, yang mencakup semua atau sebagian dari 24 segmen pertama video. Pada kunjungan YouTube berikutnya, penonton menonton sisa video, melanjutkan pemutaran di segmen 24 dan berlanjut hingga segmen 100.

Contoh ini akan menghasilkan nilai metrik jam tangan berikut:
  • Nilai metrik startedWatching adalah 1 untuk segmen 1 dan 24, dan nilai metrik adalah 0 untuk semua segmen lainnya.
  • Nilai metrik stoppedWatching adalah 1 untuk segmen 24 dan 100, dan nilai metriknya adalah 0 untuk semua segmen lainnya.
  • Nilai metrik totalSegmentImpressions adalah 2 untuk segmen 24, dan nilai metriknya adalah 1 untuk semua segmen lainnya.
stoppedWatching
Frekuensi segmen video tertentu menjadi segmen terakhir yang dilihat selama pemutaran video. Lihat definisi metrik startedWatching untuk mengetahui contoh cara penghitungan nilai metrik ini.
totalSegmentImpressions
Frekuensi segmen tertentu video ditonton. Lihat definisi metrik startedWatching untuk contoh cara penghitungan nilai metrik ini. Perhatikan bahwa penonton dapat menonton segmen video yang sama beberapa kali dalam pemutaran yang sama.

Metrik pembatalan langganan

membershipsCancellationSurveyResponses
Jumlah survei yang diselesaikan oleh pengguna YouTube yang membatalkan langganan channel untuk channel tertentu selama periode pelaporan.

Metrik estimasi pendapatan

Catatan: Metrik estimasi pendapatan tunduk kepada penyesuaian akhir bulan dan tidak mencakup iklan yang dijual dan ditayangkan oleh partner. Lihat Pusat Bantuan YouTube untuk mengetahui informasi dan catatan tambahan tentang angka perkiraan pendapatan.

Secara default, semua perkiraan 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 tunduk kepada penyesuaian 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 oleh Google untuk rentang tanggal dan wilayah yang dipilih.

Metrik estimasi pendapatan tunduk kepada 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 disesuaikan pada akhir bulan.

Metrik performa iklan

grossRevenue
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 dikenakan penyesuaian akhir bulan dan tidak termasuk iklan yang ditayangkan partner. Pendapatan kotor tidak boleh disamakan dengan perkiraan pendapatan, atau pendapatan bersih, yang memperhitungkan bagian 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
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. Perkiraan kesalahan yang diharapkan untuk angka ini adalah ±2,0%.
playbackBasedCpm
Estimasi pendapatan kotor per seribu pemutaran.