Metrics

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

Metrik adalah pengukuran individual dari aktivitas pengguna, performa iklan, atau estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah penayangan video dan rating (suka dan tidak suka).

Metrik inti

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

Daftar di bawah ini mengidentifikasi metrik inti API.

Catatan: Metrik inti berikut tidak digunakan lagi sepenuhnya:
  • Metrik inti earnings tidak digunakan lagi pada 4 Agustus 2016, dan berganti nama menjadi estimatedRevenue. Sesuai dengan Kebijakan Penghentian Layanan yang ditetapkan dalam Persyaratan Layanan, metrik earnings dan estimatedRevenue secara bersamaan 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 informasi selengkapnya.

Lihat metrik

tampilan (metrik inti)
Frekuensi video ditonton. Dalam laporan playlist, metrik menunjukkan frekuensi video ditonton dalam konteks playlist. Pusat Bantuan YouTube memberikan informasi tambahan tentang cara pelaporan jumlah penayangan. This is a core metric and is subject to the Deprecation Policy.
Tampilan merah
Frekuensi video ditonton oleh pelanggan YouTube Premium (sebelumnya disebut YouTube Red).
unik (tidak digunakan lagi 27 September 2016)
Jumlah penonton unik yang menonton video. Penghitungan ini didasarkan pada jumlah cookie unik dan, oleh karena itu, akan menghitung lebih dari 1 pengguna yang menggunakan beberapa perangkat atau browser.
Metrik uniques tidak digunakan lagi mulai 27 September 2016. 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 pengguna menonton video untuk channel, pemilik konten, video, atau playlist tertentu. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesTontonan
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 tidak mencakup traffic klip berulang. Dalam laporan playlist, metrik menunjukkan rata-rata durasi pemutaran video yang terjadi dalam konteks playlist dalam hitungan detik. 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 tidak mencakup traffic klip berulang.

Metrik engagement

komentar (metrik inti)
Frekuensi 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)
Frekuensi pengguna menunjukkan bahwa mereka menyukai video dengan memberinya 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.
bagian (metrik inti)
Frekuensi 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.
subscribersDiperoleh (metrik inti)
Frekuensi 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 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 sebuah channel. This is a core metric and is subject to the Deprecation Policy.

Data untuk metrik ini dilaporkan mirip dengan metrik subscribersGained. Dalam laporan channel, metrik ini menyertakan subscriber yang hilang melalui mekanisme yang memungkinkan pengguna untuk unsubscribe 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.
videosAddedToPlaylist
Frekuensi video ditambahkan ke playlist YouTube mana pun. Video dapat ditambahkan ke playlist pemilik video atau di playlist channel lain.

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

Metrik ini menampilkan angka absolut, artinya jika pengguna menambahkan video ke playlist, lalu 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.
videosRemovedFromPlaylist
Frekuensi video dihapus dari playlist YouTube mana pun. Video 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, artinya jika pengguna menambahkan video ke playlist, menghapusnya, menambahkannya lagi, lalu menghapusnya lagi, nilai metrik mencerminkan video yang dihapus dua kali dari playlist. Data untuk metrik ini tidak tersedia untuk tanggal sebelum 1 Oktober 2014.

Metrik engagement yang tidak digunakan lagi

Metrik berikut merupakan metrik inti yang tidak digunakan lagi pada 31 Maret 2015.

favoritesAdded (metrik inti) (tidak digunakan lagi 31 Maret 2015)
Frekuensi 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 31 Maret 2015)
Frekuensi 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

playlistStarts
Frekuensi penonton memulai pemutaran playlist. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
viewsPerPlaylistStart
Jumlah rata-rata penayangan video yang terjadi setiap kali playlist dimulai. Perhatikan bahwa metrik ini hanya menyertakan penayangan playlist yang terjadi di web.
averageTimeInPlaylist
Estimasi jumlah waktu rata-rata, dalam menit, saat penonton menonton video dalam playlist setelah 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.

annotationImpression
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 lebih lanjut 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 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 dan Laporan Kartu YouTube Analytics.

cardImpression
Frekuensi kartu ditampilkan. Saat panel kartu dibuka, tayangan kartu akan dicatat untuk setiap kartu video.
cardClicks
Frekuensi kartu diklik.
KartuKlikRasio
Rasio klik-tayang untuk kartu, yang dihitung sebagai rasio klik kartu terhadap tayangan kartu.
CardTeaserImpressions
Frekuensi teaser kartu ditampilkan. Jumlah tontonan 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 teaser kartu, yang dihitung sebagai rasio klik pada teaser kartu terhadap jumlah total tayangan teaser kartu.

