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 tersebut juga menggunakan tanggal mulai dan akhir default (YYYY-MM-DD
) 2023-09-01
dan 2024-03-31
.
Setelah menautkan ke APIs Explorer, Anda masih harus menentukan pemilik konten atau saluran yang laporannya akan Anda ambil. APIs Explorer 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
ke 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 saluran yang ditentukan agar APIs Explorer dapat mengizinkan permintaan API menggunakan OAuth 2.0.
Mengurutkan permintaan menurut beberapa dimensi/metrik
API ini mendukung kemampuan untuk mengurutkan data respons menggunakan beberapa dimensi atau metrik. Misalnya, permintaan di bawah ini mengambil data sumber traffic harian untuk video di channel tertentu. Setiap baris dalam kumpulan hasil mengidentifikasi jumlah penayangan dan perkiraan waktu tonton yang berasal dari jenis sumber traffic tertentu (mis. EXT_URL
) pada hari tertentu.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Dalam respons, hasil diurutkan secara kronologis. Dalam kumpulan hasil untuk setiap hari, hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Jadi, baris pertama dalam kumpulan hasil berisi data untuk sumber traffic yang menghasilkan penayangan terbanyak di hari pertama dalam rentang tanggal yang diminta. Baris kedua berisi data untuk sumber traffic yang menghasilkan jumlah penayangan tertinggi berikutnya di hari pertama.
Laporan saluran
Laporan video
Total jumlah penayangan, estimasi waktu tonton, dan banyak lagi untuk sebuah 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,averageViewDuration
Jumlah penayangan spesifik per negara (dan lainnya) untuk channel
Kueri ini mengambil metrik untuk negara tertentu untuk video di sebuah 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==US
10 Teratas – Video yang paling sering ditonton untuk suatu channel
Kueri ini mengambil 10 video yang paling banyak ditonton di suatu channel, yang diukur berdasarkan estimasi menit yang ditonton selama rentang tanggal yang ditentukan. Hasil diurutkan menurut estimasi 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=-estimatedMinutesWatched
10 Teratas – Anotasi rasio klik-tayang 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 channel. Hasil diurutkan berdasarkan jumlah penayangan dengan urutan menurun. Artinya, video yang paling sering 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=-views
Laporan playlist
Total penayangan playlist untuk sebuah channel
Permintaan ini mengambil total jumlah mulai playlist, estimasi menit ditonton, penayangan (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan penayangan per playlist dimulai untuk playlist di channel pengguna yang diautentikasi.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statistik untuk playlist tertentu
Permintaan ini mengambil total jumlah mulai playlist, estimasi menit ditonton, penayangan (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan penayangan per awal playlist untuk playlist tertentu. Perlu diperhatikan 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_ID
Untuk 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 sering ditonton untuk suatu channel
Kueri ini mengambil 10 playlist di channel yang paling sering ditonton, diukur berdasarkan jumlah penayangan playlist selama rentang tanggal yang ditentukan. Laporan ini juga mengambil beberapa metrik playlist lainnya, seperti berapa kali penonton memulai pemutaran setiap playlist dan jumlah waktu rata-rata penonton menonton video dalam playlist setelah dimulai. Hasilnya 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=-playlistViews
Laporan video
Metrik waktu tonton harian untuk video di channel
Kueri ini mengambil jumlah penayangan harian, metrik waktu tonton, dan jumlah subscriber baru untuk video di suatu channel. Laporan ini menampilkan satu baris data untuk setiap hari dalam rentang tanggal yang diminta. Baris diurutkan dalam urutan kronologis.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Metrik anotasi harian untuk video saluran
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=day
Laporan playlist
Penayangan playlist harian untuk sebuah channel
Permintaan ini mengambil jumlah penayangan harian (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), pemutaran playlist dimulai, estimasi menit ditonton, dan jumlah penayangan per awal playlist untuk channel pengguna yang diautentikasi. Hasil diurutkan dalam urutan kronologis.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Laporan video
Metrik waktu tonton spesifik per negara untuk video di channel
Kueri ini mengambil jumlah penayangan spesifik per negara, metrik waktu tonton, dan angka subscription untuk video di suatu channel. Laporan ini menampilkan satu baris data untuk setiap negara tempat video channel ditonton. Baris diurutkan dalam urutan menurun dari jumlah menit ditonton.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
Metrik anotasi khusus negara untuk video channel
Permintaan ini mengambil jumlah penayangan spesifik per negara, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk video di channel. Hasil diurutkan menurut rasio klik-tayang anotasi dalam urutan menurun, yang berarti negara dengan rasio klik-tayang anotasi tertinggi akan dicantumkan terlebih dahulu.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Metrik spesifik per provinsi untuk negara bagian AS dan Washington D.C.
Permintaan ini mengambil perincian jumlah penayangan dari setiap provinsi, estimasi menit ditonton, dan rata-rata durasi tonton video di channel tersebut. Data tersebut mencakup negara bagian AS dan Hasil Washington D.C. diurutkan menurut abjad berdasarkan kode ISO 3166-2 provinsi.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 Teratas – Video yang paling sering ditonton di negara tertentu
Kueri ini mengambil 10 video yang paling sering ditonton di channel, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan, di negara tertentu. 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=country==US maxResults=10 sort=-views
10 kota teratas di AS menurut total penayangan
Kueri ini mengambil daftar 10 kota di AS yang menyumbang penayangan konten channel terbanyak selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk negara lain dengan memilih nilai valid lainnya untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subbenua, 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=country==US maxResults=10 sort=-views
10 kota teratas di AS berdasarkan total penayangan untuk setiap jenis konten
Kueri ini mengambil daftar 10 kota di AS yang menghasilkan 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=-views
10 kota teratas AS menurut total waktu tonton
Kueri ini mendapatkan daftar 10 hari teratas selama rentang tanggal yang ditentukan saat ada kota di AS yang menghasilkan total waktu tonton harian konten channel terbesar. Hasil kueri mengidentifikasi total waktu tonton, tanggal waktu tonton terjadi, dan kota tempat konten diperkirakan ditonton. Hasil diurutkan dalam urutan menurun dari total waktu tonton.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
10 Teratas – Video yang paling sering ditonton di Eropa
Kueri ini mendapatkan 10 video yang paling sering ditonton di channel ini di Eropa, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk benua lain dengan memilih nilai valid lainnya untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subbenua, 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=-views
Laporan playlist
Metrik waktu tonton spesifik per negara untuk playlist channel
Kueri ini mengambil jumlah penayangan khusus negara (metrik video gabungan), jumlah 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 dalam urutan menurun dari jumlah menit ditonton.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 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 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=-playlistStarts
Laporan video
Jumlah penayangan dan waktu tonton dari lokasi pemutaran yang berbeda
Kueri ini mengambil jumlah penayangan dan perkiraan waktu tonton untuk video di saluran 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=-views
Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton di Amerika Serikat untuk video di channel tertentu. Hasil dikelompokkan menurut 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 sematan
Kueri ini mengambil jumlah penayangan dan perkiraan waktu tonton untuk video atau kelompok video tertentu. Hasil dikelompokkan menurut situs pihak ketiga tempat video disematkan. Hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string VIDEO_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma yang berisi satu atau beberapa ID video untuk video yang Anda upload.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini memperoleh jumlah penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), estimasi waktu tonton, dan jumlah mulai playlist untuk playlist channel tertentu. Hasilnya 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=-playlistStarts
Jumlah penayangan playlist harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil data mulai playlist harian, jumlah penayangan (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan estimasi waktu tonton di Amerika Serikat untuk playlist channel tertentu. Hasilnya dikelompokkan menurut 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=day
Laporan video
Penilaian suka dan tidak suka menurut jenis konten
Kueri ini mengambil jumlah suka dan tidak suka untuk setiap jenis konten di sebuah channel.
dimensions=creatorContentType metrics=likes,dislikes
Laporan video
Jumlah penayangan dan waktu tonton dari berbagai sumber traffic di suatu negara
Permintaan ini mengambil jumlah penayangan dan perkiraan waktu tonton untuk video pada channel tersebut di negara tertentu. Metrik ini digabungkan berdasarkan sumber traffic, yang menjelaskan cara pengguna menjangkau video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Jumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan harian dan estimasi waktu tonton harian untuk video di channel tersebut. Metrik digabungkan setiap hari berdasarkan sumber traffic dan diurutkan dalam urutan kronologis.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
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 satu atau beberapa video tertentu. Hasil diurutkan berdasarkan jumlah penayangan 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 maksimal 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 mencantumkan semua video di playlist tertentu untuk menentukan istilah penelusuran mana yang menghasilkan traffic terbanyak untuk video mana pun di playlist tersebut.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 Teratas – Situs eksternal yang menghasilkan traffic terbanyak untuk suatu video
Kueri ini mengambil 10 situs web eksternal yang menghasilkan penayangan terbanyak untuk video atau grup video tertentu. Hasil diurutkan menurut estimasi waktu tonton dengan urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string VIDEO_ID
di nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di suatu negara
Permintaan ini memperoleh jumlah penayangan (metrik video gabungan), penayangan playlist (metrik dalam playlist), jumlah mulai playlist, dan estimasi waktu tonton untuk penayangan playlist di negara tertentu. Metrik ini digabungkan berdasarkan sumber traffic, yang menjelaskan cara pengguna menjangkau playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Jumlah penayangan playlist harian dan waktu tonton dari berbagai sumber traffic
Permintaan ini mengambil jumlah penayangan playlist harian suatu channel (metrik in-playlist), waktu mulai playlist, dan perkiraan waktu tonton. Model 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=day
Laporan video
Metrik jenis perangkat harian untuk sistem operasi Android
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton di perangkat Android untuk video di 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=day
Metrik sistem operasi harian untuk perangkat seluler
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton di perangkat seluler untuk video di channel tertentu. Hasil dikelompokkan menurut hari untuk tiap sistem operasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Metrik jenis perangkat dan sistem operasi harian
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton untuk sebuah saluran. Statistik dikelompokkan menurut sistem operasi dan jenis perangkat. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Laporan playlist
Metrik jenis perangkat harian untuk penayangan playlist di sistem operasi Android
Kueri ini memperoleh data penayangan harian (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan estimasi waktu tonton di perangkat Android untuk playlist channel tertentu. Hasilnya 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=day
Metrik sistem operasi harian untuk penayangan playlist di perangkat seluler
Kueri ini memperoleh data penayangan harian (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan perkiraan waktu tonton di perangkat seluler untuk playlist channel tertentu. Hasilnya dikelompokkan menurut hari untuk masing-masing sistem operasi tempat penayangan playlist terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Laporan 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 tersebut. Hasil diurutkan berdasarkan gender dan kemudian berdasarkan kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama bagi semua penonton di seluruh dunia atau semua penonton di satu negara, benua, subbenua, atau negara bagian AS lainnya dengan menyesuaikan nilai parameter filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Laporan 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 tersebut. Hasil diurutkan berdasarkan gender dan kemudian berdasarkan kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama bagi semua penonton di seluruh dunia atau semua penonton di satu negara, benua, subbenua, atau negara bagian AS lainnya dengan menyesuaikan parameter value filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Metrik berbagi, digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil berapa kali pengguna menggunakan tombol Share
untuk membagikan video channel. Hasil digabungkan menurut layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun dari jumlah pembagian.
dimensions=sharingService metrics=shares sort=-shares
Metrik retensi audiens untuk video
Laporan ini mengukur kemampuan video untuk mempertahankan audiensnya. Laporan hanya dapat diambil untuk satu video dalam satu waktu. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, 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 rekomendasi video. Dengan demikian, laporan 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 sejak 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 setelah 1 Juli 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Metrik pendapatan channel dan performa iklan
Permintaan ini mengambil metrik pendapatan dan performa iklan channel. 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
Metrik pendapatan harian dan performa iklan
Permintaan ini mengambil pendapatan harian dan metrik performa iklan channel.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Metrik pendapatan dan performa iklan spesifik per negara
Permintaan ini mengambil metrik pendapatan dan performa iklan spesifik per negara untuk suatu channel. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti negara pertama yang tercantum akan menjadi negara tempat partner memiliki pendapatan bersih terbesar.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 Teratas – Video dengan pendapatan tertinggi
Permintaan ini mengambil metrik pendapatan dan performa iklan untuk 10 video channel dengan pendapatan terbesar. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti video pertama akan menjadi video yang memiliki estimasi pendapatan tertinggi.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Metrik performa iklan untuk berbagai jenis iklan
Permintaan ini mengambil metrik performa iklan untuk konten yang diklaim oleh pemilik konten. Hasil dikelompokkan berdasarkan jenis iklan, yang memungkinkan Anda membandingkan pendapatan dan nilai CPM di berbagai jenis iklan.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Laporan 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 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==claimed
Jumlah penayangan spesifik per negara (dan lain-lain) 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==FR
Total jumlah penayangan (dan banyak lagi) 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==claimed
Total jumlah penayangan (dan lain-lain) 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==self
Total jumlah penayangan (dan banyak lagi) untuk semua konten yang diklaim dan diupload sendiri
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==claimed
10 Teratas – Video yang paling sering ditonton untuk pemilik konten
Kueri ini mendapatkan 10 video yang paling sering ditonton, yang diukur berdasarkan jumlah penayangan selama rentang tanggal tertentu, 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=-views
10 Teratas – Video yang paling sering ditonton untuk pemilik konten
Kueri ini mendapatkan data 10 video yang paling sering ditonton, yang diukur berdasarkan estimasi menit yang ditonton selama rentang tanggal tertentu, yang diupload pemilik konten. Hasil diurutkan menurut estimasi menit yang ditonton dalam urutan menurun.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 Teratas – Video yang paling sering ditonton di channel pemilik konten
Kueri ini mengambil 10 video yang paling sering ditonton untuk channel tertentu atau grup channel yang dikelola oleh pemilik konten. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 Teratas – Anotasi rasio klik-tayang untuk video yang paling banyak ditonton di channel
Permintaan ini akan mengambil jumlah penayangan, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk 10 video yang paling banyak ditonton di suatu saluran atau grup saluran tertentu. Hasil diurutkan berdasarkan jumlah penayangan dengan urutan menurun. Artinya, video yang paling sering ditonton akan dicantumkan terlebih dahulu. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Laporan playlist
Penayangan playlist untuk channel pemilik konten
Permintaan ini mengambil total pemulaian playlist, perkiraan menit ditonton, penayangan
playlist, dan penayangan per mulai playlist untuk playlist di channel pemilik konten. Metrik
playlistViews
hanya menghitung jumlah tontonan video yang terjadi dalam konteks
playlist. Karena semua metrik yang diminta merupakan metrik dalam playlist, permintaan juga tidak
perlu menyertakan filter playlist atau grup.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistik untuk playlist tertentu
Permintaan ini mengambil total jumlah mulai playlist, estimasi menit ditonton, penayangan (metrik video gabungan), jumlah penayangan playlist (metrik dalam playlist), dan penayangan per awal playlist untuk playlist tertentu. Perlu diperhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, 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_ID
Untuk 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 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=day
Metrik 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 pemilik konten. Hasil diurutkan dalam urutan kronologis.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Laporan playlist
Penayangan playlist harian untuk pemilik konten
Permintaan ini mengambil metrik untuk interaksi pengguna harian dengan video dalam playlist pemilik konten. Metrik yang diambil dalam laporan adalah playlistViews, playlistStarts, playlistEstimatedMinutesWatched, dan viewsPerPlaylistStart. Semua metrik ini merupakan metrik dalam playlist. Karena semua metrik yang diminta merupakan metrik dalam playlist, permintaan tidak perlu menyertakan filter playlist atau grup juga.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Laporan video
Metrik waktu tonton spesifik per negara untuk konten yang diupload sendiri
Kueri ini mengambil jumlah penayangan, metrik waktu tonton, dan estimasi pendapatan iklan untuk setiap negara. Metrik tersebut untuk video yang diupload pemilik konten. Laporan ini menampilkan satu baris data untuk setiap negara tempat video ditonton, dan baris diurutkan dalam urutan menurun dari jumlah menit ditonton.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Metrik anotasi khusus negara untuk konten yang diupload sendiri
Permintaan ini mengambil jumlah penayangan spesifik per negara, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk video yang diupload pemilik konten. Hasil diurutkan menurut rasio klik-tayang anotasi dalam urutan menurun, yang berarti negara dengan rasio klik-tayang anotasi tertinggi akan dicantumkan terlebih dahulu.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Metrik spesifik per provinsi untuk negara bagian AS dan Washington D.C.
Permintaan ini mengambil perincian jumlah penayangan dari setiap provinsi, estimasi menit ditonton, dan rata-rata durasi tonton untuk video yang diklaim pemilik konten. Data tersebut mencakup negara bagian AS dan Hasil Washington D.C. diurutkan menurut abjad berdasarkan kode ISO 3166-2 provinsi.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 kota teratas di AS menurut total penayangan
Kueri ini mengambil daftar 10 kota di AS yang menyumbang penayangan terbanyak untuk video yang diklaim pemilik konten selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk negara lain dengan memilih nilai valid lainnya untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subbenua, 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=-views
10 kota teratas di AS berdasarkan total penayangan untuk setiap jenis konten
Kueri ini mengambil daftar 10 kota di AS yang menghasilkan penayangan terbanyak untuk konten yang diklaim pemilik konten selama rentang tanggal yang ditentukan untuk setiap creatorContentType yang didukung. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun.
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
10 kota teratas AS menurut total waktu tonton
Kueri ini mengambil daftar 10 hari teratas selama rentang tanggal yang ditentukan saat ada kota di AS yang menghasilkan 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 ditonton. Hasil diurutkan dalam urutan menurun dari total waktu tonton.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
10 Teratas – Video yang paling sering ditonton di Eropa
Kueri ini mengambil 10 video yang paling sering ditonton di Eropa, di antara video yang diklaim oleh pemilik konten, sebagaimana diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk benua lain dengan memilih nilai valid lainnya untuk filter tersebut. Demikian pula, kueri dapat diubah untuk mengambil data untuk subbenua, seperti Eropa Barat atau Asia Tenggara, dengan menggunakan filter subContinent dan salah satu nilainya 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=-estimatedMinutesWatched
Laporan playlist
Metrik waktu tonton spesifik per negara untuk playlist pemilik konten
Kueri ini mengambil jumlah penayangan playlist spesifik per 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 dari jumlah menit ditonton.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 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=-playlistStarts
Laporan video
Penilaian 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 APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Laporan video
Jumlah penayangan dan waktu tonton dari lokasi pemutaran yang berbeda
Kueri ini mendapatkan jumlah penayangan dan perkiraan waktu tonton untuk video yang diupload ke saluran atau grup saluran tertentu. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasilnya diurutkan dalam urutan menurun menurut jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton di Amerika Serikat untuk video yang diupload ke saluran atau grup saluran 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 APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
10 Teratas – Situs pihak ketiga yang menghasilkan penayangan terbanyak untuk video sematan
Kueri ini mengambil jumlah penayangan dan perkiraan waktu tonton untuk video atau kelompok video tertentu. Hasil dikelompokkan menurut situs pihak ketiga tempat video disematkan. Hasil diurutkan dalam urutan menurun menurut jumlah penayangan. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string VIDEO_ID
di nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID video untuk video yang Anda upload.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan playlist, estimasi waktu tonton playlist, dan pemutaran playlist untuk semua playlist di channel pemilik konten. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasilnya diurutkan dalam urutan menurun berdasarkan pemutaran playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Jumlah penayangan playlist dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil data dimulainya playlist harian, jumlah penayangan playlist, dan estimasi waktu tonton playlist di Amerika Serikat untuk semua playlist di channel pemilik konten. Hasil akan 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 tersebut. Metrik ini digabungkan berdasarkan sumber traffic, yang menjelaskan cara pengguna menjangkau video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Jumlah 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 digabungkan setiap hari berdasarkan sumber traffic dan diurutkan dalam urutan kronologis terbalik.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Catatan: Dua contoh laporan berikutnya hanya didukung untuk sumber traffic tertentu. Misalnya, sumber traffic NO_LINK_EMBEDDED
tidak memiliki detail tambahan, sehingga laporan ini tidak tersedia untuk sumber tersebut. Lihat definisi insightTrafficSourceType untuk mengetahui detail tentang sumber traffic yang menyediakan jenis laporan ini.
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 sekelompok video tertentu. Hasil diurutkan berdasarkan jumlah penayangan dalam urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string VIDEO_ID
di nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 Teratas – Situs eksternal yang menghasilkan traffic terbanyak untuk suatu video
Kueri ini mengambil 10 situs web eksternal yang menghasilkan penayangan terbanyak dari hasil penelusuran Google untuk video atau sekelompok video tertentu. Hasil diurutkan menurut estimasi waktu tonton dengan urutan menurun. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, Anda harus mengganti string VIDEO_ID
di nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di suatu negara
Permintaan ini mengambil jumlah penayangan playlist, pemutaran playlist, dan estimasi waktu tonton playlist untuk penayangan playlist di negara tertentu. Metrik ini digabungkan berdasarkan sumber traffic, yang menjelaskan cara pengguna menjangkau playlist.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Jumlah penayangan playlist dan waktu tonton 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 APIs Explorer, Anda harus mengganti string
CHANNEL_ID
dalam nilai parameter filters
dengan daftar
yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Laporan video
Metrik jenis perangkat harian untuk video yang diklaim
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton berdasarkan 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=day
Metrik sistem operasi harian untuk video yang diklaim yang ditonton di perangkat seluler
Kueri ini mengambil jumlah penayangan harian dan perkiraan waktu tonton menurut sistem operasi untuk penayangan video yang diklaim oleh pemilik konten tertentu, yang terjadi di perangkat seluler. Hasil dikelompokkan menurut hari untuk tiap sistem operasi tempat pemutaran video terjadi. Hasil diurutkan dalam urutan kronologis.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Metrik jenis perangkat dan sistem operasi harian
Kueri ini mengambil jumlah penayangan harian dan perkiraan 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=day
Laporan 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 akan ditampilkan untuk setiap jenis perangkat tempat penayangan playlist terjadi. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string CHANNEL_ID
dalam nilai parameter filters
dengan daftar yang dipisahkan koma, yang berisi maksimal 500 ID saluran untuk saluran Anda.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Metrik 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==MOBILE
Laporan 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 tersebut. Hasil diurutkan berdasarkan gender dan kemudian berdasarkan kelompok usia. Kueri ini dapat diubah untuk mengambil statistik yang sama bagi semua penonton di seluruh dunia atau semua penonton di satu 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,ageGroup
Metrik berbagi, digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil berapa kali pengguna menggunakan tombol Share
untuk membagikan video yang diupload pemilik konten. Hasil digabungkan menurut layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun dari jumlah pembagian.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Metrik retensi audiens untuk video
Laporan ini mengukur kemampuan video untuk mempertahankan audiensnya. Laporan hanya dapat diambil untuk satu video dalam satu waktu. Perhatikan bahwa untuk menjalankan kueri ini di Penjelajah API, 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 rekomendasi video. Dengan demikian, laporan 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 sejak 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 setelah 1 Juli 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Metrik 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==claimed
Metrik pendapatan harian dan performa iklan
Permintaan ini mengambil pendapatan harian dan metrik performa iklan untuk konten yang diklaim pemilik konten.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Metrik pendapatan dan performa iklan spesifik per negara
Permintaan ini mengambil pendapatan spesifik per negara dan metrik performa iklan untuk konten yang diklaim oleh pemilik konten. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan, yang berarti negara pertama yang tercantum akan menjadi negara tempat partner memiliki estimasi pendapatan terbesar.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 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 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=-estimatedRevenue
Metrik performa iklan untuk berbagai jenis iklan
Permintaan ini mengambil metrik performa iklan untuk konten yang diklaim oleh pemilik konten. Hasil dikelompokkan berdasarkan jenis iklan, yang memungkinkan Anda membandingkan pendapatan dan nilai CPM di berbagai jenis iklan.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType