Dimensions

Dokumen ini menentukan dimensi yang didukung oleh 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 untuk data yang akan dilaporkan: hari atau bulan. Dalam 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 didefinisikan dalam Persyaratan Layanan, dimensi non-inti (dan metrik non-inti) tidak tunduk pada kebijakan. Dalam definisi di halaman ini, setiap dimensi yang merupakan dimensi inti secara eksplisit teridentifikasi seperti itu.

Daftar berikut ini mengidentifikasi dimensi inti API.

Lihat daftar YouTube API yang tunduk pada Kebijakan Penghentian Layanan untuk mengetahui informasi selengkapnya.

Filter

Semua laporan kueri mendukung filter. Filter mengidentifikasi nilai dimensi yang harus ada dalam set data yang diambil. Dengan demikian, parameter ini membatasi respons API agar hanya menyertakan data yang cocok dengan nilai atau kumpulan nilai tertentu. Misalnya, sebagai ganti 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 untuk 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.

Resource

Dimensi ini sesuai dengan aset 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, setel nilai parameter filters ke daftar ID video, playlist, atau 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 video properti id resource. 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 di 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 banyak ditonton untuk suatu channel
      • 10 Teratas – Rasio klik-tayang anotasi untuk video yang paling banyak ditonton di saluran
      • Statistik untuk playlist tertentu
      • 10 Teratas – Playlist yang paling sering ditonton untuk sebuah channel
    • Geografis
      • 10 Teratas – Video yang paling sering ditonton di negara tertentu
      • 10 Teratas – Video yang paling banyak 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 saluran
      • 10 Teratas – Playlist yang paling sering ditonton untuk pemilik konten
    • Geografis
      • 10 Teratas - Video yang paling sering ditonton di Eropa untuk pemilik konten
      • 10 Teratas – Playlist yang paling sering dimulai di Amerika Serikat

Area geografis

Dimensi ini mengidentifikasi wilayah geografis yang terkait dengan metrik aktivitas pengguna, performa iklan, atau estimasi pendapatan.

country (dimensi inti)
Negara yang terkait dengan metrik dalam baris laporan. Nilai dimensi adalah kode negara ISO-3166-1 dua huruf, seperti US, CN (China), atau FR (Prancis). Kode negara ZZ digunakan untuk melaporkan metrik yang negaranya 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 dalam 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 tidak dapat diidentifikasi oleh YouTube di negara bagian AS yang 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-nya sendiri. Sistem ini juga tidak mendukung subdivisi negara selain Amerika Serikat.

dma
ID 3 digit yang digunakan Nielsen untuk mengidentifikasi Designated Market Area (DMA) yang terkait dengan peristiwa penayangan yang dijelaskan di baris data.
kota
Estimasi kota yang terkait dengan metrik di 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, yang menentukan nilai REGION_CODE dari tabel.
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, yang menentukan nilai REGION_CODE dari daftar UN.

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 banyak 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 spesifik per 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 banyak ditonton di Eropa untuk pemilik konten
    • Pendapatan/Performa iklan: Metrik performa iklan dan pendapatan spesifik per negara

Jangka waktu

Dimensi tersebut menunjukkan bahwa laporan harus menggabungkan data berdasarkan jangka waktu, seperti hari, minggu, atau bulan. Parameter permintaan startDate dan endDate menentukan jangka waktu saat laporan menyertakan data. Perhatikan bahwa laporan sebenarnya menampilkan data hingga hari terakhir semua metrik yang ditentukan dalam permintaan tersedia pada saat kueri dibuat. Dalam laporan, tanggal dicantumkan 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 ke depan untuk Waktu Musim Panas mewakili periode 23 jam, dan tanggal saat jam disesuaikan mundur mewakili periode 25 jam.

Dimensi bulan mengacu pada periode 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)
Saat Anda menggunakan dimensi ini, data dalam laporan digabungkan setiap hari dan setiap baris berisi data selama satu hari. Anda dapat menggunakan dimensi lain untuk mengelompokkan 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 berdasarkan bulan kalender. Seperti laporan harian, Anda dapat menggunakan filter lain untuk mengelompokkan data lebih lanjut. Di laporan, tanggal dicantumkan 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 filter atau dimensi sementara:

  • Contoh channel

    • Berbasis waktu
      • Metrik waktu tonton harian untuk video channel
      • Metrik anotasi harian untuk video channel
      • Penayangan playlist harian untuk sebuah 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 dan 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. Kemungkinan nilai 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 menjelaskan 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 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 pada klien YouTube API yang disetujui, termasuk perangkat seluler.

    Mulai 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 terjadi.

  • SEARCH – Data 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 menjelaskan tampilan yang tidak diklasifikasikan.

