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 estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah penayangan dan rating video (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 akan 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

tayangan (metrik inti)
Metrik ini menampilkan angka yang berbeda dalam berbagai jenis laporan:
  • Dalam laporan video, metrik ini menentukan frekuensi 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 milik pemilik channel.

    Dalam laporan ini, metrik playlistViews menunjukkan frekuensi video playlist tersebut ditonton dalam konteks playlist tertentu.
  • Dalam laporan playlist yang menggunakan dimensi isCurated, metrik ini menunjukkan frekuensi 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
Frekuensi 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 yang ditentukan. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Jumlah menit yang dihabiskan pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) untuk menonton video.
averageViewDuration (metrik inti)
Durasi rata-rata, dalam detik, pemutaran video. Mulai 13 Desember 2021, metrik ini mengecualikan traffic kliping 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 kliping 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.
saham (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 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)
Frekuensi pengguna berhenti berlangganan 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 dapat digunakan pengguna untuk berhenti berlangganan 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. Video tersebut dapat ditambahkan ke playlist pemilik video atau ke playlist channel lain.

Nilai metrik ini mencakup frekuensi video ditambahkan ke playlist default seperti playlist "Tonton Nanti". Namun, metrik ini tidak menghitung playlist yang otomatis menambahkan 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 akan mencerminkan video yang ditambahkan ke playlist dua kali. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014.
videosRemovedFromPlaylists
Frekuensi video dihapus dari playlist YouTube. Video tersebut 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, yang berarti jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya lagi, nilai metrik akan mencerminkan bahwa video tersebut 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. Metrik untuk video yang dimiliki channel lain tidak dihitung dalam agregasi. Akibatnya, jika channel membuat playlist yang hanya berisi video milik 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 yang tercantum di bawah 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 diklasifikasikan 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 mencakup penayangan playlist yang terjadi di web.
playlistAverageViewDuration
Estimasi durasi rata-rata, dalam detik, yang ditonton per penayangan playlist. Perhatikan bahwa metrik ini mewakili durasi rata-rata penayangan setiap video dalam playlist; metrik averageTimeInPlaylist, sebaliknya, mewakili 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 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
Jumlah total frekuensi pengguna menyimpan playlist. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang playlist tersimpan. Metrik ini menampilkan angka perubahan bersih, yang berarti bahwa jika pengguna menyimpan playlist, menghapusnya dari daftar playlist tersimpan, dan menyimpannya lagi, nilai metrik akan mencerminkan satu penyimpanan playlist yang ditambahkan.
playlistStarts
Frekuensi penonton memulai pemutaran playlist. Perhatikan bahwa metrik ini hanya mencakup 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
Frekuensi kartu 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
Frekuensi 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 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, nilai averageConcurrentViewers akan menentukan jumlah rata-rata penonton serentak selama segmen tertentu
peakConcurrentViewers
Jumlah maksimum penonton serentak untuk video tertentu. Jika dimensi livestreamPosition ditentukan untuk laporan, nilai peakConcurrentViewers akan menentukan jumlah puncak penonton serentak selama segmen tertentu dari video.

Metrik retensi audiens

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

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

Contoh berikut mengilustrasikan cara penghitungan nilai:
  • Video berdurasi satu menit ditonton 100 kali. Setengah penonton berhenti menonton setelah 15 detik dan sisanya menonton seluruh video. Tidak ada penonton yang menonton bagian mana pun dari 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 sisa video.
  • Video berdurasi satu menit ditonton 100 kali. Semua penonton menonton seluruh video, tetapi 20 penonton menonton hingga menit ke-45, lalu melompat kembali ke menit ke-30, lalu menonton sisa video. Dalam hal ini, nilai metriknya adalah 1 untuk bucket waktu di paruh pertama atau kuartal terakhir video. Namun, nilainya akan menjadi 1.2 untuk bucket waktu di 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 video pada titik tertentu dalam video. Titik dalam video disediakan oleh dimensi elapsedVideoTimeRatio.

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

Contoh hipotetis berikut mengilustrasikan bagaimana nilai tersebut 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, video berperforma 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.
startedWatching
Frekuensi segmen tertentu dari video menjadi segmen pertama yang dilihat selama pemutaran video.

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

Contoh ini akan menghasilkan nilai metrik tontonan berikut:
  • Nilai metrik startedWatching akan menjadi 1 untuk segmen 1 dan 24, dan nilai metrik akan menjadi 0 untuk semua segmen lainnya.
  • Nilai metrik stoppedWatching akan menjadi 1 untuk segmen 24 dan 100, dan nilai metrik akan menjadi 0 untuk semua segmen lainnya.
  • Nilai metrik totalSegmentImpressions akan menjadi 2 untuk segmen 24, dan nilai metrik akan menjadi 1 untuk semua segmen lainnya.
stoppedWatching
Frekuensi segmen tertentu dari video adalah segmen terakhir yang dilihat selama pemutaran video. Lihat definisi metrik startedWatching untuk contoh cara penghitungan nilai metrik ini.
totalSegmentImpressions
Frekuensi segmen tertentu dari video ditonton. Lihat definisi metrik startedWatching untuk mengetahui 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 yang ditentukan selama periode pelaporan.

Metrik estimasi pendapatan

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

Secara default, semua perkiraan angka pendapatan dilaporkan dalam USD. Namun, YouTube Analytics API mendukung parameter currency untuk beberapa estimasi pendapatan dan metrik 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 partner dan ditayangkan partner.
estimatedAdRevenue (sebelumnya bernama adEarnings)
Total estimasi pendapatan bersih dari semua sumber iklan yang dijual Google untuk rentang tanggal dan wilayah yang dipilih.

Metrik estimasi pendapatan tunduk kepada penyesuaian akhir bulan dan tidak termasuk 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 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 estimasi 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 error yang diharapkan untuk angka ini adalah ±2,0%.
playbackBasedCpm
Estimasi pendapatan kotor per seribu pemutaran.