Dokumen ini menjelaskan 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 video dan rating (suka dan tidak suka).
Metrik utama
Meskipun YouTube Analytics API tunduk pada Kebijakan Penghentian Layanan yang ditetapkan 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 diidentifikasi secara eksplisit sebagai metrik inti.
Daftar di bawah mengidentifikasi metrik inti API.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk mengetahui informasi selengkapnya.
Lihat metrik
- engagedViews (metrik inti)
- Frekuensi video channel ditonton setelah frame pertama, atau pengguna mengklik/mengetuk untuk memutar.
- penayangan (metrik inti)
- Metrik ini menampilkan angka yang berbeda dalam berbagai jenis laporan. Metrik ini mencakup penayangan bersama saat beberapa orang menonton bersama di layar televisi.
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. Metrik ini mencakup penayangan bersama saat beberapa orang menonton bersama di layar televisi. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- Jumlah menit pelanggan YouTube Premium (sebelumnya dikenal sebagai YouTube Red) menonton video.
- averageViewDuration (metrik inti)
- Durasi rata-rata, dalam detik, pemutaran video. 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
- comments (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.
- dislikes (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.
- Berapa kali 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)
- Jumlah berapa kali 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 dimensivideoatau parameterfilteruntuk membatasi respons agar hanya menyertakan data untuk video tertentu, metriksubscribersGainedhanya akan menyertakan statistik dari halaman tonton video yang ditentukan. - subscribersLost (metrik inti)
- Frekuensi pengguna berhenti subscribe ke channel. This is a core metric and is subject to the Deprecation Policy.
Data untuk metrik ini dilaporkan dengan cara yang mirip dengan metriksubscribersGained. Dalam laporan channel, metrik ini mencakup subscriber yang hilang melalui mekanisme apa pun yang memungkinkan pengguna berhenti subscribe ke channel. Namun, dalam laporan yang menggunakan dimensivideoatau parameterfilteruntuk membatasi respons agar hanya menyertakan data untuk video tertentu, metrik ini hanya menyertakan pengguna yang berhenti subscribe dari halaman tonton video yang ditentukan. - videosAddedToPlaylists
- Frekuensi video ditambahkan ke playlist YouTube apa pun. Video tersebut mungkin telah 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 ditambahi 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
- Berapa kali video dihapus dari playlist YouTube mana pun. Video tersebut mungkin telah 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 video yang dihapus dari playlist sebanyak 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 oleh 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 interaksi 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 lainnya dalam daftar, seperti
metrik playlistSaves, adalah tentang interaksi pengguna dengan playlist itu sendiri dan
bukan dengan video dalam playlist. Oleh karena itu, metrik tersebut tidak akan dikategorikan sebagai metrik video gabungan atau metrik dalam playlist.
- averageTimeInPlaylist
- Estimasi durasi rata-rata, dalam menit, penonton 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 durasi rata-rata penayangan setiap video dalam playlist; sebaliknya,
metrik
averageTimeInPlaylistmenunjukkan 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 bersih berapa kali 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 akan mencerminkan satu penambahan playlist tersimpan.
- playlistStarts
- Berapa kali 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 per 16 Juli 2013.
- annotationImpressions
- Total jumlah 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 tertutup.
- annotationCloseRate (metrik inti)
- Rasio anotasi yang ditutup penonton 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 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.
- Frekuensi teaser kartu ditampilkan. Satu penayangan 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 livestream (penonton serentak)
- averageConcurrentViewers
- Jumlah rata-rata penonton serentak untuk video tertentu. Metrik ini mencakup
co-viewer saat beberapa orang menonton bersama di layar televisi. Jika dimensi livestreamPosition
ditentukan untuk laporan, nilai
averageConcurrentViewersakan menentukan jumlah rata-rata penonton serentak selama segmen tertentu - peakConcurrentViewers
- Jumlah puncak penonton serentak untuk video tertentu. Metrik ini mencakup
co-viewer saat beberapa orang menonton bersama di layar televisi. Jika dimensi livestreamPosition
ditentukan untuk laporan, nilai
peakConcurrentViewersakan 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 bagian video ditonton dengan total jumlah penayangan video. Dimensi
elapsedVideoTimeRatiomengidentifikasi 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 memutar ulang dan menonton bagian video yang sama beberapa kali, rasio absolut untuk bagian video tersebut dapat lebih besar dari1.
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 mana pun dari video lebih dari sekali. Dalam hal ini, nilai metrik ini adalah
1untuk bucket waktu di seperempat bagian awal video, dan nilainya adalah0.50untuk sisa video. - Video berdurasi satu menit ditonton 100 kali. Semua penonton menonton keseluruhan video, tetapi 20 penonton menonton hingga detik ke-45, lalu kembali ke detik ke-30, dan menonton sisa video. Dalam hal ini, nilai metriknya adalah
1untuk bucket waktu di paruh pertama atau kuartal terakhir video. Namun, nilainya akan menjadi1.2untuk bucket waktu di kuartal ketiga video karena 100 persen penonton menonton segmen video tersebut, tetapi 20% dari penonton tersebut menonton segmen tersebut dua kali.
- 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 mana pun dari video lebih dari sekali. Dalam hal ini, nilai metrik ini adalah
- relativeRetentionPerformance
- Pengukuran yang menunjukkan seberapa baik video mempertahankan penonton selama pemutaran dibandingkan dengan semua video YouTube yang berdurasi sama. Metrik ini memiliki nilai antara
0dan1yang mengidentifikasi performa retensi relatif video pada titik tertentu dalam video. Titik dalam video disediakan oleh dimensielapsedVideoTimeRatio.
Nilai0menunjukkan bahwa video mempertahankan penonton lebih buruk daripada video lain dengan durasi serupa, sedangkan nilai1menunjukkan bahwa video mempertahankan penonton lebih baik daripada video lain dengan durasi serupa. Nilai median0.5menunjukkan bahwa setengah dari video dengan durasi serupa mempertahankan penonton dengan lebih baik, sementara setengahnya lagi mempertahankan penonton dengan 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 tertentu berdurasi 10 menit, hanya 80 persen penonton yang masih menonton setelah tiga menit, tetapi semua penonton tersebut masih menonton setelah delapan menit.- Pada nilai
elapsedVideoTimeRatioyang sesuai dengan titik tiga menit dalam video, metrikrelativeRetentionPerformanceakan memiliki nilai di bawah0.5karena, pada saat itu, video berperforma lebih buruk daripada video rata-rata. - Pada nilai
elapsedVideoTimeRatioyang sesuai dengan titik delapan menit dalam video, metrikrelativeRetentionPerformanceakan memiliki nilai yang lebih tinggi daripada0.5karena, pada saat itu, video tersebut berperforma lebih baik daripada video lain dengan durasi yang sama.
- Pada nilai
- 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 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 watch berikut:- Nilai metrik
startedWatchingakan menjadi1untuk segmen 1 dan 24, dan nilai metrik akan menjadi0untuk semua segmen lainnya. - Nilai metrik
stoppedWatchingakan menjadi1untuk segmen 24 dan 100, dan nilai metrik akan menjadi0untuk semua segmen lainnya. - Nilai metrik
totalSegmentImpressionsakan menjadi2untuk segmen 24, dan nilai metrik akan menjadi1untuk semua segmen lainnya.
- Nilai metrik
- stoppedWatching
- Frekuensi segmen tertentu dari video menjadi segmen terakhir yang dilihat selama
pemutaran video. Lihat definisi metrik
startedWatchinguntuk mengetahui contoh cara penghitungan nilai metrik ini. - totalSegmentImpressions
- Frekuensi segmen tertentu dari video ditonton. Lihat definisi metrik
startedWatchinguntuk 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 pada 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 estimasi pendapatan.
currency untuk beberapa metrik 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 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.
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 ini 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 berapa kali 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.