Metrik retensi audiens

audienceWatchRatio
Rasio mutlak penonton yang menonton video pada titik tertentu dalam video. Rasio ini dihitung dengan membandingkan berapa kali bagian video telah ditonton terhadap total jumlah penayangan video. Dimensi elapsedVideoTimeRatio mengidentifikasi bagian video yang sesuai dengan metrik.

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

Contoh berikut menggambarkan cara penghitungan nilai:
  • Video satu menit ditonton sebanyak 100 kali. Setengah dari penonton berhenti menonton setelah 15 detik dan sisanya menonton keseluruhan video. Tidak ada penonton yang menonton bagian video yang lebih dari sekali. Dalam kasus ini, nilai metrik ini adalah 1 untuk bucket waktu pada kuartal pertama video, dan nilainya adalah 0.50 untuk sisa video.
  • Video satu menit ditonton sebanyak 100 kali. Semua penonton menonton keseluruhan video, tetapi 20 penonton menontonnya hingga durasi video 45 detik, lalu melewatinya ke detik 30 detik, lalu 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 rentang waktu pada kuartal ketiga video sejak 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 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 dibandingkan video lain dengan durasi serupa, sedangkan nilai 1 menunjukkan bahwa video mempertahankan penonton lebih baik daripada video lain dengan durasi serupa. Nilai median 0.5 menunjukkan bahwa separuh video dengan durasi serupa mempertahankan penonton dengan lebih baik, sementara separuh video mempertahankan penonton dengan kualitas yang lebih buruk.

Contoh hipotesis berikut menggambarkan bagaimana nilai tersebut dapat muncul dalam laporan. Rata-rata, 90% 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% 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 pada 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 pada 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 yang serupa.

Metrik estimasi pendapatan

Catatan: Metrik estimasi pendapatan tunduk pada penyesuaian akhir bulan serta tidak termasuk iklan yang dijual dan ditayangkan oleh partner. Harap buka Pusat Bantuan YouTube untuk mengetahui informasi dan catatan tambahan tentang angka estimasi pendapatan.

Secara default, semua estimasi pendapatan dilaporkan dalam USD. Namun, YouTube Analytics API mendukung parameter currency untuk beberapa metrik estimasi pendapatan dan performa iklan, sehingga Anda dapat mengambil estimasi data pendapatan dalam mata uang lain.
estimatedRevenue (metrik inti) (sebelumnya bernama earnings)
Total estimasi pendapatan bersih dari semua sumber iklan yang dijual oleh 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 di akhir bulan dan tidak menyertakan iklan yang dijual serta 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 pendapatan yang diperkirakan akan disesuaikan dengan akhir bulan dan tidak mencakup iklan yang dijual serta ditayangkan oleh partner.
estimatedRedPartnerRevenue (sebelumnya bernama redPartnerRevenue)
Total estimasi pendapatan yang diperoleh dari subscription YouTube Premium (sebelumnya disebut YouTube Red) untuk dimensi laporan yang dipilih. Nilai metrik mencerminkan pendapatan dari konten musik dan non-musik, dan bergantung pada penyesuaian akhir bulan.

Metrik performa iklan

Pendapatan kotor
Estimasi pendapatan kotor, dalam USD, dari semua iklan yang dijual Google atau 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 sama dengan estimasi pendapatan, atau pendapatan bersih, yang dihitung berdasarkan saham kepemilikan dan perjanjian bagi hasil Anda.
cpm (sebelumnya bernama impressionBasedCpm)
Estimasi pendapatan kotor per seribu tayangan iklan.
adImpressions (sebelumnya bernama impressions)
Jumlah tayangan iklan terverifikasi yang ditayangkan.
monetizationdPlaybacks
Jumlah instance saat penonton memutar video Anda dan minimal satu tayangan iklan ditayangkan. Pemutaran yang dimonetisasi dihitung jika penonton melihat iklan preroll, tetapi berhenti menonton iklan tersebut sebelum video Anda dimulai. Perkiraan kesalahan untuk angka ini adalah ±2,0%.
BerbasisPemutaranCpm
Estimasi pendapatan kotor per seribu pemutaran.