insightPlaybackLocationDetail
Data digabungkan berdasarkan halaman tempat pemutar berada. Perhatikan bahwa laporan ini hanya didukung untuk penayangan yang terjadi pada pemutar tersemat, dan mengidentifikasi pemutar tersemat yang menghasilkan penayangan terbanyak untuk video tertentu. Oleh karena itu, laporan ini 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 playlist dan waktu tonton 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 playlist dan waktu tonton 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 di baris data. Data untuk dimensi ini tersedia untuk tanggal yang dimulai pada 1 Januari 2019.

Tabel berikut mencantumkan nilai dimensi:
Nilai
LIVE_STREAM Konten yang ditonton adalah livestream YouTube.
SHORTS Konten yang ditonton adalah YouTube Short.
STORY Konten yang ditonton adalah Story YouTube.
VIDEO_ON_DEMAND Konten yang ditonton adalah video YouTube yang tidak termasuk dalam salah satu nilai dimensi lain.
UNSPECIFIED Jenis konten 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.
subscribedStatus
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 dan UNSUBSCRIBED.

Perhatikan bahwa nilai dimensi akan akurat pada saat aktivitas pengguna terjadi. Misalnya, seorang pengguna belum subscribe ke channel dan menonton salah satu video dari channel tersebut, lalu subscribe ke channel tersebut dan menonton video lain, semuanya pada hari yang sama. Laporan saluran menunjukkan bahwa satu penayangan memiliki nilai subscribedStatus SUBSCRIBED, dan satu penayangan memiliki nilai subscribedStatus 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 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 mengakses video. Kemungkinan nilai untuk dimensi ini adalah:
  • ADVERTISING – Penonton diarahkan ke video oleh iklan. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail akan mengidentifikasi jenis iklan.
  • ANNOTATION – Penonton menjangkau 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 – 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 Google Penelusuran.
  • HASHTAGS – Penayangan 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 pada aplikasi seluler.
  • NOTIFICATION – Jumlah tontonan video dirujuk dari email atau notifikasi dari YouTube.
  • PLAYLIST – Penayangan 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 berasal dari promosi YouTube tidak berbayar, seperti "Video Sorotan" YouTube kami.
  • 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 dirujuk 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 langganan YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail akan menentukan elemen feed halaman beranda atau halaman lain tempat tampilan dirujuk.
  • YT_CHANNEL – Jumlah tontonan video terjadi di halaman channel. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail 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 yang dirujuk oleh 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 tempat laporan ini tersedia. Untuk setiap sumber traffic, daftar mengidentifikasi informasi yang diberikan dimensi insightTrafficSourceDetail.
  • ADVERTISING – Jenis iklan yang menghasilkan penayangan. Nilai yang dimasukkan 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 dan mengarahkan penonton ke video yang diidentifikasi dalam laporan.
  • END_SCREEN – Video yang mengarahkan penonton ke video yang diidentifikasi dalam laporan.
  • EXT_URL – Situs yang merujuk penonton ke video.
  • HASHTAGS – Hashtag yang menghasilkan penayangan.
  • NOTIFICATION – Email atau notifikasi yang merujuk traffic.
  • RELATED_VIDEO – Video terkait yang mengarahkan penonton ke video yang dicakup dalam laporan.
  • SOUND_PAGE – Video yang menghasilkan penayangan.
  • SUBSCRIBER – Item feed halaman beranda atau fitur subscription YouTube yang mengarahkan penonton ke video yang dibahas dalam laporan. Nilai yang valid adalah:
    • activity – Penayangan dari item dalam feed subscription beranda yang berasal dari aktivitas channel selain upload dan non-sosial, termasuk suka, favorit, postingan buletin, dan penambahan playlist.
    • blogged – Penayangan dari item dalam 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 uploaded item dalam feed subscription di halaman beranda.
    • / – Penayangan lain yang berasal dari halaman beranda YouTube.
    • /my_subscriptions – Penayangan yang berasal dari Halaman Subscription saya 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 di Google yang menghasilkan traffic terbanyak untuk video
      • Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di satu 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 video
      • 10 Teratas – Istilah penelusuran di Google yang menghasilkan traffic terbanyak untuk video
      • Jumlah penayangan playlist dan waktu tonton dari berbagai sumber traffic di satu negara
      • Jumlah penayangan playlist harian dan waktu tonton dari berbagai sumber traffic

Perangkat

