Dimensions

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 resource video. 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 resource playlist.
channel (dimensi inti) (hanya digunakan dalam laporan pemilik konten)
ID untuk channel YouTube. Di YouTube Data API, ini adalah nilai properti id resource channel. This is a core dimension and is subject to the Deprecation Policy.

Dimensi channel 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 filter group, 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

  • 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

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), atau FR (Prancis). Kode negara ZZ 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) atau US-TX (Texas). Kode provinsi US-ZZ digunakan untuk melaporkan metrik yang mana YouTube tidak dapat mengidentifikasi negara bagian AS terkait. Jika permintaan API menyertakan province dalam nilai parameter dimensions, permintaan tersebut juga harus membatasi data ke Amerika Serikat dengan menyertakan country==US dalam nilai parameter filters.

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
Dimensi ini hanya dapat digunakan untuk memfilter data. Untuk menggunakan dimensi ini, tetapkan nilai parameter filters ke continent==REGION_CODE, dengan menentukan nilai REGION_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 ke subContinent==REGION_CODE, dengan menentukan nilai REGION_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 dimensi month, parameter start-date dan end-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

  • 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

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 pemutaran WATCH, EMBEDDED, atau EXTERNAL_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

  • 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

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 dan UNSUBSCRIBED.

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 nilai subscribedStatus sebesar SUBSCRIBED, dan satu penayangan memiliki nilai subscribedStatus sebesar UNSUBSCRIBED.
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, kolom insightTrafficSourceDetail 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, kolom insightTrafficSourceDetail 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, kolom insightTrafficSourceDetail 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, kolom insightTrafficSourceDetail 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, kolom insightTrafficSourceDetail 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, kolom insightTrafficSourceDetail akan mengidentifikasi halaman.
  • YT_SEARCH – Jumlah tontonan video dirujuk dari hasil penelusuran YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail akan menentukan istilah penelusuran.
  • VIDEO_REMIXES – Jumlah tontonan video dirujuk dari link video remix di pemutar Shorts. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail 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 item uploaded 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

  • 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

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

  • 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

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-
This is a core dimension and is subject to the Deprecation Policy.
gender (dimensi inti)
Dimensi ini mengidentifikasi gender pengguna yang login yang dikaitkan dengan data laporan. Nilai yang valid adalah female, male, dan user_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)

  • Contoh pemilik konten

    • Demografi
      • Demografi penonton di California (kelompok usia dan gender)
      • Demografi penonton playlist di California (kelompok usia dan gender)

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, nilai 0.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 dari 0.01 hingga 1.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, dan AD_INDISPLAY. Buka Pusat Bantuan YouTube untuk mengetahui penjelasan tentang jenis sumber traffic ini.

Perhatikan bahwa data untuk filter audienceType 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:

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

  • 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

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.

Penting: Permintaan API untuk mengambil laporan pemilik konten harus memfilter data menggunakan salah satu dimensi berikut:
  • video
  • channel
  • Kombinasi dimensi claimedStatus dan uploaderType yang didukung seperti yang dijelaskan di bawah.
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 parameter filters membatasi kueri untuk claimedStatus==claimed, API hanya akan mengambil data untuk konten yang diklaim. Tabel dalam definisi dimensi uploaderType 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 dan thirdParty. Ini adalah dimensi inti dan tunduk pada Kebijakan Penghentian Layanan.

Tabel di bawah menunjukkan kombinasi yang didukung untuk dimensi claimedStatus dan uploaderType, yang digunakan dalam parameter filters:

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.