Dokumen ini menentukan dimensi yang didukung YouTube Analytics API. API ini mendukung kueri real-time dan bertarget untuk menghasilkan 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 berdasarkan waktu, Anda memilih jangka waktu pelaporan data: hari atau bulan. Pada laporan mana pun, setiap baris data memiliki kombinasi nilai dimensi yang unik.
Untuk mengambil laporan kueri, panggil metode reports.query
YouTube Analytics API. Dalam permintaan, 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 Penggunaan yang ditetapkan dalam Persyaratan Layanan, dimensi non-inti (dan metrik non-inti) tidak tunduk pada kebijakan ini. Pada definisi di halaman ini, setiap dimensi yang merupakan dimensi inti diidentifikasi secara eksplisit.
Daftar berikut mengidentifikasi dimensi inti API.
Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk informasi selengkapnya.
Filter
Semua laporan kueri mendukung filter. Filter mengidentifikasi nilai dimensi yang harus ada dalam set data yang diambil. Dengan demikian, parameter tersebut membatasi respons API agar hanya menyertakan data yang cocok dengan nilai atau kumpulan nilai tertentu. Misalnya, daripada mengambil metrik aktivitas pengguna untuk semua negara, Anda dapat menggunakan filter untuk hanya mengambil data negara tertentu.
Dalam permintaan untuk mengambil laporan kueri, parameter permintaan filters
opsional menentukan nilai dimensi yang ingin Anda filter datanya. Misalnya, untuk mengambil metrik aktivitas pengguna untuk Eropa, Anda akan 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 dinyatakan lain, dimensi ini digunakan dalam laporan channel dan pemilik konten. Dimensi yang hanya dapat digunakan sebagai filter juga diidentifikasi.
Resource
Dimensi ini sesuai dengan resource yang dikelola oleh 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, tetapkan nilai parameter filters
ke daftar video, playlist, atau ID channel yang dipisahkan koma 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 di 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 berisi data untuk semua video, playlist, atau channel di grup tersebut.
Contoh
Contoh permintaan berikut menggunakan dimensi atau filter entitas pelaporan:
Contoh channel
-
Statistik dasar
- 10 Teratas – Video paling sering ditonton untuk channel
- 10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di channel
- Statistik untuk playlist tertentu
- 10 Teratas – Playlist yang paling banyak ditonton untuk channel
-
Geografis
- 10 Video Teratas – Paling banyak ditonton di negara tertentu
- 10 Video Teratas 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 Terpopuler – Playlist yang paling sering dimulai di Amerika Serikat
-
Statistik dasar
Area geografis
Dimensi ini mengidentifikasi wilayah geografis yang dikaitkan dengan aktivitas pengguna, performa iklan, atau metrik estimasi pendapatan.
- negara (dimensi inti)
- Negara yang terkait dengan metrik di baris laporan. Nilai dimensinya berupa kode negara dua huruf ISO-3166-1, seperti
US
,CN
(China), atauFR
(Prancis). Kode negaraZZ
digunakan untuk melaporkan metrik yang tidak dapat diidentifikasi oleh YouTube di negara terkait. This is a core dimension and is subject to the Deprecation Policy. - province
- Negara bagian atau wilayah AS yang terkait dengan metrik dalam 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 negara bagian AS terkait tidak dapat diidentifikasi oleh YouTube. 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 wilayah luar AS karena wilayah tersebut juga memiliki kode negara ISO 3166-1 sendiri. Kebijakan ini juga tidak mendukung subdivisi negara selain Amerika Serikat.
- kota
- Estimasi kota yang terkait dengan metrik di baris laporan. Data untuk dimensi ini tersedia untuk tanggal mulai 1 Januari 2022.
- benua (filter saja)
-
Kode wilayah statistik PBB (UN). 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. - subbenua (filter saja)
-
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 UN.
Contoh
Contoh permintaan berikut menggunakan dimensi atau filter geografis:
Contoh channel
- Statistik dasar: Jumlah penayangan khusus negara (dan lainnya) untuk sebuah channel
-
Geografis
- Metrik waktu tonton khusus negara untuk video channel
- Metrik anotasi khusus negara untuk video di channel
- Metrik khusus provinsi untuk negara bagian AS dan Washington D.C.
- Metrik waktu tonton khusus negara untuk playlist channel
- 10 Terpopuler – Playlist yang paling sering dimulai di Amerika Serikat
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- 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 Video Teratas – Paling banyak ditonton di negara tertentu
- 10 Video Teratas yang paling sering ditonton di Eropa
Contoh pemilik konten
- Statistik dasar: Jumlah penayangan khusus negara (dan lainnya) untuk semua video yang diupload sendiri
-
Geografis
- Metrik waktu tonton khusus 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 khusus negara untuk playlist pemilik konten
- 10 Terpopuler – Playlist yang paling sering dimulai di Amerika Serikat
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- Demografi: Demografi penonton di California (kelompok usia dan gender)
- Video teratas: 10 Video Teratas – Paling banyak ditonton di Eropa untuk pemilik konten
- Pendapatan/Performa iklan: Metrik pendapatan iklan dan pendapatan khusus negara
Jangka waktu
Dimensi ini menunjukkan bahwa laporan harus menggabungkan data berdasarkan jangka waktu, seperti hari, minggu, atau bulan. Parameter permintaan startDate
dan endDate
menentukan jangka waktu laporan menampilkan data. Perhatikan bahwa laporan sebenarnya menampilkan data hingga hari terakhir yang semua metriknya 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 pukul 00.00 waktu Pasifik (UTC-7 atau UTC-8) dan berakhir pukul 23.59 waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Hasilnya, tanggal saat jam disesuaikan maju untuk Waktu Musim Panas mewakili periode 23 jam, dan tanggal saat jam disesuaikan mundur mewakili periode 25 jam.
Dimensi bulan mengacu pada jangka waktu yang dimulai pukul 12.00 waktu Pasifik (UTC-7 atau UTC-8) pada hari pertama bulan dan tahun yang ditentukan.
- hari (dimensi inti)
- Saat Anda menggunakan dimensi ini, data dalam laporan digabungkan setiap hari dan setiap baris berisi data untuk satu hari. Anda dapat menggunakan dimensi lain untuk mengelompokkan data lebih jauh. 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 laporan harian, Anda dapat menggunakan filter lain untuk menyegmentasikan data lebih lanjut. Dalam 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 di channel
- Metrik anotasi harian untuk video di channel
- Jumlah penayangan playlist harian untuk sebuah channel
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- 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
- Jumlah penayangan playlist harian untuk pemilik konten
- Lokasi pemutaran: Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- 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 pendapatan 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 ini menjelaskan penayangan yang terjadi di halaman beranda atau layar utama YouTube, di feed subscription pengguna, atau di fitur penjelajahan YouTube lainnya. -
CHANNEL
– Data ini menjelaskan jumlah penayangan yang terjadi di halaman channel. -
EMBEDDED
– Data 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 ini menjelaskan penayangan yang terjadi di situs seluler YouTube atau di klien YouTube API yang disetujui, termasuk perangkat seluler.Mulai 10 September 2013, pemutaran tidak lagi dikategorikan sebagai pemutaran
MOBILE
dalam laporan YouTube Analytics. Nilai 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 terjadi. -
SEARCH
– Data ini menjelaskan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube. -
WATCH
– Data ini menjelaskan penayangan yang terjadi di halaman tonton video YouTube atau di aplikasi YouTube resmi, seperti aplikasi YouTube untuk Android. -
YT_OTHER
– Data ini menjelaskan tampilan yang tidak diklasifikasikan.
-
- insightPlaybackLocationDetail
- Data digabungkan berdasarkan halaman tempat pemutar berada. Perhatikan bahwa laporan ini hanya didukung untuk penayangan yang terjadi di pemutar tersemat, dan mengidentifikasi pemutar tersemat yang menghasilkan penayangan terbanyak untuk video tertentu. Dengan demikian, laporan ini memberikan tampilan yang lebih mendetail daripada laporan lokasi pemutaran dengan mengidentifikasi URL atau aplikasi yang terkait dengan pemutar tersemat teratas.
Contoh
Contoh permintaan berikut menggunakan dimensi lokasi pemutaran:
Contoh channel
-
Lokasi pemutaran
- Jumlah penayangan dan waktu tonton dari lokasi pemutaran yang berbeda
- Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- 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 lokasi pemutaran yang berbeda
- Jumlah penayangan harian dan waktu tonton dari lokasi pemutaran yang berbeda
- 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 di 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 Shorts. STORY
Konten yang dilihat adalah Cerita YouTube. VIDEO_ON_DEMAND
Konten yang ditonton adalah video YouTube yang tidak tercakup dalam salah satu nilai dimensi lainnya. UNSPECIFIED
Jenis konten dari konten yang dilihat tidak diketahui. - liveOrOnDemand
- Dimensi ini menunjukkan apakah metrik aktivitas pengguna di baris data dikaitkan 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 live streaming. ON_DEMAND
Data baris menjelaskan aktivitas pengguna yang tidak terjadi selama live streaming. - langganandStatus
- Dimensi ini menunjukkan apakah metrik aktivitas pengguna di baris data dikaitkan dengan penonton yang subscribe ke channel video atau playlist.
Nilai yang mungkin adalah
SUBSCRIBED
danUNSUBSCRIBED
.
Perhatikan bahwa nilai dimensi akurat pada saat aktivitas pengguna terjadi. Misalnya, pengguna belum subscribe ke channel dan menonton salah satu video di channel tersebut, lalu subscribe ke channel tersebut dan menonton video lainnya di hari yang sama. Laporan saluran menunjukkan bahwa satu tampilan memiliki nilaisubscribedStatus
sebesarSUBSCRIBED
, dan satu tampilan memiliki nilaisubscribedStatus
sebesarUNSUBSCRIBED
. - youtubeProduct
- Dimensi ini mengidentifikasi layanan YouTube tempat aktivitas pengguna terjadi. 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 akan disertakan dalam 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 dalam 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 memungkinkan untuk dimensi ini adalah:
ADVERTISING
– Penonton diarahkan ke video oleh iklan. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan mengidentifikasi jenis iklan tersebut.ANNOTATION
– Penonton membuka video dengan mengklik anotasi di video lain.CAMPAIGN_CARD
– Penayangan berasal dari video yang diklaim dan diupload pengguna yang digunakan pemilik konten untuk mempromosikan konten yang ditonton. Sumber traffic ini hanya didukung untuk laporan pemilik konten.END_SCREEN
– Penayangan dirujuk dari layar akhir video lain.EXT_URL
– Penayangan 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 berasal dari halaman hashtag VOD atau halaman pivot hashtag Shorts.LIVE_REDIRECT
- Penayangan 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
– Penayangan video terjadi saat video diputar sebagai bagian dari playlist. Perhatikan bahwa sumber traffic ini berbeda denganYT_PLAYLIST_PAGE
, yang menunjukkan bahwa penayangan berasal dari halaman yang mencantumkan semua video dalam playlist.PRODUCT_PAGE
- Jumlah tontonan video dirujuk dari halaman Produk.PROMOTED
– Penayangan 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 dirujuk dengan menggeser secara vertikal dari video sebelumnya dalam pengalaman menonton video Shorts.SOUND_PAGE
– Penayangan berasal dari halaman pivot suara Shorts.SUBSCRIBER
– Penayangan video dirujuk dari feed di halaman beranda YouTube atau dari fitur subscription YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan item feed halaman beranda atau halaman lain dari mana tampilan dirujuk.YT_CHANNEL
– Penayangan video terjadi di halaman channel. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan ID saluran untuk saluran tersebut.YT_OTHER_PAGE
– Penayangan 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_PLAYLIST_PAGE
– Penayangan video berasal dari halaman yang mencantumkan semua video dalam playlist. Perhatikan bahwa sumber traffic ini berbeda denganPLAYLIST
, yang menunjukkan bahwa penayangan terjadi saat video diputar sebagai bagian dari playlist.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 yang di-remix dalam pemutar Shorts. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan video yang mengarahkan penonton.
- 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 menyediakan laporan ini. Untuk setiap sumber traffic, daftar mengidentifikasi informasi yang diberikan dimensi
insightTrafficSourceDetail
.ADVERTISING
– Jenis iklan yang menghasilkan penayangan. Nilainya dapat berupa:- Iklan engagement klik untuk putar
- Iklan engagement
- Iklan penelusuran Google
- Iklan video beranda
- In-stream yang dicadangkan dan dapat dilewati
- TrueView dalam-penelusuran dan dalam-tampilan
- TrueView in-stream
- Iklan YouTube yang tidak dikategorikan
- Dinding video
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.HASHTAGS
– Hashtag yang menghasilkan penayangan.NOTIFICATION
– Email atau notifikasi yang mengarahkan traffic.RELATED_VIDEO
– Video terkait yang mengarahkan penonton ke video yang dibahas dalam laporan.SOUND_PAGE
– Video yang menghasilkan penayangan.SUBSCRIBER
– Elemen feed halaman beranda atau fitur subscription YouTube yang mengarahkan penonton ke video yang dibahas dalam laporan. Nilai yang valid adalah:activity
– Penayangan dari item di feed subscription halaman beranda yang dihasilkan dari aktivitas channel selain upload dan media sosial, termasuk kesukaan, favorit, postingan buletin, dan penambahan playlist.blogged
– Penayangan dari item di feed subscription halaman beranda yang berasal dari link dari blog teratas.mychannel
– Penayangan dari item di 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
di feed langganan halaman beranda./
– Penayangan lain yang berasal dari halaman beranda YouTube./my_subscriptions
– Penayangan yang berasal dari halaman Langganan saya milik pengguna di YouTube.
YT_CHANNEL
– Halaman channel tempat penonton menonton video.YT_OTHER_PAGE
– Halaman YouTube tempat penonton dirujuk 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 video
- 10 Teratas – Istilah penelusuran Google yang menghasilkan traffic terbanyak untuk 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 video
- 10 Teratas – Istilah penelusuran Google yang menghasilkan traffic terbanyak untuk 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 tampilan 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
- Sistem Operasi
- Dimensi ini mengidentifikasi sistem software perangkat tempat tampilan terjadi.
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 demografis membantu Anda memahami rentang usia dan distribusi gender audiens Anda. Pusat Bantuan YouTube berisi informasi tambahan tentang data demografis dalam 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 terkait 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
Interaksi 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
Fitur pesan Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Salin ke Papan klip COPY_PASTE
Musik Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Disematkan EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Halaman Facebook FACEBOOK_PAGES
Musik Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Kirim SMS GO_SMS
GrupSaya GROUPME
Hangouts HANGOUTS
hi5 HI5
Pesan teks HTC HTC_MMS
Kotak Masuk Google INBOX
Dialog Aktivitas Sistem iOS IOS_SYSTEM_ACTIVITY_DIALOG
Story KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Email LGE LGE_EMAIL
Garis LINE
LinkedIn LINKEDIN
Jurnal Live LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Pengiriman Pesan Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Berbagi Langsung NEARBY_SHARE
Ujian NUJIJ
Odnoklassniki (čдноклассники) ODNOKLASSNIKI
Lainnya OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Musik Skysky SKYBLOG
Percakapan Sony SONY_CONVERSATIONS
Musik StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tutu TUENTI
tumblr. TUMBLR
Twitter TWITTER
Tidak dikenal 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
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Lihat dokumen bantuan untuk mengetahui informasi selengkapnya.
Contoh
Contoh permintaan berikut menggunakan dimensi sosial:
Contoh channel
- Sosial: Metrik berbagi, yang digabungkan menurut layanan tempat video dibagikan
Contoh pemilik konten
- Sosial: Metrik berbagi, yang digabungkan menurut layanan tempat video dibagikan
Retensi audiens
- elapsedVideoTimeRatio
- Dimensi ini menentukan rasio bagian video yang berlalu 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 berlalu.
API menampilkan 100 titik data untuk setiap video dengan nilai rasio yang berkisar dari0.01
sampai1.0
. Waktu saat data diukur selama pemutaran video memiliki jarak yang sama untuk setiap video. Artinya, untuk video berdurasi dua menit, interval antar titik data adalah 1,2 detik. Namun, untuk video dua jam, interval antar titik data adalah 72 detik. Nilai dimensi menunjukkan akhir eksklusif interval. - audienceType (filter only)
- Nilai dimensi mengidentifikasi jenis traffic yang terkait dengan data laporan.
Nilai yang didukung adalah
ORGANIC
,AD_INSTREAM
, danAD_INDISPLAY
. Baca Pusat Bantuan YouTube untuk mendapatkan 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 guna 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 penonton: Metrik retensi penonton untuk video
Contoh pemilik konten
- Retensi penonton: Metrik retensi penonton untuk video
Performa iklan
- Jenisiklan
- Dimensi
adType
digunakan dalam laporan performa iklan dan menggabungkan metrik yang diminta berdasarkan jenis iklan yang dijalankan selama pemutaran video. Daftar berikut menjelaskan kemungkinan nilai dimensi. Buka Pusat Bantuan YouTube untuk mengetahui 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 ditonton. -
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 keduanya. Saat overlay berjalan, overlay akan otomatis ditutup setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga dapat menutup overlay. Jika overlay dan banner ditampilkan secara bersamaan, setiap 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 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 selengkapnya. -
auctionUnknown
– Iklan yang dibeli melalui lelang AdWords, tetapi belum diklasifikasikan ke dalam salah satu jenis iklan lainnya. -
reservedBumperInstream
– Iklan video yang tidak dapat dilewati, dijual berdasarkan pesanan, berdurasi hingga 6 detik yang harus ditonton sebelum video dapat ditonton. -
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. Iklan ini dijual berdasarkan pesanan. -
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 keduanya. Saat overlay berjalan, overlay akan otomatis ditutup setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga dapat menutup overlay. Jika overlay dan banner ditampilkan secara bersamaan, setiap 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 mencakup elemen grafis dan video yang muncul di halaman beranda. -
reservedUnknown
– Iklan yang dijual berdasarkan pesanan 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 performa iklan atau pendapatan:
Contoh channel
-
Pendapatan/Iklan
- Metrik pendapatan iklan dan pendapatan channel
- Metrik pendapatan iklan dan pendapatan harian
- Metrik performa iklan dan pendapatan khusus 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 iklan dan pendapatan harian
- Metrik performa iklan dan pendapatan khusus negara
- 10 Teratas – Video dengan pendapatan tertinggi
- Metrik performa iklan untuk berbagai jenis iklan
-
Pendapatan/Iklan
Playlist
- isCurated (filter saja)
- 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 permintaan sampel yang mengambil laporan playlist menggunakan filter isCurated
.
Dimensi pemilik konten
Dimensi berikut hanya didukung untuk laporan pemilik konten.
- diklaimStatus (hanya digunakan di laporan pemilik konten)
- Dimensi ini memungkinkan Anda 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 keclaimedStatus==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 yang ditentukan 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 keduanya 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 oleh pihak ketiga. diklaim diri sendiri Mengambil data untuk konten yang diklaim yang diupload oleh pemilik konten. diklaim Pihak Ketiga 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.