Dokumen ini menjelaskan dimensi yang didukung YouTube Analytics API. API ini mendukung kueri real-time bertarget untuk membuat laporan YouTube Analytics kustom.
Dimensi adalah kriteria umum yang digunakan untuk menggabungkan data, seperti tanggal terjadinya aktivitas pengguna atau negara tempat pengguna berada.
Setiap laporan kueri mengidentifikasi dimensi yang didukungnya. Misalnya, saat mengambil aktivitas pengguna menurut waktu, Anda memilih jangka waktu data yang akan dilaporkan: hari atau bulan. Di laporan apa pun, setiap baris data memiliki kombinasi nilai dimensi yang unik.
Untuk mengambil laporan kueri, panggil metode reports.query
YouTube Analytics API. Dalam permintaan Anda, gunakan parameter dimensions
untuk menentukan dimensi yang akan digunakan YouTube untuk menghitung nilai metrik dalam laporan.
Dimensi inti
Meskipun YouTube Analytics API tunduk pada Kebijakan Penghentian Layanan yang dijelaskan dalam Persyaratan Layanan, dimensi non-inti (dan metrik non-inti) tidak tunduk pada kebijakan tersebut. Dalam definisi di halaman ini, dimensi apa pun yang merupakan dimensi inti secara eksplisit diidentifikasikan secara eksplisit.
Daftar berikut mengidentifikasi dimensi inti API.
Baca daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk mengetahui informasi lebih lanjut.
Filter
Semua laporan kueri mendukung filter. Filter mengidentifikasi nilai dimensi yang harus ada dalam set data yang diambil. Dengan demikian, fungsi tersebut membatasi respons API agar hanya menyertakan data yang cocok dengan nilai atau kumpulan nilai tertentu. Misalnya, alih-alih mengambil metrik aktivitas pengguna untuk semua negara, Anda dapat menggunakan filter untuk hanya mengambil data untuk negara tertentu.
Dalam permintaan untuk mengambil laporan kueri, parameter permintaan filters
opsional menentukan nilai dimensi yang datanya ingin Anda filter. Misalnya, untuk mengambil metrik aktivitas pengguna di Eropa, Anda harus menetapkan nilai parameter filters
ke continent==150
.
Penting: Permintaan API untuk mengambil laporan pemilik konten harus memfilter data menggunakan salah satu dimensi entitas pelaporan atau menggunakan kombinasi dimensi claimedStatus
dan uploaderType
yang didukung.
Dimensi
Bagian berikut menentukan dimensi yang digunakan dalam laporan kueri YouTube Analytics API. Kecuali jika dinyatakan lain, dimensi ini digunakan dalam laporan channel dan pemilik konten. Dimensi yang hanya dapat digunakan sebagai filter juga diidentifikasi.
Referensi
Dimensi ini sesuai dengan sumber daya yang dikelola channel dan pemilik konten di YouTube:
Catatan: API memungkinkan Anda menentukan beberapa nilai untuk dimensi video
, playlist
, dan channel
saat digunakan sebagai filter. Untuk melakukannya, setel nilai parameter filters
ke daftar yang dipisahkan koma dari ID video, playlist, atau channel yang respons API-nya harus difilter. Nilai parameter dapat menentukan hingga 500 ID.
- video (dimensi inti)
- ID video YouTube. Di YouTube Data API, ini adalah nilai properti
id
resourcevideo
. This is a core dimension and is subject to the Deprecation Policy. - playlist
- ID playlist YouTube. Di YouTube Data API, ini adalah nilai properti
id
resourceplaylist
. - channel (dimensi inti) (hanya digunakan dalam laporan pemilik konten)
- ID untuk channel YouTube. Di YouTube Data API, ini adalah nilai properti
id
resourcechannel
. This is a core dimension and is subject to the Deprecation Policy.
Dimensichannel
sering digunakan dalam laporan pemilik konten karena laporan tersebut biasanya menggabungkan data untuk beberapa saluran. - grup (hanya filter)
- ID grup YouTube Analytics. Anda dapat mengambil nilai ini menggunakan metode
groups.list
YouTube Analytics API. Saat Anda menggunakan filtergroup
, respons API akan berisi data untuk semua video, playlist, atau channel dalam grup tersebut.
Contoh
Contoh permintaan berikut menggunakan dimensi atau filter entitas pelaporan:
Contoh channel
-
Statistik dasar
- 10 Teratas – Video yang paling sering ditonton untuk suatu channel
- 10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di channel
- Statistik untuk playlist tertentu
- 10 Teratas – Playlist yang paling sering ditonton untuk suatu channel
-
Geografis
- 10 Teratas – Video yang paling sering ditonton di negara tertentu
- 10 Teratas – Video yang paling sering ditonton di Eropa
-
Statistik dasar
Contoh pemilik konten
-
Statistik dasar
- 10 Teratas - Video yang paling sering ditonton untuk pemilik konten
- 10 Teratas - Video yang paling sering ditonton untuk pemilik konten
- 10 Teratas - Video yang paling sering ditonton untuk channel pemilik konten
- 10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di channel
- 10 Teratas – Playlist yang paling sering ditonton untuk pemilik konten
-
Geografis
- 10 Teratas - Video yang paling banyak ditonton di Eropa untuk pemilik konten
- 10 Teratas – Playlist yang paling sering dimulai di Amerika Serikat
-
Statistik dasar
Area geografis
Dimensi ini mengidentifikasi wilayah geografis yang dikaitkan dengan metrik aktivitas pengguna, performa iklan, atau estimasi pendapatan.
- negara (dimensi inti)
- Negara yang terkait dengan metrik dalam baris laporan. Nilai dimensi adalah kode negara dua huruf sesuai standar ISO-3166-1, seperti
US
,CN
(China), atauFR
(Prancis). Kode negaraZZ
digunakan untuk melaporkan metrik yang negara terkaitnya tidak dapat diidentifikasi oleh YouTube. This is a core dimension and is subject to the Deprecation Policy. - province
- Negara bagian atau wilayah AS yang terkait dengan metrik di baris laporan. Nilai dimensi adalah kode ISO 3166-2 yang mengidentifikasi negara bagian AS atau District of Columbia, seperti
US-MI
(Michigan) atauUS-TX
(Texas). Kode provinsiUS-ZZ
digunakan untuk melaporkan metrik yang mana YouTube tidak dapat mengidentifikasi negara bagian AS terkait. Jika permintaan API menyertakanprovince
dalam nilai parameterdimensions
, permintaan tersebut juga harus membatasi data ke Amerika Serikat dengan menyertakancountry==US
dalam nilai parameterfilters
.Catatan: Dimensi ini tidak mendukung nilai ISO 3166-2 yang mengidentifikasi area terpencil AS karena wilayah tersebut juga memiliki kode negara ISO 3166-1. Iklan ini juga tidak mendukung subdivisi negara selain Amerika Serikat.
- kota
- Estimasi kota yang terkait dengan metrik dalam baris laporan. Data untuk dimensi ini tersedia untuk tanggal mulai 1 Januari 2022.
- benua (hanya filter)
-
Kode wilayah statistik Perserikatan Bangsa-Bangsa (PBB). API ini mendukung nilai berikut:
Nilai 002
Afrika 019
Amerika (Amerika Utara, Amerika Latin, Amerika Selatan, dan Karibia) 142
Asia 150
Eropa 009
Oseania filters
kecontinent==REGION_CODE
, dengan menentukan nilaiREGION_CODE
dari daftar di atas. - subContinent (hanya filter)
-
Kode wilayah statistik PBB yang mengidentifikasi sub-wilayah geografis. Divisi Statistik PBB mencantumkan sub-wilayah serta negara yang dikaitkan dengan setiap wilayah.
Dimensi ini hanya dapat digunakan untuk memfilter data. Untuk menggunakan dimensi ini, tetapkan nilai parameter
filters
kesubContinent==REGION_CODE
, dengan menentukan nilaiREGION_CODE
dari daftar PBB.
Contoh
Contoh permintaan berikut menggunakan filter atau dimensi geografis:
Contoh channel
- Statistik dasar: Jumlah penayangan spesifik per negara (dan lainnya) untuk channel
-
Geografis
- Metrik waktu tonton spesifik per negara untuk video channel
- Metrik anotasi khusus negara untuk video channel
- Metrik khusus provinsi untuk negara bagian AS dan Washington D.C.
- Metrik waktu tonton spesifik per negara untuk playlist channel
- 10 Teratas – Playlist yang paling sering dimulai di Amerika Serikat
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- Sumber traffic: Jumlah penayangan dan waktu tonton dari berbagai sumber traffic di suatu negara
- Demografi: Demografi penonton di California (kelompok usia dan gender)
-
Video teratas
- 10 Teratas – Video yang paling sering ditonton di negara tertentu
- 10 Teratas – Video yang paling sering ditonton di Eropa
Contoh pemilik konten
- Statistik dasar: Jumlah penayangan spesifik per negara (dan lainnya) untuk semua video yang diupload sendiri
-
Geografis
- Metrik waktu tonton spesifik per negara untuk konten yang diupload sendiri
- Metrik anotasi khusus negara untuk konten yang diupload sendiri
- Metrik khusus provinsi untuk negara bagian AS dan Washington D.C.
- Metrik waktu tonton spesifik per negara untuk playlist pemilik konten
- 10 Teratas – Playlist yang paling sering dimulai di Amerika Serikat
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- Demografi: Demografi penonton di California (kelompok usia dan gender)
- Video teratas: 10 Teratas – Video yang paling sering ditonton di Eropa untuk pemilik konten
- Pendapatan/Performa iklan: Metrik performa iklan dan pendapatan spesifik per negara
Jangka waktu
Dimensi ini menunjukkan bahwa laporan harus menggabungkan data berdasarkan jangka waktu, seperti satu hari, seminggu, atau sebulan. Parameter permintaan startDate
dan endDate
menentukan jangka waktu laporan mencakup data. Perhatikan bahwa laporan sebenarnya menampilkan data hingga hari terakhir saat semua metrik yang ditentukan dalam permintaan tersedia pada saat kueri dibuat. Dalam laporan, tanggal tercantum dalam format YYYY-MM-DD
.
Penting: Semua tanggal mengacu pada jangka waktu yang dimulai pada pukul 00.00 waktu Pasifik (UTC-7 atau UTC-8) dan berakhir pada pukul 23.59 waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Akibatnya, tanggal saat jam disesuaikan maju untuk Waktu Musim Panas mewakili periode 23 jam, dan tanggal saat jam disesuaikan mundur mewakili jangka waktu 25 jam.
Dimensi bulan mengacu pada jangka waktu yang dimulai pada pukul 00.00 waktu Pasifik (UTC-7 atau UTC-8) pada hari pertama bulan dan tahun yang ditentukan.
- hari (dimensi inti)
- Jika Anda menggunakan dimensi ini, data dalam laporan akan digabungkan setiap hari dan setiap baris berisi data selama satu hari. Anda dapat menggunakan dimensi lain untuk membagi data lebih lanjut. Misalnya, laporan sumber traffic dapat menggabungkan statistik penayangan harian berdasarkan cara pengguna menjangkau video Anda. This is a core dimension and is subject to the Deprecation Policy.
- bulan (dimensi inti)
- Data dalam laporan digabungkan menurut bulan kalender. Seperti pada laporan harian, Anda dapat menggunakan filter lain untuk mengelompokkan data lebih jauh. Di laporan, tanggal tercantum dalam format
YYYY-MM
.
Catatan: Jika kueri API Anda menggunakan dimensimonth
, parameterstart-date
danend-date
harus ditetapkan ke hari pertama setiap bulan. This is a core dimension and is subject to the Deprecation Policy.
Contoh
Contoh permintaan berikut menggunakan dimensi atau filter sementara:
Contoh channel
-
Berbasis waktu
- Metrik waktu tonton harian untuk video channel
- Metrik anotasi harian untuk video channel
- Penayangan playlist harian untuk channel
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- Sumber traffic: Jumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
-
Perangkat/OS
- Metrik jenis perangkat harian untuk sistem operasi Android
- Metrik sistem operasi harian untuk perangkat seluler
- Metrik jenis perangkat dan sistem operasi harian
-
Berbasis waktu
Contoh pemilik konten
-
Berbasis waktu
- Metrik waktu tonton harian untuk konten yang diupload sendiri
- Metrik anotasi untuk konten yang diklaim
- Penayangan playlist harian untuk pemilik konten
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- Sumber traffic: Jumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
-
Perangkat/OS
- Metrik jenis perangkat harian untuk video yang diklaim
- Metrik sistem operasi harian untuk video yang diklaim yang ditonton di perangkat seluler
- Metrik jenis perangkat dan sistem operasi harian
- Pendapatan/Performa iklan: Metrik performa iklan dan pendapatan harian
-
Berbasis waktu
Lokasi pemutaran
Dimensi ini memberikan insight tentang halaman atau aplikasi tempat aktivitas pengguna terjadi.
- insightPlaybackLocationType
-
Data dalam laporan digabungkan berdasarkan jenis halaman atau aplikasi tempat pemutaran video terjadi. Nilai yang mungkin untuk dimensi ini adalah:
-
BROWSE
– Data tersebut menjelaskan penayangan yang terjadi di halaman beranda atau layar utama YouTube, di feed subscription pengguna, atau di fitur penjelajahan YouTube lainnya. -
CHANNEL
– Data tersebut menjelaskan penayangan yang terjadi di halaman channel. -
EMBEDDED
– Data ini menjelaskan penayangan yang terjadi di situs atau aplikasi lain tempat video disematkan menggunakan sematan<iframe>
atau<object>
. -
EXTERNAL_APP
– Data ini menjelaskan penayangan yang terjadi di aplikasi pihak ketiga, tempat video diputar menggunakan metode selain sematan<iframe>
atau<object>
. Misalnya, pemutaran dalam aplikasi yang menggunakan YouTube Android Player API akan dikategorikan menggunakan nilai ini. -
MOBILE
– Data tersebut menjelaskan penayangan yang terjadi di situs seluler YouTube atau pada klien YouTube API yang disetujui, termasuk perangkat seluler.Mulai tanggal 10 September 2013, pemutaran tidak lagi dikategorikan sebagai pemutaran
MOBILE
dalam laporan YouTube Analytics. Nilai tersebut mungkin tetap ada dalam laporan karena data lama masih termasuk dalam kategori tersebut. Namun, setelah tanggal tersebut, pemutaran seluler diklasifikasikan sebagai pemutaranWATCH
,EMBEDDED
, atauEXTERNAL_APP
, bergantung pada jenis aplikasi tempat pemutaran dilakukan. -
SEARCH
– Data tersebut menjelaskan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube. -
WATCH
– Data tersebut menjelaskan penayangan yang terjadi di halaman tonton video YouTube atau dalam aplikasi YouTube resmi, seperti aplikasi YouTube untuk Android. -
YT_OTHER
– Data ini menjelaskan penayangan yang tidak diklasifikasikan.
-
- insightPlaybackLocationDetail
- Data digabungkan berdasarkan halaman tempat pemain berada. Perhatikan bahwa laporan ini hanya didukung untuk penayangan yang terjadi di pemutar tersemat, dan laporan ini mengidentifikasi pemutar tersemat yang menghasilkan penayangan terbanyak untuk video tertentu. Dengan demikian, laporan tersebut memberikan gambaran yang lebih mendetail daripada laporan lokasi pemutaran dengan mengidentifikasi URL atau aplikasi yang terkait dengan pemutar sematan teratas.
Contoh
Contoh permintaan berikut menggunakan dimensi lokasi pemutaran:
Contoh channel
-
Lokasi pemutaran
- Jumlah penayangan dan waktu tonton dari berbagai lokasi pemutaran
- Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- 10 Teratas – Situs pihak ketiga yang menghasilkan penayangan terbanyak untuk video sematan
- Jumlah penayangan dan waktu tonton playlist dari berbagai lokasi pemutaran
- Jumlah penayangan playlist harian dan waktu tonton dari berbagai lokasi pemutaran
-
Lokasi pemutaran
Contoh pemilik konten
-
Lokasi pemutaran
- Jumlah penayangan dan waktu tonton dari berbagai lokasi pemutaran
- Jumlah penayangan harian dan waktu tonton dari berbagai lokasi pemutaran
- 10 Teratas – Situs pihak ketiga yang menghasilkan penayangan terbanyak untuk video sematan
- Jumlah penayangan dan waktu tonton playlist dari berbagai lokasi pemutaran
- Jumlah penayangan playlist harian dan waktu tonton dari berbagai lokasi pemutaran
-
Lokasi pemutaran
Detail pemutaran
- creatorContentType
- Dimensi ini mengidentifikasi jenis konten yang terkait dengan metrik aktivitas pengguna dalam baris data. Data untuk dimensi ini tersedia untuk tanggal mulai 1 Januari 2019.
Tabel berikut mencantumkan nilai dimensi:
Nilai LIVE_STREAM
Konten yang ditonton adalah live stream YouTube. SHORTS
Konten yang ditonton adalah YouTube Short. STORY
Konten yang ditonton adalah YouTube Story. VIDEO_ON_DEMAND
Konten yang ditonton adalah video YouTube yang tidak termasuk dalam salah satu nilai dimensi lainnya. UNSPECIFIED
Jenis konten untuk konten yang ditonton tidak diketahui. - liveOrOnDemand
- Dimensi ini menunjukkan apakah metrik aktivitas pengguna di baris data terkait dengan penayangan live streaming. Data untuk dimensi ini tersedia untuk tanggal mulai 1 April 2014.
Tabel berikut mencantumkan nilai dimensi:
Nilai LIVE
Data baris menjelaskan aktivitas pengguna yang terjadi selama siaran langsung. ON_DEMAND
Data baris menjelaskan aktivitas pengguna yang tidak terjadi selama siaran langsung. - subscribedStatus
- Dimensi ini menunjukkan apakah metrik aktivitas pengguna di baris data terkait dengan penonton yang subscribe ke channel video atau playlist.
Kemungkinan nilainya adalah
SUBSCRIBED
danUNSUBSCRIBED
.
Perhatikan bahwa nilai dimensi akurat pada saat aktivitas pengguna terjadi. Misalnya, seorang pengguna belum subscribe ke sebuah channel dan menonton salah satu video di channel tersebut, kemudian subscribe ke channel tersebut dan menonton video lainnya, semuanya pada hari yang sama. Laporan saluran menunjukkan bahwa satu penayangan memiliki nilaisubscribedStatus
sebesarSUBSCRIBED
, dan satu penayangan memiliki nilaisubscribedStatus
sebesarUNSUBSCRIBED
. - youtubeProduct
- Dimensi ini mengidentifikasi layanan YouTube tempat terjadinya aktivitas pengguna. Data untuk dimensi ini tersedia mulai 18 Juli 2015.
Tabel berikut mencantumkan nilai dimensi:
Nilai CORE
Aktivitas pengguna yang tidak terjadi di salah satu aplikasi YouTube khusus (YouTube Gaming, YouTube Kids, atau YouTube Music). Pengecualian: Aktivitas pengguna yang terjadi di YouTube Music sebelum 1 Maret 2021, disertakan di CORE
.GAMING
Aktivitas pengguna terjadi di YouTube Gaming. KIDS
Aktivitas pengguna terjadi di YouTube Kids. MUSIC
Aktivitas pengguna terjadi di YouTube Music pada atau setelah 1 Maret 2021. Data sebelum 1 Maret 2021 disertakan di CORE
. Data real-time tidak dicatat.UNKNOWN
Aktivitas pengguna terjadi sebelum 18 Juli 2015.
Sumber traffic
- insightTrafficSourceType
- Data dalam laporan digabungkan berdasarkan jenis perujuk, yang menjelaskan cara pengguna menjangkau video. Nilai yang mungkin untuk dimensi ini adalah:
ADVERTISING
– Penonton diarahkan ke video tersebut oleh iklan. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan mengidentifikasi jenis iklan.ANNOTATION
– Penonton menjangkau video dengan mengklik anotasi dalam video lain.CAMPAIGN_CARD
– Penayangan yang berasal dari video yang diklaim dan diupload pengguna, yang digunakan pemilik konten untuk mempromosikan konten yang telah ditonton. Sumber traffic ini hanya didukung untuk laporan pemilik konten.END_SCREEN
– Penayangan dirujuk dari layar akhir video lain.EXT_URL
– Jumlah tontonan video dirujuk dari link di situs lain. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan mengidentifikasi halaman web. Sumber traffic ini mencakup rujukan dari hasil penelusuran Google.HASHTAGS
– Penayangan yang berasal dari halaman hashtag VOD atau halaman pivot hashtag Shorts.LIVE_REDIRECT
- Jumlah tontonan video dirujuk dari Live Redirect.NO_LINK_EMBEDDED
– Video disematkan di situs lain saat ditonton.NO_LINK_OTHER
– YouTube tidak mengidentifikasi perujuk untuk traffic. Kategori ini mencakup traffic langsung ke video serta traffic di aplikasi seluler.NOTIFICATION
– Jumlah tontonan video dirujuk dari email atau notifikasi dari YouTube.PLAYLIST
– Jumlah tontonan video terjadi saat video diputar sebagai bagian dari playlist. Hal ini mencakup traffic yang berasal dari halaman playlist.PRODUCT_PAGE
- Jumlah tontonan video dirujuk dari halaman Produk.PROMOTED
– Jumlah tontonan video dirujuk dari promosi YouTube tidak berbayar, seperti halaman "Video Sorotan" YouTube.RELATED_VIDEO
– Jumlah tontonan video dirujuk dari listingan video terkait di halaman tonton video lain. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan ID video untuk video tersebut.SHORTS
– Penonton diarahkan dengan menggeser secara vertikal dari video sebelumnya dalam pengalaman menonton video Shorts.SOUND_PAGE
– Penayangan yang berasal dari halaman pivot audio Shorts.SUBSCRIBER
– Jumlah tontonan video dirujuk dari feed di halaman beranda YouTube atau dari fitur subscription YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
menentukan item feed halaman beranda atau halaman lain tempat tampilan diarahkan.YT_CHANNEL
– Jumlah tontonan video terjadi di halaman channel. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan ID saluran untuk saluran tersebut.YT_OTHER_PAGE
– Jumlah tontonan video dirujuk dari link selain hasil penelusuran atau link video terkait yang muncul di halaman YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan mengidentifikasi halaman.YT_SEARCH
– Jumlah tontonan video dirujuk dari hasil penelusuran YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan istilah penelusuran.VIDEO_REMIXES
– Jumlah tontonan video dirujuk dari link video remix di pemutar Shorts. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan video tempat penonton diarahkan.
- insightTrafficSourceDetail
- Data dalam laporan digabungkan berdasarkan perujuk yang menghasilkan penayangan terbanyak untuk video tertentu dan jenis sumber traffic tertentu. Daftar berikut mengidentifikasi sumber traffic yang laporannya tersedia. Untuk setiap sumber traffic, daftar tersebut mengidentifikasi informasi yang disediakan dimensi
insightTrafficSourceDetail
.ADVERTISING
– Jenis iklan yang menghasilkan penayangan. Kemungkinan nilainya adalah:- Iklan engagement klik untuk putar
- Iklan engagement
- Iklan penelusuran Google
- Iklan video beranda
- In-stream yang dapat dilewati dan dicadangkan
- TrueView dalam-penelusuran dan dalam-tampilan
- TrueView in-stream
- Iklan YouTube yang tidak dikategorikan
- Video wall
CAMPAIGN_CARD
– Video yang diklaim yang mengarahkan penonton ke video yang diidentifikasi dalam laporan.END_SCREEN
– Video yang mengarahkan penonton ke video yang diidentifikasi dalam laporan.EXT_URL
– Situs yang mengarahkan penonton ke video tersebut.HASHTAGS
– Hashtag yang menghasilkan penayangan.NOTIFICATION
– Email atau notifikasi yang merujuk traffic.RELATED_VIDEO
– Video terkait yang mengarahkan penonton ke video yang tercakup dalam laporan.SOUND_PAGE
– Video yang menghasilkan penayangan.SUBSCRIBER
– Elemen feed halaman beranda atau fitur subscription YouTube yang mengarahkan penonton ke video yang tercakup dalam laporan. Nilai yang valid adalah:activity
– Penayangan dari item dalam feed subscription di halaman beranda yang berasal dari aktivitas channel selain upload dan non-sosial, termasuk suka, favorit, postingan buletin, dan tambahan playlist.blogged
– Penayangan dari item dalam feed subscription di halaman beranda yang berasal dari link dari blog teratas.mychannel
– Penayangan dari item dalam feed lain yang tercantum di halaman beranda, seperti "Suka", "Histori Tontonan", dan "Tonton Nanti".podcasts
– Penayangan yang berasal dari item di halaman tujuan Podcast.sdig
– Penayangan yang berasal dari email pembaruan langganan.uploaded
– Penayangan dari itemuploaded
dalam feed subscription di halaman beranda./
– Penayangan lain yang berasal dari halaman beranda YouTube./my_subscriptions
– Penayangan yang berasal dari halaman Subscription saya pengguna di YouTube.
YT_CHANNEL
– Halaman channel tempat penonton menonton video.YT_OTHER_PAGE
– Halaman YouTube tempat penonton diarahkan ke video.YT_SEARCH
– Istilah penelusuran yang mengarahkan penonton ke video.VIDEO_REMIXES
– Video yang menghasilkan penayangan.
Contoh
Contoh permintaan berikut menggunakan dimensi sumber traffic:
Contoh channel
-
Sumber traffic
- Jumlah penayangan dan waktu tonton dari berbagai sumber traffic di suatu negara
- Jumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
- 10 Teratas – Istilah penelusuran YouTube yang menghasilkan traffic terbanyak untuk suatu video
- 10 Teratas – Istilah penelusuran Google yang menghasilkan traffic terbanyak untuk suatu video
- Jumlah penayangan dan waktu tonton playlist dari berbagai sumber traffic di suatu negara
- Jumlah penayangan playlist harian dan waktu tonton dari berbagai sumber traffic
-
Sumber traffic
Contoh pemilik konten
-
Sumber traffic
- Jumlah penayangan dan waktu tonton dari berbagai sumber traffic
- Jumlah penayangan harian dan waktu tonton dari berbagai sumber traffic
- 10 Teratas – Istilah penelusuran YouTube yang menghasilkan traffic terbanyak untuk suatu video
- 10 Teratas – Istilah penelusuran Google yang menghasilkan traffic terbanyak untuk suatu video
- Jumlah penayangan dan waktu tonton playlist dari berbagai sumber traffic di suatu negara
- Jumlah penayangan playlist harian dan waktu tonton dari berbagai sumber traffic
-
Sumber traffic
Perangkat
- deviceType
- Dimensi ini mengidentifikasi faktor bentuk fisik perangkat tempat penayangan terjadi.
Daftar berikut mengidentifikasi jenis perangkat yang datanya ditampilkan oleh API. Anda juga dapat menggunakan dimensi
deviceType
sebagai filter untuk membatasi laporan sistem operasi agar hanya berisi data untuk jenis perangkat tertentu.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- Dimensi ini mengidentifikasi sistem software dari perangkat yang menjadi media penayangan.
Daftar berikut mengidentifikasi sistem operasi yang datanya ditampilkan oleh API. Anda juga dapat menggunakan
operatingSystem
sebagai filter untuk membatasi laporan jenis perangkat agar hanya berisi data untuk sistem operasi tertentu.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
Contoh
Contoh permintaan berikut menggunakan dimensi perangkat:
Contoh channel
-
Perangkat/OS
- Metrik jenis perangkat harian untuk sistem operasi Android
- Metrik sistem operasi harian untuk perangkat seluler
- Metrik jenis perangkat dan sistem operasi harian
- Metrik jenis perangkat harian untuk penayangan playlist di sistem operasi Android
- Metrik sistem operasi harian untuk penayangan playlist di perangkat seluler
-
Perangkat/OS
Contoh pemilik konten
-
Perangkat/OS
- Metrik jenis perangkat harian untuk video yang diklaim
- Metrik sistem operasi harian untuk video yang diklaim yang ditonton di perangkat seluler
- Metrik jenis perangkat dan sistem operasi harian
- Metrik jenis perangkat harian untuk penayangan playlist di sistem operasi Android
- Metrik sistem operasi harian untuk penayangan playlist di perangkat seluler
-
Perangkat/OS
Demografi
Dimensi demografi membantu Anda memahami rentang usia dan distribusi gender audiens. Pusat Bantuan YouTube berisi informasi tambahan tentang data demografi di laporan YouTube Analytics.
- ageGroup (dimensi inti)
- Dimensi ini mengidentifikasi kelompok usia pengguna yang login yang terkait dengan data laporan. API ini menggunakan kelompok usia berikut:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (dimensi inti)
- Dimensi ini mengidentifikasi gender pengguna yang login yang dikaitkan dengan data laporan.
Nilai yang valid adalah
female
,male
, danuser_specified
. This is a core dimension and is subject to the Deprecation Policy.
Contoh
Contoh permintaan berikut menggunakan dimensi demografi:
Contoh channel
-
Demografi
- Demografi penonton di California (kelompok usia dan gender)
- Demografi penonton playlist di California (kelompok usia dan gender)
-
Demografi
Contoh pemilik konten
-
Demografi
- Demografi penonton di California (kelompok usia dan gender)
- Demografi penonton playlist di California (kelompok usia dan gender)
-
Demografi
Engagement dan berbagi konten
- sharingService (dimensi inti)
- Dimensi ini mengidentifikasi layanan yang digunakan untuk membagikan video. Video dapat dibagikan di YouTube (atau melalui pemutar YouTube) menggunakan tombol "Bagikan". This is a core dimension and is subject to the Deprecation Policy.
Tabel berikut mencantumkan nilai dimensi yang valid:
Layanan berbagi Nilai API Ameba AMEBA
Email Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Pengiriman pesan Android ANDROID_MMS
Messenger Blackberry BBM
Blogger BLOGGER
Salin ke Papan klip COPY_PASTE
Dunia maya CYWORLD
Digg DIGG
Dropbox DROPBOX
Embed EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Halaman Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Buka SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Pesan teks HTC HTC_MMS
Kotak Masuk Google INBOX
Dialog Aktivitas Sistem iOS IOS_SYSTEM_ACTIVITY_DIALOG
Cerita KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Lompat KIK
Email LGE LGE_EMAIL
Garis LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Perpesanan Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Berbagi Langsung NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Odnoklassniki) ODNOKLASSNIKI
Lainnya OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Gedung Pencakar Langit SKYBLOG
Percakapan Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Tidak diketahui UNKNOWN
Pesan Verizon VERIZON_MMS
Viber VIBER
VKontakte (влонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Jepang YAHOO
YouTube Gaming YOUTUBE_GAMING
Laporan Tren YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Lihat dokumen bantuan untuk informasi selengkapnya.
Contoh
Contoh permintaan berikut menggunakan dimensi sosial:
Contoh channel
- Media sosial: Metrik berbagi, yang digabungkan menurut layanan tempat video dibagikan
Contoh pemilik konten
- Media sosial: Metrik berbagi, yang digabungkan menurut layanan tempat video dibagikan
Retensi audiens
- elapsedVideoTimeRatio
- Dimensi ini menentukan rasio bagian video yang telah dilewati terhadap durasi video. Dimensi dan metrik retensi digunakan untuk mengukur retensi audiens dari waktu ke waktu, dan dimensi
elapsedVideoTimeRatio
adalah pengukuran waktu. Misalnya, nilai0.4
menunjukkan bahwa data laporan yang sesuai menunjukkan data retensi setelah 40 persen video telah berlalu.
API ini menampilkan 100 titik data untuk setiap video dengan nilai rasio yang berkisar dari0.01
hingga1.0
. Waktu saat data diukur selama pemutaran video memiliki spasi yang sama untuk setiap video. Artinya, untuk video berdurasi dua menit, interval antartitik data adalah 1,2 detik. Namun, untuk video berdurasi dua jam, interval antartitik data adalah 72 detik. Nilai dimensi menunjukkan akhir eksklusif interval. - audienceType (hanya filter)
- Nilai dimensi mengidentifikasi jenis traffic yang terkait dengan data laporan.
Nilai yang didukung adalah
ORGANIC
,AD_INSTREAM
, danAD_INDISPLAY
. Buka Pusat Bantuan YouTube untuk mengetahui penjelasan tentang jenis sumber traffic ini.
Perhatikan bahwa data untuk filteraudienceType
tersedia mulai 25 September 2013. API tidak menampilkan data untuk kueri yang menggunakan filter untuk mencoba mengambil data dari tanggal sebelumnya. Kueri yang tidak menggunakan filter akan berfungsi untuk tanggal apa pun setelah 1 Juli 2008.
Contoh
Contoh permintaan berikut menggunakan dimensi retensi audiens:
Contoh channel
- Retensi audiens: Metrik retensi audiens untuk video
Contoh pemilik konten
- Retensi audiens: Metrik retensi audiens untuk video
Performa iklan
- adType
- Dimensi
adType
digunakan dalam laporan performa iklan dan menggabungkan metrik yang diminta berdasarkan jenis iklan yang berjalan selama pemutaran video. Daftar berikut menjelaskan kemungkinan nilai dimensi. Lihat Pusat Bantuan YouTube untuk informasi selengkapnya tentang format iklan YouTube.
-
auctionBumperInstream
– Iklan video yang tidak dapat dilewati, yang ditempatkan melalui lelang, berdurasi maksimal 6 detik yang harus ditonton sebelum video dapat diputar. -
auctionDisplay
– Iklan multimedia atau gambar yang muncul sebagai overlay di bagian bawah pemutar video, sebagai unit iklan 300x250 di halaman tonton video, atau sebagai kombinasi dari keduanya. Ketika berjalan, overlay akan tertutup secara otomatis setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga bisa menutup overlay. Jika overlay dan banner ditampilkan secara bersamaan, masing-masing iklan dihitung sebagai tayangan terpisah. -
auctionInstream
– Iklan video yang tidak dapat dilewati yang berjalan sebelum, selama, atau setelah video utama. -
auctionTrueviewInslate
– Penonton memilih salah satu dari beberapa iklan video dari pilihan pilihan yang ditampilkan sebelum video. See the TrueView documentation for more information. -
auctionTrueviewInstream
– Iklan video yang dapat dilewati yang ditayangkan sebelum atau selama video utama. Lihat dokumentasi TrueView untuk informasi lebih lanjut. -
auctionUnknown
– Iklan yang dibeli melalui lelang AdWords, tetapi belum diklasifikasikan ke dalam salah satu jenis iklan lainnya. -
reservedBumperInstream
– Iklan video yang tidak dapat dilewati, yang dijual berdasarkan reservasi, berdurasi maksimal 6 detik dan harus ditonton sebelum video dapat diputar. -
reservedClickToPlay
– Iklan video yang harus diklik pengguna untuk memulai pemutaran. Tayangan iklan dicatat setiap kali unit iklan klik untuk putar ditampilkan, terlepas dari apakah pengguna memulai pemutaran atau tidak. Item ini dijual berdasarkan reservasi. -
reservedDisplay
– Iklan multimedia atau gambar yang muncul sebagai overlay di bagian bawah pemutar video, sebagai unit iklan 300x250 di halaman tonton video, atau sebagai kombinasi dari keduanya. Ketika berjalan, overlay akan tertutup secara otomatis setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga bisa menutup overlay. Jika overlay dan banner ditampilkan secara bersamaan, masing-masing iklan dihitung sebagai tayangan terpisah. -
reservedInstream
– Iklan video yang tidak dapat dilewati yang disisipkan sebelum, selama, atau setelah video utama. -
reservedInstreamSelect
-
reservedMasthead
– Iklan besar, yang dapat menyertakan elemen grafis dan video, yang muncul di halaman beranda. -
reservedUnknown
– Iklan yang dijual berdasarkan reservasi yang tidak dapat diklasifikasikan ke dalam salah satu jenis iklan lainnya. -
unknown
– Kami tidak dapat mengklasifikasikan jenis iklan ini.
-
Contoh
Contoh laporan berikut mengambil metrik pendapatan atau performa iklan:
Contoh channel
-
Pendapatan/Iklan
- Metrik pendapatan channel dan performa iklan
- Metrik pendapatan harian dan performa iklan
- Metrik pendapatan dan performa iklan spesifik per negara
- 10 Teratas – Video dengan pendapatan tertinggi
- Metrik performa iklan untuk berbagai jenis iklan
-
Pendapatan/Iklan
Contoh pemilik konten
-
Pendapatan/Iklan
- Metrik pendapatan dan performa iklan untuk konten yang diklaim
- Metrik pendapatan harian dan performa iklan
- Metrik pendapatan dan performa iklan spesifik per negara
- 10 Teratas – Video dengan pendapatan tertinggi
- Metrik performa iklan untuk berbagai jenis iklan
-
Pendapatan/Iklan
Playlist
- isCurated (hanya filter)
- Filter ini menunjukkan bahwa permintaan mengambil data tentang jumlah tontonan video yang terjadi dalam konteks playlist. Filter ini diperlukan untuk laporan playlist dan nilainya harus ditetapkan ke
1
.
Contoh
Semua contoh permintaan yang mengambil laporan playlist menggunakan filter isCurated
.
Dimensi pemilik konten
Dimensi berikut hanya didukung untuk laporan pemilik konten.
- ClaimsStatus (hanya digunakan dalam laporan pemilik konten)
- Dengan dimensi ini, Anda dapat menunjukkan bahwa respons API hanya boleh berisi metrik untuk konten yang diklaim. Satu-satunya nilai yang valid untuk dimensi ini adalah
claimed
. Jika parameterfilters
membatasi kueri untukclaimedStatus==claimed
, API hanya akan mengambil data untuk konten yang diklaim. Tabel dalam definisi dimensiuploaderType
memberikan detail selengkapnya tentang cara menggunakan dimensi ini.
- uploaderType (dimensi inti) (hanya digunakan dalam laporan pemilik konten)
- Dimensi ini memungkinkan Anda menunjukkan apakah respons API harus berisi metrik untuk konten yang diupload oleh pemilik konten tertentu dan/atau konten yang diupload oleh pihak ketiga, seperti video yang diupload pengguna. Nilai yang valid adalah
self
danthirdParty
. Ini adalah dimensi inti dan tunduk pada Kebijakan Penghentian Layanan.
Tabel di bawah menunjukkan kombinasi yang didukung untuk dimensiclaimedStatus
danuploaderType
, yang digunakan dalam parameterfilters
:
Nilai claimedStatus
Nilai uploaderType
Deskripsi [Belum ditetapkan] diri sendiri Mengambil data YouTube Analytics untuk konten yang diklaim dan tidak diklaim yang diupload oleh pemilik konten. diklaim [Belum ditetapkan] Mengambil data untuk konten yang diklaim yang diupload oleh pemilik konten atau pihak ketiga. diklaim diri sendiri Mengambil data untuk konten yang diklaim yang diupload oleh pemilik konten. diklaim thirdParty Mengambil data untuk konten yang diklaim yang diupload oleh pihak ketiga.
Contoh
Banyak contoh permintaan API untuk laporan pemilik konten menggunakan kombinasi dimensi claimedStatus
dan uploaderType
yang didukung untuk memfilter data.