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) dari 2023-09-01 dan 2024-03-31.
Setelah menautkan ke APIs Explorer, Anda masih harus menentukan channel atau pemilik konten yang laporannya akan Anda ambil. APIs Explorer akan mengisi nilai parameter ids dengan channel==MINE atau contentOwner==CONTENT_OWNER_ID, bergantung pada kueri yang telah 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 di 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,-views
Hasilnya akan 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 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 saluran
Laporan video
Total jumlah penayangan, estimasi waktu tonton, dan lainnya 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 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 banyak ditonton untuk suatu channel
Kueri ini mengambil 10 video yang paling sering ditonton di suatu channel, yang diukur berdasarkan estimasi menit yang ditonton selama rentang tanggal yang ditentukan. Hasil diurutkan berdasarkan estimasi menit 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 – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di saluran
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 menurut 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=-views
Laporan playlist
Total penayangan playlist untuk sebuah channel
Permintaan ini mengambil total pemutaran playlist, estimasi menit ditonton, penayangan ( metrik video gabungan), 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 pemutaran playlist, estimasi menit ditonton, penayangan (
metrik video gabungan),
penayangan playlist (metrik dalam playlist),
dan penayangan per playlist dimulai untuk playlist tertentu. Perhatikan bahwa untuk menjalankan kueri ini dalam API
Penjelajah, Anda harus mengganti string PLAYLIST_ID di filters
dengan ID playlist untuk playlist di channel 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 sebuah channel
Kueri ini mengambil 10 playlist yang paling sering ditonton di channel, yang diukur berdasarkan penayangan playlist selama rentang tanggal yang ditentukan. Langkah ini juga mengambil beberapa metrik playlist lainnya, seperti berapa kali penonton memulai pemutaran setiap playlist dan rata-rata jumlah waktu yang dihabiskan penonton untuk menonton video dalam playlist setelah video tersebut dimulai. Hasilnya adalah 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 channel
Kueri ini mengambil jumlah penayangan harian, metrik waktu tonton, dan jumlah subscriber baru untuk video di suatu 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=day
Metrik anotasi harian untuk video channel
Permintaan ini mengambil jumlah penayangan harian, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk konten saluran. 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 tampilan harian (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), mulainya playlist, estimasi menit ditonton, dan penayangan per playlist dimulai untuk yang diautentikasi pada saluran pengguna. 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 channel
Kueri ini mengambil jumlah penayangan spesifik per negara, metrik waktu tonton, dan jumlah langganan untuk video saluran. Laporan ini menampilkan satu baris data untuk setiap negara tempat video di channel tersebut ditonton. Baris diurutkan dalam urutan menurun sesuai jumlah menit yang 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 tersebut. 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 khusus provinsi untuk negara bagian AS dan Washington D.C.
Permintaan ini mengambil perincian jumlah penayangan, perkiraan menit ditonton, dan rata-rata durasi tonton video di channel tersebut menurut provinsi. Data tersebut meliputi negara bagian AS dan Washington D.C. Hasil diurutkan menurut abjad berdasarkan provinsi Kode ISO 3166-2.
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 tersebut, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan, di negara tertentu. 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=-views
10 kota teratas di AS berdasarkan total penayangan
Kueri ini mengambil daftar 10 kota di AS yang berkontribusi terhadap penayangan konten saluran terbanyak 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 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 menurut jumlah penayangan dalam urutan menurun.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views
10 kota teratas di AS menurut total penayangan untuk setiap jenis konten
Kueri ini mengambil daftar 10 kota di AS yang berkontribusi terhadap penayangan konten channel terbanyak selama rentang tanggal yang ditentukan untuk setiap creatorContentType yang didukung. Hasil diurutkan menurut jumlah penayangan dalam urutan menurun.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views
10 kota teratas di AS berdasarkan total waktu tonton
Kueri ini mengambil daftar 10 hari teratas selama rentang tanggal yang ditentukan saat kota di AS mana pun yang berkontribusi terhadap 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=-estimatedWatchTime
10 Teratas – Video yang paling banyak ditonton di Eropa
Kueri ini mengambil 10 video yang paling sering ditonton di channel tersebut 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 lain 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 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=continent==150 maxResults=10 sort=-views
Laporan playlist
Metrik waktu tonton spesifik per negara untuk playlist channel
Kueri ini mengambil jumlah tampilan spesifik per negara (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), dan metrik waktu tonton untuk playlist suatu channel. Laporan ini menampilkan satu baris data untuk setiap negara tempat playlist channel ditonton. Baris diurutkan dalam urutan menurun sesuai jumlah menit yang 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 berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan dan estimasi 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 estimasi waktu tonton di Amerika Serikat untuk video dari 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 estimasi waktu tonton untuk video atau grup video tertentu. Hasilnya dikelompokkan oleh 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 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 mengambil jumlah tampilan (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), perkiraan waktu tonton, dan playlist dimulai untuk playlist di channel tertentu. Hasilnya adalah digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasil diurutkan dalam urutan menurun berdasarkan permulaan daftar putar.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Jumlah penayangan playlist harian dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil data pemutaran {i>playlist<i} harian, jumlah penayangan ( metrik video gabungan), penayangan playlist (metrik dalam playlist), dan perkiraan 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=day
Laporan 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,dislikes
Laporan 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 tersebut digabungkan menurut 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 ini digabungkan setiap hari menurut 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 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 APIs Explorer, Anda harus mengganti string VIDEO_ID dalam 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 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=-views
Top 10 – Situs eksternal yang menghasilkan traffic terbanyak untuk sebuah video
Kueri ini mengambil 10 situs eksternal yang menghasilkan penayangan terbanyak untuk video atau grup video tertentu. Hasil diurutkan berdasarkan estimasi 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=-estimatedMinutesWatched
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di satu negara
Permintaan ini akan mengambil jumlah tampilan (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), dimulainya playlist, dan estimasi waktu tonton untuk penayangan playlist di negara tertentu. Tujuan 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 daftar putar harian saluran ( in-playlist), dimulainya playlist, dan estimasi waktu tonton. Ini juga mengambil total tampilan (sebuah metrik video gabungan). Metrik ini digabungkan setiap hari menurut 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 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=day
Metrik sistem operasi harian untuk perangkat seluler
Kueri ini mengambil jumlah penayangan harian dan estimasi waktu tonton di perangkat seluler untuk video dari 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=day
Metrik 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=day
Laporan playlist
Metrik jenis perangkat harian untuk penayangan playlist di sistem operasi Android
Kueri ini mengambil tampilan harian (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), dan perkiraan waktu tonton di perangkat Android untuk playlist saluran tertentu. Hasilnya adalah yang 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 mengambil tampilan harian (sebuah metrik video gabungan), penayangan playlist (metrik dalam playlist), dan perkiraan waktu tonton di perangkat seluler untuk playlist channel tertentu. Hasilnya adalah 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=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. 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=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 menurut gender, lalu menurut kelompok usia. Ini
kueri dapat dimodifikasi untuk mengambil statistik yang sama untuk semua penonton di seluruh dunia atau
pelihat 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,ageGroup
Metrik berbagi, digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil jumlah berapa kali pengguna menggunakan tombol Share untuk membagikan video channel. Hasil digabungkan dengan layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun menurut 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 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 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. Dengan demikian, laporan ini tidak menyertakan data untuk penayangan dari iklan TrueView in-stream atau iklan TrueView dalam-tampilan. 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 berfungsi untuk tanggal berapa pun setelah 1 Juli 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Metrik pendapatan channel dan performa iklan
Permintaan ini akan mengambil metrik performa iklan dan pendapatan 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 akan mengambil metrik performa iklan dan pendapatan harian 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 channel. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan. Artinya, 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 di channel yang memiliki pendapatan terbesar. 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 maxResults=10 sort=-estimatedRevenue
Metrik 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=-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 lainnya) untuk semua video yang diupload sendiri
Kueri ini mengambil metrik untuk negara tertentu 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,shares filters=uploaderType==self;country==FR
Total 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==claimed
Total 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==self
Total jumlah penayangan (dan lainnya) untuk semua konten yang diklaim dan diupload sendiri
Kueri ini mengambil metrik gabungan untuk video yang diupload pemilik konten dan juga diklaim. 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 mengambil 10 video yang paling sering ditonton, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan, yang diupload pemilik konten. Hasil diurutkan menurut 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 mengambil 10 video yang paling sering ditonton, yang diukur berdasarkan estimasi menit yang ditonton selama rentang tanggal yang ditentukan, yang diupload 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=-estimatedMinutesWatched
10 Teratas – Video yang paling sering 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 menurut 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 hingga 500 ID saluran untuk saluran Anda.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di saluran
Permintaan ini mengambil jumlah penayangan, rasio klik-tayang anotasi, tingkat penutupan anotasi, dan tayangan anotasi untuk 10 video yang paling sering ditonton di saluran atau grup saluran tertentu. Hasil diurutkan menurut jumlah penayangan dalam urutan menurun, yang berarti video yang paling banyak 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 hingga 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 pemutaran playlist, estimasi menit playlist ditonton, playlist
penayangan, dan penayangan per playlist dimulai untuk playlist di channel pemilik konten. Tujuan
Metrik playlistViews hanya menghitung jumlah tontonan video yang terjadi dalam konteks
playlist. Karena semua metrik yang diminta adalah metrik dalam daftar putar, permintaan tidak
juga perlu menyertakan filter playlist atau grup.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistik untuk playlist tertentu
Permintaan ini mengambil total pemutaran playlist, estimasi menit ditonton, penayangan (
metrik video gabungan),
penayangan playlist (metrik dalam playlist),
dan penayangan per playlist dimulai untuk playlist tertentu. Perhatikan bahwa untuk menjalankan kueri ini dalam API
Penjelajah, Anda harus mengganti string PLAYLIST_ID di filters
dengan ID playlist untuk playlist di salah satu channel 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, tingkat 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 interaksi pengguna harian dengan video dalam playlist. 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 sertakan juga filter playlist atau grup.
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 ini ditujukan untuk video yang diupload pemilik konten. Laporan ini menampilkan satu baris data untuk setiap negara tempat video ditonton, dan baris diurutkan dalam urutan penurunan jumlah menit ditonton.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Metrik anotasi spesifik per 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 khusus provinsi untuk negara bagian AS dan Washington D.C.
Permintaan ini mengambil perincian jumlah penayangan, perkiraan menit ditonton, dan rata-rata durasi tonton video yang diklaim pemilik konten berdasarkan provinsi. Data tersebut meliputi negara bagian AS dan Washington D.C. Hasil diurutkan menurut abjad berdasarkan provinsi Kode ISO 3166-2.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 kota teratas di AS berdasarkan total penayangan
Kueri ini mendapatkan daftar 10 kota AS yang berkontribusi terhadap 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 lain 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 menurut jumlah penayangan dalam urutan menurun.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views
10 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=-views
10 kota teratas di AS menurut total waktu tonton
Kueri ini mendapatkan daftar 10 hari teratas selama rentang tanggal yang ditentukan saat kota AS mana pun yang berkontribusi terhadap total waktu tonton harian terbesar untuk konten yang diklaim pemilik konten. 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=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime
10 Teratas – Video yang paling banyak ditonton di Eropa
Kueri ini mendapatkan 10 video yang paling sering ditonton di Eropa, di antara video yang diklaim oleh pemilik konten, yang diukur berdasarkan jumlah penayangan selama rentang tanggal yang ditentukan. Kueri dapat diubah guna meminta data untuk benua lain dengan memilih nilai valid lain 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 menurut 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 dengan urutan menurun sesuai 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 diakses penonton Amerika Serikat mulai menonton paling sering selama rentang tanggal yang ditentukan. Hasilnya adalah diurutkan berdasarkan jumlah playlist dimulai dalam urutan menurun.
Catatan: Karena laporan ini menggunakan kolom
playlist dimensi, Anda harus
tentukan nilai untuk parameter permintaan sort dan juga tetapkan nilai
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 pada saluran atau grup saluran 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 hingga 500 ID saluran untuk saluran Anda.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Laporan video
Jumlah penayangan dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan dan estimasi 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 hingga 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 estimasi 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 hingga 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 estimasi waktu tonton untuk video atau grup video tertentu. Hasilnya dikelompokkan oleh 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=-views
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah penayangan {i>playlist<i}, perkiraan waktu tonton {i>playlist<i}, dan daftar putar dimulai untuk semua daftar putar di saluran pemilik konten. Hasil digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi, dan hasilnya diurutkan dalam urutan menurun berdasarkan awal playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Jumlah penayangan playlist dan waktu tonton dari berbagai lokasi pemutaran
Kueri ini mengambil jumlah pemutaran playlist harian, jumlah penayangan playlist, dan estimasi tontonan playlist waktu di Amerika Serikat untuk semua playlist di saluran 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 tersebut digabungkan menurut 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 ini digabungkan setiap hari menurut 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 video
Kueri ini mengambil 10 istilah penelusuran yang menghasilkan penayangan terbanyak dari hasil penelusuran YouTube untuk video atau grup video tertentu. Hasil diurutkan menurut 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 hingga 500 ID video untuk video yang Anda upload.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 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 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=-estimatedMinutesWatched
Laporan playlist
Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di satu negara
Permintaan ini mengambil jumlah penayangan playlist, pemutaran playlist, dan estimasi tontonan playlist untuk penayangan playlist di negara tertentu. Metrik tersebut digabungkan berdasarkan sumber traffic, yang menjelaskan cara pengguna membuka 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 daftar putar di satu atau beberapa saluran pemilik konten. Metrik tersebut digabungkan menurut
sumber traffic tertentu. Perhatikan bahwa untuk menjalankan kueri ini di APIs Explorer, Anda harus mengganti string
CHANNEL_ID di nilai parameter filters dengan dipisahkan koma
hingga 500 ID channel untuk channel 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 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=day
Metrik sistem operasi harian untuk video yang diklaim dan 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 terjadi 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=day
Metrik 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=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 daftar putar di satu atau beberapa saluran pemilik konten. Hasil ditampilkan untuk
setiap jenis perangkat tempat penayangan playlist terjadi. Perhatikan bahwa untuk menjalankan kueri ini dalam API
Penjelajah, Anda harus mengganti string CHANNEL_ID di filters
dengan daftar yang dipisahkan koma hingga 500 ID channel untuk channel 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 pada perangkat seluler untuk daftar putar di saluran pemilik konten mana pun. Hasil ditampilkan untuk setiap sistem operasi tempat terjadinya penayangan daftar putar.
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 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,ageGroup
Metrik berbagi, digabungkan menurut layanan tempat video dibagikan
Permintaan ini mengambil jumlah berapa kali pengguna menggunakan tombol Share untuk membagikan video yang diupload pemilik konten. Hasil digabungkan dengan layanan berbagi (Google+, Twitter, dll.) dan diurutkan dalam urutan menurun menurut 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 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 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. Dengan demikian, laporan ini tidak menyertakan data untuk penayangan dari iklan TrueView in-stream atau iklan TrueView dalam-tampilan. 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 berfungsi untuk tanggal berapa pun 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 metrik pendapatan harian dan 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 metrik pendapatan spesifik per negara dan performa iklan untuk konten yang diklaim pemilik konten. Hasil diurutkan dalam urutan menurun berdasarkan jumlah pendapatan. Artinya, 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 yang 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=-estimatedRevenue
Metrik 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=-adType