deviceType
Dimensi ini mengidentifikasi faktor bentuk fisik perangkat tempat tampilan muncul. 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 tempat penayangan 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

  • Contoh pemilik konten

    • Perangkat/OS
      • Metrik jenis perangkat harian untuk video yang diklaim
      • Metrik sistem operasi harian untuk video yang diklaim dan 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 demografis 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 terkait 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 demografis:

  • 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)

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" tombol.
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
Messenger Android ANDROID_MESSENGER
Fitur pesan Android ANDROID_MMS
Messenger Blackberry BBM
Blogger BLOGGER
Salin ke Papan Klip COPY_PASTE
Dunia siber 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
Kirim 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
Kisah KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Email LGE LGE_EMAIL
Garis LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola Messaging 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
Skyrock SKYBLOG
Percakapan Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
{i>tumblr <i}(tumblr). TUMBLR
Twitter TWITTER
Tidak diketahui UNKNOWN
Pesan Verizon VERIZON_MMS
Viber VIBER
VKontakte (machine drive mas 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: Berbagi metrik, digabungkan menurut layanan tempat video dibagikan

  • Contoh pemilik konten

    • Sosial: Berbagi metrik, digabungkan menurut layanan tempat video dibagikan

Retensi penonton

elapsedVideoTimeRatio
Dimensi ini menentukan rasio bagian video yang telah dilewati dengan 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 menampilkan data retensi setelah 40 persen durasi video berlalu.

API ini menampilkan 100 titik data untuk setiap video dengan nilai rasio yang berkisar dari 0.01 hingga 1.0. Waktu pengukuran data selama pemutaran video memiliki jarak yang sama untuk setiap video. Ini berarti bahwa 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 (hanya filter)
Nilai dimensi mengidentifikasi jenis traffic yang terkait dengan data laporan. Nilai yang didukung adalah ORGANIC, AD_INSTREAM, dan AD_INDISPLAY. Lihat Pusat Bantuan YouTube untuk mendapatkan penjelasan tentang jenis sumber traffic ini.

Perhatikan bahwa data untuk filter audienceType tersedia sejak 25 September 2013. API tidak menampilkan data untuk kueri yang menggunakan filter untuk mencoba mengambil data dari tanggal sebelumnya. Kueri yang tidak menggunakan filter berfungsi untuk tanggal berapa pun setelah 1 Juli 2008.

Contoh

Contoh permintaan berikut menggunakan dimensi retensi audiens:

Live streaming

livestreamPosition
Dimensi ini menentukan menit tertentu selama streaming video live. Metrik laporan menunjukkan jumlah pengguna yang menonton livestream pada saat itu.

Pembatalan langganan

membershipsCancellationSurveyReason
Jumlah survei yang diselesaikan oleh pengguna YouTube yang membatalkan langganan channel mereka selama saluran tertentu selama periode pelaporan. Tabel berikut mencantumkan nilai dimensi yang valid:
Nilai API Penjelasan
UNKNOWN Pengguna tidak menyelesaikan survei.
DISLIKE_PERKS Pengguna tidak menyukai keuntungan langganan.
PERKS_NOT_DELIVERED Pengguna tersebut mengatakan bahwa keuntungan langganan yang dijanjikan tidak diberikan.
CANNOT_ACCESS_PERKS Pengguna tidak dapat mengakses keuntungan.
NO_LONGER_INTERESTED Pengguna tidak lagi tertarik dengan langganan channel.
FEEL_UNAPPRECIATED Pengguna merasa tidak diapresiasi sebagai pelanggan channel.
FINANCIAL_REASONS Pengguna membatalkan karena alasan keuangan.
JOIN_LIMITED_TIME Pengguna hanya ingin bergabung untuk waktu yang terbatas.
OTHER Pengguna memiliki alasan lain untuk pembatalan.

Kinerja 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. Baca Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut mengenai format iklan YouTube.

  • auctionBumperInstream – Iklan video yang tidak dapat dilewati, ditempatkan melalui lelang, berdurasi hingga 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 keduanya. Saat berjalan, overlay akan otomatis ditutup setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga dapat menutup overlay. Jika overlay dan banner ditampilkan bersamaan, setiap iklan dihitung sebagai tayangan terpisah.

  • auctionInstream – Iklan video yang tidak dapat dilewati yang ditampilkan sebelum, selama, atau setelah video utama.

  • auctionTrueviewInslate – Penonton dapat 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 sesuai pesanan, berdurasi hingga 6 detik yang 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. Keduanya 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 keduanya. Saat berjalan, overlay akan otomatis ditutup setelah ditampilkan selama jangka waktu tertentu, dan pengguna juga dapat menutup overlay. Jika overlay dan banner ditampilkan 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 menyertakan elemen video dan grafis, yang muncul di halaman beranda.

  • reservedUnknown – Iklan yang dijual sesuai pesanan yang tidak dapat diklasifikasikan ke dalam salah satu jenis iklan lainnya.

  • unknown – YouTube 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 di konteks playlist.

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 ditentukan di bawah.
ClaimsStatus (hanya digunakan dalam 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 parameter filters membatasi kueri ke claimedStatus==claimed, API hanya akan mengambil data untuk konten yang diklaim. Tabel dalam definisi dimensi uploaderType memberikan detail lebih lanjut 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 kepada Kebijakan Penghentian Layanan.

Tabel di bawah menunjukkan kombinasi yang didukung untuk dimensi claimedStatus dan uploaderType, yang keduanya 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 oleh 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.