Halaman ini menampilkan contoh permintaan YouTube Analytics API. Setiap contoh menjelaskan secara singkat laporan yang diambil, lalu menampilkan nilai parameter dimensions, metrics, filters, dan sort yang sesuai. (Dokumen laporan channel dan laporan pemilik konten mengidentifikasi laporan yang didukung API.)
Setiap contoh ditautkan ke dan mengisi Google APIs Explorer dengan nilai yang ditampilkan. Contoh ini juga menggunakan tanggal mulai dan akhir default (YYYY-MM-DD) dari 2023-09-01 dan 2024-03-31.
Setelah menautkan ke Penjelajah API, Anda masih harus menentukan channel atau pemilik konten yang laporannya ingin Anda ambil. Penjelajah API akan mengisi nilai parameter ids dengan channel==MINE atau contentOwner==CONTENT_OWNER_ID, bergantung pada kueri yang Anda klik. Untuk laporan saluran, Anda dapat mengubah MINE menjadi ID saluran pengguna yang diautentikasi. Untuk laporan pemilik konten, Anda harus mengganti CONTENT_OWNER_ID dengan ID pemilik konten Anda.
Anda juga harus diautentikasi sebagai pemilik konten atau channel yang ditentukan agar APIs Explorer dapat mengizinkan permintaan API menggunakan OAuth 2.0.
Mengurutkan permintaan menurut beberapa dimensi/metrik
API mendukung kemampuan untuk mengurutkan data respons menggunakan beberapa dimensi atau metrik. Misalnya, permintaan di bawah ini mengambil data sumber traffic harian untuk video channel tertentu. Setiap baris dalam kumpulan hasil mengidentifikasi jumlah penayangan dan estimasi waktu tonton yang berasal dari jenis sumber traffic tertentu (misalnya, EXT_URL) pada hari tertentu.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-viewsDalam respons, hasil diurutkan secara kronologis. Dalam kumpulan hasil untuk setiap hari, hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Jadi, baris pertama dalam set hasil berisi data untuk sumber traffic yang menghasilkan tampilan terbanyak pada hari pertama dalam rentang tanggal yang diminta. Baris kedua berisi data untuk sumber traffic yang menghasilkan jumlah penayangan tertinggi berikutnya pada hari pertama.
Laporan channel
Laporan video
Total jumlah penayangan, estimasi waktu tonton, dan lainnya untuk channel
Kueri ini mengambil metrik gabungan untuk konten channel. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDurationJumlah penayangan khusus negara (dan lainnya) untuk channel
Kueri ini mengambil metrik untuk negara tertentu untuk video channel. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US10 teratas – Video yang paling banyak ditonton untuk channel
Kueri ini mengambil 10 video yang paling banyak ditonton di channel, yang diukur berdasarkan estimasi menit ditonton selama rentang tanggal yang ditentukan. Hasil diurutkan berdasarkan perkiraan menit yang ditonton dalam urutan menurun.
Catatan: Laporan ini mengharuskan Anda menentukan nilai untuk parameter permintaan sort dan menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched10 teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di channel
Permintaan ini mengambil jumlah penayangan, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk 10 video yang paling banyak ditonton di saluran tersebut. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun, yang berarti video yang paling banyak ditonton akan dicantumkan terlebih dahulu.
Catatan: Laporan ini mengharuskan Anda menentukan nilai untuk parameter permintaan sort dan menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-viewsLaporan playlist
Total penayangan playlist untuk channel
Permintaan ini mengambil total awal playlist, perkiraan menit ditonton, penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan penayangan per awal playlist untuk playlist di channel pengguna yang diautentikasi.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStartStatistik untuk playlist tertentu
Permintaan ini mengambil total awal playlist, perkiraan menit ditonton, penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan penayangan per awal playlist untuk playlist tertentu. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string PLAYLIST_ID dalam nilai parameter filters dengan ID playlist untuk playlist di saluran pengguna yang diautentikasi.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDUntuk mengambil statistik gabungan untuk beberapa playlist, Anda juga dapat mengganti string PLAYLIST_ID dengan daftar yang dipisahkan koma yang berisi hingga 500 ID playlist untuk playlist di channel pengguna yang diautentikasi.
10 teratas – Playlist yang paling banyak ditonton untuk channel
Kueri ini mengambil 10 playlist yang paling banyak ditonton di channel, yang diukur berdasarkan penayangan playlist selama rentang tanggal yang ditentukan. Tab ini juga mengambil beberapa metrik playlist lainnya, seperti berapa kali penonton memulai pemutaran setiap playlist dan jumlah rata-rata waktu yang dihabiskan penonton untuk menonton video di playlist tersebut setelah dimulai. Hasil diurutkan berdasarkan penayangan playlist dalam urutan menurun.
Catatan: Karena laporan ini menggunakan dimensi playlist, Anda harus menentukan nilai untuk parameter permintaan sort dan juga menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViewsLaporan video
Metrik waktu tonton harian untuk video channel
Kueri ini mengambil jumlah penayangan harian, metrik waktu tonton, dan jumlah subscriber baru untuk video channel. Laporan menampilkan satu baris data per hari dalam rentang tanggal yang diminta. Baris diurutkan dalam urutan kronologis.
dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=dayMetrik anotasi harian untuk video channel
Permintaan ini mengambil jumlah penayangan harian, rasio klik-tayang anotasi, rasio penutupan anotasi, dan tayangan anotasi untuk konten channel. Hasil diurutkan dalam urutan kronologis.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=dayLaporan playlist
Penayangan playlist harian untuk channel
Permintaan ini mengambil jumlah penayangan harian (metrik video gabungan), penayangan playlist (metrik dalam playlist), awal playlist, perkiraan menit ditonton, dan penayangan per awal playlist untuk channel pengguna yang diautentikasi. Hasil diurutkan dalam urutan kronologis.
dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=dayLaporan video
Metrik waktu tonton spesifik per negara untuk video channel
Kueri ini mengambil jumlah penayangan, metrik waktu tonton, dan angka subscription spesifik per negara untuk video channel. Laporan ini menampilkan satu baris data untuk setiap negara tempat video channel ditonton. Baris diurutkan dari bawah ke atas berdasarkan jumlah menit yang ditonton.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatchedMetrik anotasi khusus per negara untuk video channel
Permintaan ini mengambil jumlah penayangan, rasio klik-tayang anotasi, rasio penutupan anotasi, dan tayangan anotasi spesifik per negara untuk video channel. Hasil diurutkan berdasarkan rasio klik-tayang anotasi dalam urutan menurun, yang berarti bahwa negara dengan rasio klik-tayang anotasi tertinggi akan dicantumkan terlebih dahulu.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRateMetrik khusus provinsi untuk negara bagian Amerika Serikat dan Washington D.C.
Permintaan ini mengambil perincian jumlah penayangan, estimasi menit ditonton, dan durasi tonton rata-rata per provinsi untuk video channel. Data ini mencakup negara bagian AS dan Washington D.C. Hasil diurutkan menurut abjad berdasarkan kode ISO 3166-2 provinsi.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province10 teratas – Video yang paling banyak ditonton di negara tertentu
Kueri ini mengambil 10 video yang paling banyak ditonton di channel, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan, di negara yang ditentukan. Hasil diurutkan menurut jumlah penayangan dalam urutan menurun.
Catatan: Laporan ini mengharuskan Anda menentukan nilai untuk parameter permintaan sort dan menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views10 kota teratas di Amerika Serikat berdasarkan total penayangan
Kueri ini mengambil daftar 10 kota di Amerika Serikat yang memiliki jumlah penayangan konten channel terbanyak selama rentang tanggal yang ditentukan. Kueri dapat diubah untuk meminta data untuk negara lain dengan memilih nilai lain yang valid untuk filter tersebut. Demikian pula, kueri dapat dimodifikasi untuk mengambil data subbenua, seperti Eropa Barat atau Asia Tenggara, menggunakan filter subContinent dan salah satu nilai yang valid. Filter lain juga didukung. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views10 kota teratas di Amerika Serikat berdasarkan total penayangan untuk setiap jenis konten
Kueri ini mengambil daftar 10 kota di Amerika Serikat yang menghasilkan jumlah penayangan konten channel terbanyak selama rentang tanggal yang ditentukan untuk setiap creatorContentType yang didukung. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views10 kota teratas di AS menurut total waktu tonton
Kueri ini mengambil daftar 10 hari teratas selama rentang tanggal yang ditentukan saat kota mana pun di Amerika Serikat menyumbang total waktu tonton harian terbesar untuk konten channel. Hasil kueri mengidentifikasi total waktu tonton, tanggal terjadinya waktu tonton, dan kota tempat konten diperkirakan pernah ditonton. Hasil diurutkan dalam urutan menurun dari total waktu tonton.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime10 teratas – Video yang paling banyak ditonton di Eropa
Kueri ini mengambil 10 video yang paling banyak ditonton di Eropa, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan. Kueri dapat diubah untuk meminta data untuk benua lain dengan memilih nilai lain yang valid untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subkontinen, seperti Eropa Barat atau Asia Tenggara, dengan menggunakan filter subContinent dan salah satu nilainya yang valid. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
Catatan: Laporan ini mengharuskan Anda menentukan nilai untuk parameter permintaan sort dan menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-viewsLaporan playlist
Metrik waktu tonton spesifik per negara untuk playlist channel
Kueri ini mengambil jumlah penayangan spesifik per negara (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan metrik waktu tonton untuk playlist channel. Laporan ini menampilkan satu baris data untuk setiap negara tempat playlist channel ditonton. Baris diurutkan dari bawah ke atas berdasarkan jumlah menit yang ditonton.
dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched10 teratas – Playlist yang paling sering dimulai di Amerika Serikat
Kueri ini mengambil 10 playlist yang paling sering ditonton oleh penonton di Amerika Serikat selama rentang tanggal yang ditentukan. Hasil diurutkan berdasarkan jumlah playlist yang dimulai dalam urutan menurun.
Catatan: Karena laporan ini menggunakan dimensi playlist, Anda harus menentukan nilai untuk parameter permintaan sort dan juga menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStartsLaporan video
Jumlah penayangan dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video channel tertentu. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasilnya diurutkan dalam urutan menurun menurut jumlah penayangan.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-viewsJumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton di Amerika Serikat untuk video channel tertentu. Hasil dikelompokkan berdasarkan hari untuk setiap jenis halaman atau aplikasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
10 teratas – Situs pihak ketiga yang menghasilkan penayangan terbanyak untuk video tersemat
Kueri ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video atau grup video tertentu. Hasil dikelompokkan berdasarkan situs pihak ketiga tempat video disematkan. Hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar satu atau beberapa ID video yang dipisahkan koma untuk video yang Anda upload.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsLaporan playlist
Jumlah penayangan dan waktu tonton playlist dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah jumlah penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), estimasi waktu tonton, dan awal playlist untuk playlist channel tertentu. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasilnya diurutkan dalam urutan menurun berdasarkan pemutaran playlist.
dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStartsJumlah penayangan playlist harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil awal playlist harian, jumlah penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan estimasi waktu tonton di Amerika Serikat untuk playlist channel tertentu. Hasil dikelompokkan berdasarkan hari untuk setiap jenis halaman atau aplikasi tempat penayangan playlist terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=dayLaporan video
Penilaian suka dan tidak suka menurut jenis konten
Kueri ini mengambil jumlah suka dan tidak suka untuk setiap jenis konten pada sebuah saluran.
dimensions=creatorContentType
metrics=likes,dislikesLaporan video
Jumlah penayangan dan waktu tonton dari berbagai sumber traffic di suatu negara
Permintaan ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video channel di negara tertentu. Metrik digabungkan menurut sumber traffic, yang menjelaskan cara pengguna menjangkau video.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==USJumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan harian dan estimasi waktu tonton harian untuk video channel. Metrik digabungkan setiap hari berdasarkan sumber traffic dan diurutkan dalam urutan kronologis.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day10 teratas – Istilah penelusuran YouTube yang menghasilkan traffic terbanyak untuk sebuah video
Kueri ini mengambil 10 istilah penelusuran yang menghasilkan penayangan terbanyak dari hasil penelusuran YouTube untuk satu atau beberapa video tertentu. Hasil diurutkan menurut jumlah penayangan dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID video.
Misalnya, Anda dapat menjalankan kueri untuk satu video atau mengganti VIDEO_ID untuk mengidentifikasi istilah penelusuran yang menghasilkan traffic terbanyak untuk video tersebut. Anda juga dapat membuat daftar semua video dalam playlist tertentu untuk menentukan istilah penelusuran yang menghasilkan traffic terbanyak untuk video dalam playlist tersebut.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views10 teratas – Situs eksternal yang menghasilkan traffic terbanyak untuk video
Kueri ini mengambil 10 situs eksternal yang menghasilkan penayangan terbanyak untuk video atau grup video tertentu. Hasil diurutkan berdasarkan perkiraan waktu tonton dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar yang dipisahkan koma yang berisi hingga 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedLaporan playlist
Jumlah penayangan dan waktu tonton playlist dari berbagai sumber traffic di suatu negara
Permintaan ini mengambil jumlah penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), awal playlist, dan estimasi waktu tonton untuk penayangan playlist di negara yang ditentukan. Metrik digabungkan menurut sumber traffic, yang menjelaskan cara pengguna menjangkau playlist.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==USJumlah penayangan playlist harian dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan playlist harian channel (metrik in-playlist), pemutaran playlist, dan estimasi waktu tonton. Metrik ini juga mengambil total penayangan (metrik video gabungan). Metrik digabungkan setiap hari berdasarkan sumber traffic dan diurutkan dalam urutan kronologis.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=dayLaporan video
Metrik jenis perangkat harian untuk sistem operasi Android
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton di perangkat Android untuk video dari channel tertentu. Hasil dikelompokkan menurut hari untuk setiap jenis perangkat tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=dayMetrik sistem operasi harian untuk perangkat seluler
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton di perangkat seluler untuk video channel tertentu. Hasil dikelompokkan berdasarkan hari untuk setiap sistem operasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=dayMetrik jenis perangkat dan sistem operasi harian
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton untuk sebuah channel. Statistik dikelompokkan menurut sistem operasi dan jenis perangkat. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayLaporan playlist
Metrik jenis perangkat harian untuk penayangan playlist di sistem operasi Android
Kueri ini mengambil penayangan harian (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan estimasi waktu tonton di perangkat Android untuk playlist channel tertentu. Hasil dikelompokkan menurut hari untuk setiap jenis perangkat tempat penayangan playlist terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=dayMetrik sistem operasi harian untuk penayangan playlist di perangkat seluler
Kueri ini mengambil penayangan harian (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan estimasi waktu tonton di perangkat seluler untuk playlist channel tertentu. Hasil dikelompokkan menurut hari untuk setiap sistem operasi tempat penayangan playlist terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=dayLaporan video
Demografi penonton di California (kelompok usia dan gender)
Laporan ini mengambil statistik tentang kelompok usia dan gender penonton di California yang menonton video channel. Hasil diurutkan berdasarkan gender, lalu berdasarkan kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama bagi semua penonton di seluruh dunia atau semua penonton di negara, benua, subbenua, atau negara bagian AS lainnya dengan menyesuaikan nilai parameter filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupLaporan playlist
Demografi penonton playlist di California (kelompok usia dan gender)
Laporan ini mengambil statistik tentang kelompok usia dan gender penonton di California yang
menonton playlist channel. Hasil diurutkan berdasarkan gender, lalu berdasarkan kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama bagi semua penonton di seluruh dunia atau semua penonton di negara, benua, subbenua, atau negara bagian AS lainnya dengan menyesuaikan nilai parameter filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupMetrik berbagi, digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil frekuensi pengguna menggunakan tombol Share untuk membagikan video channel. Hasil digabungkan berdasarkan layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun berdasarkan jumlah pembagian.
dimensions=sharingService
metrics=shares
sort=-sharesMetrik retensi audiens untuk video
Laporan ini mengukur kemampuan video dalam mempertahankan penontonnya. Laporan hanya dapat diambil untuk satu video pada satu waktu. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan ID video untuk salah satu video yang Anda upload. Perhatikan bahwa laporan retensi audiens tidak mendukung kemampuan untuk menentukan beberapa nilai untuk filter video.
Dalam contoh ini, laporan menggunakan filter audienceType untuk membatasi respons sehingga hanya berisi data untuk penayangan organik, yang merupakan hasil dari tindakan langsung pengguna, seperti penelusuran video atau klik pada video yang disarankan. Oleh karena itu, laporan ini tidak menyertakan data untuk penayangan dari iklan TrueView in-stream atau TrueView in-display. Anda dapat menghapus filter untuk mengambil data retensi audiens video dari semua jenis audiens.
Perhatikan bahwa data untuk filter audienceType tersedia mulai 25 September 2013. API tidak akan menampilkan data untuk kueri yang menggunakan filter untuk mencoba mengambil data dari tanggal sebelumnya. Kueri yang tidak menggunakan filter akan berfungsi untuk tanggal apa pun setelah 1 Juli 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICMetrik performa iklan dan pendapatan channel
Permintaan ini mengambil metrik performa iklan dan pendapatan saluran. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksMetrik pendapatan harian dan performa iklan
Permintaan ini mengambil metrik performa iklan dan pendapatan harian saluran.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksMetrik pendapatan dan performa iklan spesifik per negara
Permintaan ini mengambil metrik performa iklan dan pendapatan spesifik per negara untuk channel. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti bahwa negara pertama yang tercantum adalah negara tempat mitra memperoleh pendapatan bersih terbesar.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue10 teratas – Video dengan pendapatan tertinggi
Permintaan ini mengambil metrik performa iklan dan pendapatan untuk 10 video channel dengan pendapatan terbesar. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti video pertama adalah video yang memiliki estimasi pendapatan tertinggi.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenueMetrik performa iklan untuk berbagai jenis iklan
Permintaan ini mengambil metrik performa iklan untuk konten yang diklaim pemilik konten. Hasil dikelompokkan menurut jenis iklan, yang memungkinkan Anda membandingkan nilai pendapatan dan CPM di berbagai jenis iklan.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adTypeLaporan pemilik konten
Laporan video
Total jumlah penayangan, estimasi waktu tonton, dan lainnya untuk semua konten yang diklaim
Kueri ini mengambil metrik gabungan untuk konten yang diklaim oleh pemilik konten. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimedJumlah penayangan spesifik per negara (dan lainnya) untuk semua video yang diupload sendiri
Kueri ini mengambil metrik untuk negara tertentu untuk video yang diupload oleh pemilik konten. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FRTotal jumlah penayangan (dan lainnya) untuk semua konten pihak ketiga yang diklaim
Kueri ini mengambil metrik gabungan untuk video yang diklaim pemilik konten, tetapi tidak diupload. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimedTotal jumlah penayangan (dan lainnya) untuk semua konten yang diupload sendiri
Kueri ini mengambil metrik gabungan untuk video yang diupload pemilik konten. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==selfTotal jumlah penayangan (dan lainnya) untuk semua konten yang diupload sendiri dan diklaim
Kueri ini mengambil metrik gabungan untuk video yang diupload dan juga diklaim oleh pemilik konten. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed10 Teratas – Video yang paling sering ditonton untuk pemilik konten
Kueri ini mengambil 10 video yang paling banyak ditonton, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan, yang diupload oleh pemilik konten. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views10 teratas – Video yang paling banyak ditonton untuk pemilik konten
Kueri ini mengambil 10 video yang paling banyak ditonton, yang diukur berdasarkan estimasi menit yang ditonton selama rentang tanggal yang ditentukan, yang diupload oleh pemilik konten. Hasil diurutkan berdasarkan estimasi menit ditonton dalam urutan menurun.
dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched10 teratas – Video yang paling banyak ditonton untuk channel pemilik konten
Kueri ini mengambil 10 video yang paling sering ditonton untuk channel atau grup channel tertentu yang dikelola pemilik konten. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string CHANNEL_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di saluran
Permintaan ini mengambil jumlah penayangan, rasio klik-tayang anotasi, rasio penutupan anotasi, dan tayangan anotasi untuk 10 video yang paling banyak ditonton di channel atau grup channel tertentu. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun, yang berarti video yang paling banyak ditonton akan dicantumkan terlebih dahulu. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string CHANNEL_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-viewsLaporan playlist
Tayangan playlist untuk channel pemilik konten
Permintaan ini mengambil total awal playlist, perkiraan menit ditonton playlist, penayangan playlist, dan penayangan per awal playlist untuk playlist di channel pemilik konten. Metrik
playlistViews hanya menghitung penayangan video yang terjadi dalam konteks
playlist. Karena semua metrik yang diminta adalah metrik dalam playlist, permintaan juga tidak
perlu menyertakan filter playlist atau grup.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStartStatistik untuk playlist tertentu
Permintaan ini mengambil total awal playlist, estimasi menit ditonton, penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), dan penayangan per awal playlist untuk playlist tertentu. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string PLAYLIST_ID dalam nilai parameter filters dengan ID playlist untuk playlist di salah satu saluran pemilik konten.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDUntuk mengambil statistik gabungan untuk beberapa playlist, Anda juga dapat mengganti string PLAYLIST_ID dengan daftar yang dipisahkan koma yang berisi hingga 500 ID playlist untuk playlist di channel pemilik konten.
Laporan video
Metrik waktu tonton harian untuk konten yang diupload sendiri
Kueri ini mengambil metrik waktu tonton harian, serta jumlah penayangan, jumlah pemutaran yang dimonetisasi, dan jumlah tayangan untuk video yang diupload oleh pemilik konten. Laporan menampilkan satu baris data untuk setiap hari dalam rentang tanggal yang diminta, dan baris diurutkan dalam urutan kronologis.
dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=dayMetrik anotasi untuk konten yang diklaim
Permintaan ini mengambil jumlah penayangan harian, rasio klik-tayang anotasi, rasio penutupan anotasi, dan tayangan anotasi untuk konten yang diklaim oleh pemilik konten. Hasil diurutkan dalam urutan kronologis.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=dayLaporan playlist
Penayangan playlist harian untuk pemilik konten
Permintaan ini mengambil metrik untuk interaksi pengguna harian dengan video di playlist pemilik konten. Metrik yang diambil dalam laporan adalah playlistViews, playlistStarts, playlistEstimatedMinutesWatched, dan viewsPerPlaylistStart. Semua metrik ini adalah metrik dalam playlist. Karena semua metrik yang diminta adalah metrik dalam playlist, permintaan tidak perlu menyertakan filter playlist atau grup.
dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=dayLaporan video
Metrik waktu tonton khusus negara untuk konten yang diupload sendiri
Kueri ini mengambil jumlah penayangan, metrik waktu tonton, dan estimasi pendapatan iklan untuk setiap negara. Metrik ini ditujukan untuk video yang diupload oleh pemilik konten. Laporan ini menampilkan satu baris data untuk setiap negara tempat video ditonton, dan baris diurutkan dalam urutan menurun berdasarkan jumlah menit yang ditonton.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatchedMetrik anotasi spesifik per negara untuk konten yang diupload sendiri
Permintaan ini mengambil jumlah penayangan khusus negara, rasio klik-tayang anotasi, rasio penutupan anotasi, dan tayangan anotasi untuk video yang diupload pemilik konten. Hasil diurutkan berdasarkan rasio klik-tayang anotasi dalam urutan menurun, yang berarti bahwa negara dengan rasio klik-tayang anotasi tertinggi akan dicantumkan terlebih dahulu.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRateMetrik khusus provinsi untuk negara bagian Amerika Serikat dan Washington D.C.
Permintaan ini mengambil pengelompokan jumlah penayangan, perkiraan menit yang ditonton, dan rata-rata durasi tonton menurut provinsi untuk video yang diklaim oleh pemilik konten. Data mencakup negara bagian AS dan Washington D.C. Hasil diurutkan menurut abjad berdasarkan kode ISO 3166-2 provinsi.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province10 kota teratas di Amerika Serikat berdasarkan total penayangan
Kueri ini mengambil daftar 10 kota di Amerika Serikat yang memiliki jumlah penayangan terbanyak untuk video yang diklaim oleh pemilik konten selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk negara lain dengan memilih nilai valid lain untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subkontinen, seperti Eropa Barat atau Asia Tenggara, dengan menggunakan filter subContinent dan salah satu nilainya yang valid. Filter lain juga didukung. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views10 kota teratas di AS menurut total penayangan untuk setiap jenis konten
Kueri ini mengambil daftar 10 kota di AS yang berkontribusi terhadap penayangan terbanyak atas konten yang diklaim pemilik konten selama rentang tanggal yang ditentukan untuk setiap creatorContentType yang didukung. Hasil diurutkan menurut jumlah penayangan dalam urutan menurun.
dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views10 kota teratas di AS menurut total waktu tonton
Kueri ini mengambil daftar 10 hari teratas selama rentang tanggal yang ditentukan saat kota mana pun di Amerika Serikat menyumbang total waktu tonton harian terbesar dari konten yang diklaim pemilik konten. Hasil kueri mengidentifikasi total waktu tonton, tanggal waktu tonton terjadi, dan kota tempat konten diperkirakan telah ditonton. Hasil diurutkan dalam urutan menurun berdasarkan total waktu tonton.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime10 teratas – Video yang paling banyak ditonton di Eropa
Kueri ini mengambil 10 video yang paling banyak ditonton di Eropa, di antara video yang diklaim oleh pemilik konten, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan. Kueri dapat diubah untuk meminta data untuk benua lain dengan memilih nilai lain yang valid untuk filter tersebut. Demikian pula, kueri dapat dimodifikasi untuk mengambil data subbenua, seperti Eropa Barat atau Asia Tenggara, menggunakan filter subContinent dan salah satu nilai yang valid. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatchedLaporan playlist
Metrik waktu tonton spesifik per negara untuk playlist pemilik konten
Kueri ini mengambil jumlah penayangan playlist khusus negara dan metrik waktu tonton playlist untuk semua playlist di channel pemilik konten. Laporan ini menampilkan satu baris data untuk setiap negara tempat playlist ditonton. Baris diurutkan dalam urutan menurun sesuai jumlah menit yang ditonton.
dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched10 teratas – Playlist yang paling sering dimulai di Amerika Serikat
Kueri ini mengambil 10 playlist dari channel pemilik konten yang paling sering ditonton oleh penonton di Amerika Serikat selama rentang tanggal yang ditentukan. Hasilnya diurutkan berdasarkan jumlah playlist dimulai dalam urutan menurun.
Catatan: Karena laporan ini menggunakan dimensi playlist, Anda harus menentukan nilai untuk parameter permintaan sort dan juga menetapkan parameter maxResults ke nilai bilangan bulat 10 atau kurang.
dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStartsLaporan video
Suka dan tidak suka menurut jenis konten
Kueri ini mengambil jumlah suka dan tidak suka untuk setiap jenis konten di channel atau grup channel tertentu. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string CHANNEL_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_IDLaporan video
Jumlah penayangan dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video yang diupload ke channel atau grup channel tertentu. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasil diurutkan dalam urutan menurun berdasarkan jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string CHANNEL_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-viewsJumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton di Amerika Serikat untuk video yang diupload ke channel atau grup channel tertentu. Hasil dikelompokkan menurut hari untuk setiap jenis halaman atau aplikasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis terbalik. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string CHANNEL_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day10 teratas – Situs pihak ketiga yang menghasilkan penayangan terbanyak untuk video tersemat
Kueri ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video atau grup video tertentu. Hasil dikelompokkan berdasarkan situs pihak ketiga tempat video disematkan. Hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar yang dipisahkan koma yang berisi hingga 500 ID video untuk video yang Anda upload.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsLaporan playlist
Jumlah penayangan dan waktu tonton playlist dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan playlist, estimasi waktu tonton playlist, dan awal playlist untuk semua playlist di channel pemilik konten. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasil diurutkan dalam urutan menurun berdasarkan awal playlist.
dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStartsJumlah penayangan dan waktu tonton playlist dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah awal playlist harian, jumlah penayangan playlist, dan estimasi waktu tonton playlist di Amerika Serikat untuk semua playlist di channel pemilik konten. Hasil ditampilkan untuk setiap jenis halaman atau aplikasi tempat penayangan playlist terjadi.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Laporan video
Jumlah penayangan dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan dan estimasi waktu tonton untuk video pemilik konten. Metrik digabungkan menurut sumber traffic, yang menjelaskan cara pengguna menjangkau video.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==selfJumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan harian dan estimasi waktu tonton harian untuk video pemilik konten. Metrik ini digabungkan setiap hari menurut sumber traffic dan diurutkan dalam urutan kronologis terbalik.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-dayCatatan: Dua contoh laporan berikutnya hanya didukung untuk sumber traffic tertentu. Sumber traffic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, dan NO_LINK_EMBEDDED adalah beberapa sumber traffic yang tidak didukung.
10 teratas – Istilah penelusuran YouTube yang menghasilkan traffic terbanyak untuk sebuah video
Kueri ini mengambil 10 istilah penelusuran yang menghasilkan penayangan terbanyak dari hasil penelusuran YouTube untuk video atau grup video tertentu. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsTop 10 – Situs eksternal yang menghasilkan traffic terbanyak untuk sebuah video
Kueri ini mengambil 10 situs eksternal yang menghasilkan penayangan terbanyak dari hasil penelusuran Google untuk video atau grup video tertentu. Hasil diurutkan berdasarkan estimasi waktu tonton dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedLaporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di satu negara
Permintaan ini mengambil jumlah penayangan playlist, awal playlist, dan estimasi waktu tonton playlist untuk penayangan playlist di negara yang ditentukan. Metrik digabungkan menurut sumber traffic, yang menjelaskan cara pengguna menjangkau playlist.
dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==USJumlah penayangan dan waktu tonton playlist dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan playlist, pemutaran playlist, dan estimasi waktu tonton playlist untuk playlist di satu atau beberapa channel pemilik konten. Metrik digabungkan berdasarkan
sumber traffic. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string
CHANNEL_ID dalam nilai parameter filters dengan daftar yang dipisahkan koma
hingga 500 ID saluran untuk saluran Anda.
dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_IDLaporan video
Metrik jenis perangkat harian untuk video yang diklaim
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton menurut jenis perangkat untuk video yang diklaim oleh pemilik konten tertentu. Hasil dikelompokkan menurut hari untuk setiap jenis perangkat tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=dayMetrik sistem operasi harian untuk video yang diklaim yang ditonton di perangkat seluler
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton menurut sistem operasi untuk penayangan video yang diklaim oleh pemilik konten tertentu yang dilakukan di perangkat seluler. Hasil dikelompokkan berdasarkan hari untuk setiap sistem operasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=dayMetrik jenis perangkat dan sistem operasi harian
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton untuk video yang diklaim oleh pemilik konten tertentu. Statistik dikelompokkan menurut sistem operasi dan jenis perangkat. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayLaporan playlist
Metrik jenis perangkat untuk penayangan playlist di sistem operasi Android
Kueri ini mengambil jumlah penayangan playlist dan estimasi waktu tonton playlist di perangkat Android
untuk playlist di satu atau beberapa channel pemilik konten. Hasil ditampilkan untuk
setiap jenis perangkat tempat penayangan playlist terjadi. Perhatikan bahwa untuk menjalankan kueri ini di API Explorer, Anda harus mengganti string CHANNEL_ID dalam nilai parameter filters dengan daftar yang dipisahkan koma hingga 500 ID saluran untuk saluran Anda.
dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROIDMetrik sistem operasi untuk penayangan playlist di perangkat seluler
Kueri ini mengambil jumlah penayangan playlist dan estimasi waktu tonton playlist di perangkat seluler untuk playlist di channel pemilik konten mana pun. Hasil ditampilkan untuk setiap sistem operasi tempat penayangan playlist terjadi.
dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILELaporan video
Demografi penonton di California (kelompok usia dan gender)
Laporan ini mengambil statistik tentang kelompok usia dan gender penonton di California yang menonton konten yang diklaim oleh pemilik konten. Hasil diurutkan menurut gender, lalu menurut kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama untuk semua penonton di seluruh dunia atau semua penonton di negara, benua, subbenua, atau negara bagian AS lainnya dengan menyesuaikan nilai parameter filters.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroupMetrik berbagi, yang digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil frekuensi pengguna menggunakan tombol Share untuk membagikan video yang diupload oleh pemilik konten. Hasil digabungkan berdasarkan layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun berdasarkan jumlah pembagian.
dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-sharesMetrik retensi audiens untuk video
Laporan ini mengukur kemampuan video dalam mempertahankan penontonnya. Laporan hanya dapat diambil untuk satu video pada satu waktu. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string VIDEO_ID di nilai parameter filters dengan ID video untuk salah satu video yang Anda upload. Perhatikan bahwa laporan retensi audiens tidak mendukung kemampuan untuk menentukan beberapa nilai untuk filter video.
Dalam contoh ini, laporan menggunakan filter audienceType untuk membatasi respons sehingga hanya berisi data untuk penayangan organik, yang merupakan hasil dari tindakan pengguna langsung, seperti penelusuran video atau klik pada video yang disarankan. Oleh karena itu, laporan ini tidak menyertakan data untuk penayangan dari iklan TrueView in-stream atau TrueView in-display. Anda dapat menghapus filter untuk mengambil data retensi audiens video dari semua jenis audiens.
Perhatikan bahwa data untuk filter audienceType tersedia mulai 25 September 2013. API tidak akan menampilkan data untuk kueri yang menggunakan filter untuk mencoba mengambil data dari tanggal sebelumnya. Kueri yang tidak menggunakan filter akan berfungsi untuk tanggal apa pun setelah 1 Juli 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICMetrik pendapatan dan performa iklan untuk konten yang diklaim
Permintaan ini mengambil metrik pendapatan dan performa iklan untuk konten yang diklaim pemilik konten. Laporan menampilkan satu baris data yang berisi total untuk setiap metrik yang diminta selama rentang tanggal yang ditentukan.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedMetrik performa iklan dan pendapatan harian
Permintaan ini mengambil metrik performa iklan dan pendapatan harian untuk konten yang diklaim oleh pemilik konten.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedMetrik pendapatan dan performa iklan spesifik per negara
Permintaan ini mengambil metrik performa iklan dan pendapatan spesifik per negara untuk konten yang diklaim oleh pemilik konten. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti bahwa negara pertama yang tercantum adalah negara tempat partner memiliki estimasi pendapatan terbesar.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue10 teratas – Video dengan pendapatan tertinggi
Permintaan ini mengambil metrik pendapatan dan performa iklan untuk 10 video yang diklaim oleh pemilik konten dan memiliki pendapatan tertinggi. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti bahwa video pertama akan menjadi video yang memiliki estimasi pendapatan tertinggi.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenueMetrik performa iklan untuk berbagai jenis iklan
Permintaan ini mengambil metrik performa iklan untuk konten yang diklaim oleh pemilik konten. Hasil dikelompokkan menurut jenis iklan, yang memungkinkan Anda membandingkan nilai pendapatan dan CPM di berbagai jenis iklan.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType