YouTube Analytics API: Channel Reports

Dimensi 7DayTotals dan 30DayTotals tidak digunakan lagi. Lihat Histori Revisi untuk mengetahui informasi selengkapnya.

Halaman ini mencantumkan laporan yang dapat diambil pemilik channel dengan YouTube Analytics API. Laporan saluran memberikan metrik aktivitas pengguna untuk saluran tertentu dan mengukur berbagai hal seperti jumlah tontonan video, peringkat, dan langganan.

  • Laporan video memberikan statistik untuk semua aktivitas pengguna yang terkait dengan video di channel.
  • Laporan playlist memberikan statistik yang secara khusus terkait dengan penayangan video yang terjadi dalam konteks playlist.
  • Laporan performa iklan berisi metrik yang terkait dengan pendapatan dan performa iklan. Metrik ini menggunakan dimensi adType untuk mengelompokkan metrik berdasarkan jenis iklan yang berjalan selama pemutaran video. Bagian laporan performa iklan menjelaskan dua jenis metrik performa iklan yang didukung API.

Mengambil laporan

Untuk mengambil laporan saluran, Anda harus menetapkan nilai parameter ids dalam permintaan API ke salah satu nilai berikut:

  • channel==MINE – API menampilkan data untuk channel YouTube pengguna yang diautentikasi.

  • channel==CHANNEL_ID – Tetapkan CHANNEL_ID ke ID saluran unik pada saluran yang datanya Anda ambil. Pengguna yang mengizinkan permintaan harus merupakan pemilik channel.

    ID saluran saat ini adalah string yang dimulai dengan huruf UC, meskipun formatnya dapat berubah. (Anda dapat menemukan ID channel di halaman setelan akun lanjutan untuk channel YouTube, atau mengambil ID channel secara terprogram menggunakan metode YouTube Data API's channels.list.)

Otorisasi

Semua permintaan YouTube Analytics API harus diizinkan. Panduan otorisasi menjelaskan cara menggunakan protokol OAuth 2.0 untuk mengambil token otorisasi.

Permintaan YouTube Analytics API menggunakan cakupan otorisasi berikut:

Cakupan
https://www.googleapis.com/auth/yt-analytics.readonly Lihat laporan YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna, seperti jumlah penayangan dan jumlah rating.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Lihat laporan moneter YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna dan estimasi pendapatan serta metrik performa iklan.
https://www.googleapis.com/auth/youtube Mengelola akun YouTube Anda. Di YouTube Analytics API, pemilik channel menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Melihat dan mengelola aset YouTube dan konten terkait di YouTube. Di YouTube Analytics API, pemilik konten menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics.

Catatan: Metrik estimasi pendapatan dan performa iklan saat ini tidak didukung untuk laporan saluran. Akibatnya, cakupan https://www.googleapis.com/auth/yt-analytics-monetary.readonly saat ini tidak memberikan akses ke data moneter dalam laporan tersebut.

Filter

Tabel yang menjelaskan laporan yang didukung mengidentifikasi filter yang dapat digunakan untuk setiap laporan. Dalam tabel, filter yang ditampilkan dalam tanda kurung bersifat opsional. Misalnya, untuk opsi pemfilteran video(,country), filter video diperlukan, dan filter negara bersifat opsional.

API juga mendukung kemampuan untuk menentukan beberapa nilai untuk filter video dan playlist. Jika menentukan beberapa nilai untuk salah satu filter ini, Anda juga dapat menambahkan filter tersebut ke daftar dimensi yang ditentukan untuk permintaan. Hal ini berlaku meskipun filter tidak tercantum sebagai dimensi yang didukung untuk laporan tertentu.

Lihat definisi parameter filters untuk mendapatkan penjelasan lengkap tentang cara memfilter hasil API untuk nilai atau kumpulan nilai tertentu.

Memahami tabel laporan

Bagian ini menjelaskan pemformatan dan terminologi yang digunakan dalam tabel yang menentukan laporan yang didukung API. Tabel di bawah mencantumkan dimensi, metrik, dan filter yang didukung untuk laporan playlist channel berbasis waktu:

Daftar Isi
Dimensi:
Gunakan persis 1 day, month
Gunakan 0 atau lebih subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Tabel berisi dua baris untuk dimensi, satu baris untuk metrik, dan empat baris untuk filter. Untuk dimensi dan filter, nilai dari setiap baris dapat digabungkan dalam permintaan API selama kombinasi mengikuti aturan penggunaan dalam tabel. Jadi, misalnya, nilai parameter dimensions yang valid untuk laporan ini mencakup:

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Namun, nilai parameter day,month tidak valid karena menggunakan dua dimensi berbasis waktu, tetapi permintaan harus menggunakan tepat 1. Dalam hal ini, nilai parameter subscribedStatus,youtubeProduct benar-benar menampilkan laporan, tetapi metrik tidak digabungkan menurut hari, minggu, bulan, dll. (Laporan tersebut didokumentasikan secara terpisah dalam dokumentasi.)

Terminologi tabel laporan

Tabel menggunakan terminologi berikut untuk menunjukkan apakah dimensi diperlukan atau opsional:

  • Istilah ini berarti bahwa nilai diperlukan:
    • Wajib: Anda harus menyertakan nilai.
    • Gunakan tepat 1: Anda harus menyertakan satu nilai dari grup.
    • Gunakan 1 atau beberapa: Anda dapat menyertakan satu atau semua nilai dari grup, tetapi Anda harus menyertakan setidaknya satu nilai.
  • Persyaratan ini berarti bahwa nilai bersifat opsional:
    • Opsional: Anda memiliki opsi untuk menyertakan nilai tersebut.
    • Gunakan 0 atau 1: Anda memiliki opsi untuk menyertakan satu nilai dari grup.
    • Gunakan 0 atau lebih: Anda memiliki opsi untuk menyertakan salah satu atau semua nilai dari grup.

Laporan video

Statistik dasar

Statistik aktivitas pengguna dasar

Laporan ini berisi statistik terkait tindakan pengguna pada saluran. Anda dapat memfilter laporan agar hanya menampilkan data untuk video atau negara tertentu.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih .
Filter:
Gunakan 0 atau 1 country, benua, subbenua
Gunakan 0 atau 1 video, grup

Statistik aktivitas pengguna dasar untuk negara bagian AS

Laporan ini berisi statistik untuk negara bagian AS atau District of Columbia tertentu. Perhatikan bahwa laporan ini hanya mendukung subkumpulan metrik yang tersedia di laporan khusus negara yang dijelaskan di atas.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Wajib province
Gunakan 0 atau 1 video, grup

Berbasis waktu

Aktivitas pengguna menurut negara untuk jangka waktu tertentu

Laporan ini berisi statistik yang terkait dengan tindakan pengguna pada saluran untuk interval waktu tertentu. Anda dapat memfilter laporan agar hanya menampilkan data untuk video atau negara tertentu.

Daftar Isi
Dimensi:
Gunakan persis 1 day, month
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih .
Filter:
Gunakan 0 atau 1 country, benua, subbenua
Gunakan 0 atau 1 video, grup

Aktivitas pengguna di negara bagian AS untuk jangka waktu tertentu

Laporan ini berisi statistik yang terkait dengan aktivitas pengguna untuk negara bagian AS tertentu atau District of Columbia. Perhatikan bahwa laporan ini hanya mendukung subkumpulan metrik yang tersedia di laporan khusus negara yang dijelaskan di atas.

Daftar Isi
Dimensi:
Gunakan persis 1 day, month
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Wajib province
Gunakan 0 atau 1 video, grup

Geografi pengguna

Aktivitas pengguna menurut negara

Laporan ini berisi statistik yang terkait dengan aktivitas pengguna berdasarkan setiap negara untuk saluran. Anda dapat memfilter laporan agar hanya menampilkan data untuk video tertentu.

Daftar Isi
Dimensi:
Wajib country
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih .
Filter:
Gunakan 0 atau 1 benua, subbenua
Gunakan 0 atau 1 video, grup

Aktivitas pengguna menurut provinsi

Laporan ini berisi statistik aktivitas pengguna untuk negara bagian AS dan District of Columbia. Untuk laporan ini, Anda harus menetapkan nilai parameter filters ke country==US.

Daftar Isi
Dimensi:
Wajib province
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Wajib country==AS
Gunakan 0 atau 1 video, grup

Aktivitas pengguna menurut kota (<= 250 hasil)

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 250 atau kurang. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini menyajikan statistik aktivitas pengguna menurut kota.

Daftar Isi
Dimensi:
Wajib kota
Gunakan 0 atau lebih creatorContentType, country, province, subscribedStatus

Catatan: Jika Anda menyertakan dimensi province, Anda juga harus menggunakan filter country==US.
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Opsi pengurutan: -penayangan
-estimatedMinutesWatched

Detail pemutaran

Laporan detail pemutaran memberikan statistik terkait atribut tampilan berikut:

  • Apakah penayangan siaran video live atau video on-demand?
  • Apakah penonton subscribe ke channel yang memiliki video tersebut?
  • Di produk YouTube mana penayangan terjadi?

Catatan: Dimensi dan filter liveOrOnDemand tidak dapat digunakan bersama dengan metrik averageViewPercentage. Dengan demikian, setiap subbagian berikut mencantumkan dua laporan. Satu laporan mendukung dimensi dan filter liveOrOnDemand, sementara yang lain mendukung metrik averageViewPercentage.

Aktivitas pengguna menurut status berlangganan

Laporan ini memberikan metrik aktivitas pengguna untuk penonton yang subscribe dan unsubscribe. Statistik dapat dikelompokkan menurut jangka waktu (hari atau bulan), dan laporan juga dapat difilter menurut negara, benua, atau subbenua.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih .
Filter:
Gunakan 0 atau 1 country, benua, subbenua
Gunakan 0 atau 1 video, grup
Opsional langganandStatus

Aktivitas pengguna menurut status berlangganan untuk provinsi

Laporan ini memberikan metrik aktivitas pengguna untuk penonton yang subscribe dan unsubscribe di negara bagian Amerika Serikat atau District of Columbia. Laporan ini mendukung lebih sedikit metrik daripada laporan sebelumnya.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih province, subscribedStatus

Detail pemutaran dengan dimensi waktu opsional

Dimensi waktu – hari atau bulan – bersifat opsional untuk laporan ini karena, terlepas dari itu, Anda harus menggunakan parameter permintaan startDate dan endDate untuk menentukan rentang tanggal yang akan dibahas dalam laporan. Dimensi, jika ada, menunjukkan bahwa Anda ingin data dalam laporan digabungkan menurut hari, bulan, dll.

Detail pemutaran dengan dimensi waktu opsional dan statistik liveOrOnDemand

Laporan ini memberikan statistik detail pemutaran untuk interval waktu tertentu. API ini mendukung dimensi (dan filter) liveOrOnDemand.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct
Detail pemutaran dengan dimensi waktu opsional dan metrik averageViewPercentage

Laporan ini memberikan statistik detail pemutaran untuk interval waktu tertentu. Metrik ini mendukung metrik averageViewPercentage.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus, youtubeProduct
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Detail pemutaran menurut negara

Detail pemutaran menurut negara dengan statistik liveOrOnDemand

Laporan ini memberikan statistik detail pemutaran berdasarkan setiap negara. API ini mendukung dimensi (dan filter) liveOrOnDemand.

Daftar Isi
Dimensi:
Wajib country
Gunakan 0 atau lebih creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Gunakan 0 atau 1 benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct
Detail pemutaran menurut negara dengan metrik averageViewPercentage

Laporan berikut ini mirip dengan laporan sebelumnya. Ini menambahkan dukungan untuk metrik averageViewPercentage, tetapi tidak mendukung liveOrOnDemand sebagai dimensi atau filter.

Daftar Isi
Dimensi:
Wajib country
Gunakan 0 atau lebih creatorContentType, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Detail pemutaran menurut provinsi

Detail pemutaran menurut provinsi dengan statistik liveOrOnDemand

Laporan ini menyajikan statistik detail pemutaran untuk negara bagian AS dan District of Columbia. API ini mendukung dimensi (dan filter) liveOrOnDemand.

Daftar Isi
Dimensi:
Wajib province
Gunakan 0 atau lebih creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Wajib negara==US
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct
Detail pemutaran menurut provinsi dengan metrik averageViewPercentage

Laporan berikut ini mirip dengan laporan sebelumnya. Ini menambahkan dukungan untuk metrik averageViewPercentage, tetapi tidak mendukung liveOrOnDemand sebagai dimensi atau filter.

Daftar Isi
Dimensi:
Wajib province
Gunakan 0 atau lebih creatorContentType, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Wajib negara==US
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Lokasi pemutaran

Laporan lokasi pemutaran video

Laporan ini menyediakan statistik yang terkait dengan jenis halaman atau aplikasi tempat pemutaran video terjadi.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationType
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus

Detail lokasi pemutaran (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 25 atau kurang. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini mengidentifikasi pemutar video tersemat yang menghasilkan penayangan atau waktu tonton paling banyak untuk video di channel.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationDetail
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Wajib insightPlaybackLocationType==EMBEDDED
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus
Opsi pengurutan: -penayangan
-estimatedMinutesWatched

Sumber traffic

Sumber traffic

Laporan ini menggabungkan statistik penayangan berdasarkan cara penonton menjangkau konten video Anda. Misalnya, data ini mengidentifikasi jumlah penayangan yang berasal dari penelusuran Google atau dari link ke video terkait.

Daftar Isi
Dimensi:
Wajib insightTrafficSourceType
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus

Detail sumber traffic (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 25 atau kurang. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini menggabungkan statistik penayangan berdasarkan perujuk yang menghasilkan penayangan konten channel terbanyak. Perujuk dikategorikan berdasarkan jenis sumber traffic, dan definisi dimensi insightTrafficSourceDetail akan mengidentifikasi sumber traffic yang menyediakan laporan tersebut. Misalnya, jika Anda menyetel filter insightTrafficSourceType ke ADVERTISING, laporan akan mencantumkan jenis iklan yang menghasilkan penayangan atau waktu tonton paling banyak untuk konten di channel tersebut.

Daftar Isi
Dimensi:
Wajib insightTrafficSourceDetail
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Wajib insightTrafficSourceType (lihat catatan di bawah tabel)
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus
Opsi pengurutan: -penayangan
-estimatedMinutesWatched

Catatan: Laporan ini hanya didukung untuk sumber traffic tertentu. Misalnya, sumber traffic NO_LINK_EMBEDDED tidak memiliki detail tambahan, sehingga tidak mendukung laporan ini. Lihat definisi insightTrafficSourceType untuk mengetahui detail tentang sumber traffic yang mendukung laporan ini.

Jenis perangkat dan sistem operasi

Jenis perangkat

Laporan ini menggabungkan statistik penayangan berdasarkan cara penonton menjangkau konten video Anda. Misalnya, Analytics mengidentifikasi jumlah penayangan yang terjadi di perangkat seluler atau konsol game.

Daftar Isi
Dimensi:
Wajib deviceType
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistem operasi

Laporan ini menggabungkan statistik penayangan berdasarkan sistem operasi audiens. Misalnya, mengidentifikasi jumlah tampilan yang terjadi di perangkat Android atau di PlayStation.

Daftar Isi
Dimensi:
Wajib Sistem Operasi
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Jenis perangkat dan sistem operasi

Laporan ini menggabungkan statistik penayangan berdasarkan jenis perangkat dan sistem operasi pemirsa. Misalnya, data ini mengidentifikasi jumlah tampilan yang terjadi di tablet Android atau di perangkat desktop Windows.

Daftar Isi
Dimensi:
Wajib deviceType, operatingSystem
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct

Demografi penonton

Laporan ini menggabungkan statistik penayangan berdasarkan kelompok usia dan jenis kelamin pemirsa.

Daftar Isi
Dimensi:
Gunakan 1 atau lebih ageGroup, gender
Gunakan 0 atau lebih creatorContentType, liveOrOnDemand, subscribedStatus
Metrik:
Gunakan 1 atau lebih ViewerPercentage
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus
Catatan: Nilai viewerPercentage dalam laporan ini tidak dinormalkan untuk nilai atau kombinasi nilai yang berbeda untuk dimensi detail pemutaran (subscribedStatus, liveOrOnDemand, atau youtubeProduct).

Misalnya, laporan yang menggunakan dimensi subscribedStatus menampilkan viewerPercentage data yang ditambahkan hingga 100 persen penayangan untuk {130% persen penayangan, {130% persen data yang ditambahkan hingga 110% penayangan untuk {130% persen penayangan hingga 110 persen (Total nilai semua kolom viewerPercentage dalam laporan adalah 200 persen.)

Anda dapat menggunakan filter untuk memastikan bahwa laporan hanya berisi data viewerPercentage untuk satu nilai (atau kombinasi nilai) untuk dimensi detail pemutaran.

Interaksi dan berbagi konten

Laporan ini berisi statistik yang menunjukkan seberapa sering video channel dibagikan di berbagai platform sosial.

Daftar Isi
Dimensi:
Wajib Layanan Berbagi
Gunakan 0 atau lebih creatorContentType, subscribedStatus
Metrik:
Gunakan 1 atau lebih berbagi
Filter:
Gunakan 0 atau 1 country, benua, subbenua
Gunakan 0 atau 1 video, grup
Opsional langganandStatus

Retensi audiens

Laporan ini mengukur kemampuan video untuk mempertahankan penontonnya. Dimensi elapsedVideoTimeRatio mengukur jumlah video yang telah berlalu untuk nilai metrik yang sesuai. Metrik audienceWatchRatio dan relativeRetentionPerformance memberikan dua pengukuran yang menunjukkan seberapa baik video mempertahankan penontonnya. Yang pertama adalah nilai mutlak, sedangkan yang kedua menunjukkan performa video relatif terhadap video YouTube lain dengan durasi yang serupa.

Catatan: Laporan retensi audiens tidak mendukung kemampuan untuk menentukan daftar nilai yang dipisahkan koma untuk filter video; nilai harus menentukan satu ID video.

Daftar Isi
Dimensi:
Wajib elapsedVideoTimeRatio
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih audienceWatchRatio, RelativeRetentionPerformance
Filter:
Wajib video
Gunakan 0 atau lebih audienceType, subscribedStatus, youtubeProduct

Video teratas

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 200 atau kurang. Sebelum 1 Januari 2013, data hanya tersedia untuk 10 video teratas. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Video teratas dengan filter regional opsional (<= 200 hasil)

Laporan ini mencantumkan video teratas channel. Laporan dapat difilter untuk mencantumkan video teratas berdasarkan negara, benua, atau subbenua.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih .
Filter:
Gunakan 0 atau 1 country, benua, subbenua
Opsi pengurutan: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscriberDiperoleh
-subscriberLost

Video teratas berdasarkan negara bagian (<= 200 hasil)

Laporan ini mencantumkan video teratas channel di negara bagian AS atau District of Columbia tertentu. Perhatikan bahwa laporan ini hanya mendukung subkumpulan metrik yang tersedia di laporan khusus negara yang dijelaskan di atas.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Wajib province
Opsional langganandStatus
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video teratas untuk penonton yang subscribe atau tidak subscribe (<= 200 hasil)

Laporan ini mencantumkan video teratas channel untuk penonton yang subscribe atau tidak subscribe. Laporan dapat difilter untuk mencantumkan video teratas berdasarkan negara, benua, atau subbenua. Laporan sebelumnya memungkinkan Anda mengambil video teratas di negara bagian AS tertentu untuk penonton yang subscribe atau tidak subscribe, tetapi mendukung lebih sedikit metrik daripada laporan ini.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih .
Filter:
Opsional langganandStatus
Gunakan 0 atau 1 country, benua, subbenua
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video teratas menurut Produk YouTube (<= 200 hasil)

Laporan ini mencantumkan video teratas di channel dan mendukung detail pemutaran dan filter geografis. Laporan ini mirip dengan yang sebelumnya, tetapi mendukung lebih sedikit metrik dan menambahkan dukungan untuk filter youtubeProduct.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau lebih subscribedStatus, youtubeProduct
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video teratas dengan filter detail pemutaran (<= 200 hasil)

Laporan ini mencantumkan video teratas channel, memfilter menurut sebagian atau semua dimensi detail pemutaran: liveOrOnDemand, subscribedStatus, dan youtubeProduct. Tidak seperti laporan sebelumnya, laporan ini mendukung filter liveOrOnDemand dan tidak mendukung metrik averageViewPercentage.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Laporan playlist

Statistik dasar

Laporan ini berisi statistik yang berkaitan dengan interaksi pengguna dengan playlist channel. Anda dapat memfilter laporan agar hanya menampilkan data untuk playlist atau negara tertentu.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Berbasis waktu

Laporan ini berisi statistik yang berkaitan dengan interaksi pengguna dengan playlist channel. Anda dapat memfilter laporan agar hanya menampilkan data untuk playlist atau negara tertentu.

Daftar Isi
Dimensi:
Gunakan persis 1 day, month
Gunakan 0 atau lebih subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Geografi pengguna

Aktivitas playlist menurut negara

Laporan ini berisi statistik yang berkaitan dengan interaksi pengguna dengan playlist channel. Anda dapat memfilter laporan agar hanya menampilkan data untuk playlist, grup playlist, atau negara tertentu.

Daftar Isi
Dimensi:
Wajib country
Gunakan 0 atau lebih subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Aktivitas playlist menurut provinsi

Laporan ini berisi statistik aktivitas playlist untuk negara bagian AS dan District of Columbia. Untuk laporan ini, Anda menyertakan country==US dalam nilai parameter filters.

Daftar Isi
Dimensi:
Wajib province
Gunakan 0 atau lebih subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1;negara==US
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Lokasi pemutaran

Laporan ini berisi statistik yang terkait dengan jenis halaman atau aplikasi tempat pemutaran playlist terjadi.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationType
Gunakan 0 atau lebih hari, subscribedStatus
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Opsional langganandStatus

Detail lokasi pemutaran (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 25 atau kurang. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini mengidentifikasi pemutar video tersemat yang menghasilkan penayangan atau waktu tonton terbanyak untuk playlist channel.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationDetail
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1;insightPlaybackLocationType==EMBEDDED
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Opsional langganandStatus
Opsi pengurutan: -penayangan
-estimatedMinutesWatched
-playlistStarts

Sumber traffic

Laporan ini menggabungkan statistik penayangan berdasarkan cara penonton menjangkau konten playlist Anda. Misalnya, ID ini mengidentifikasi jumlah tampilan yang berasal dari penelusuran Google.

Daftar Isi
Dimensi:
Wajib insightTrafficSourceType
Gunakan 0 atau lebih hari, subscribedStatus
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Opsional langganandStatus

Detail sumber traffic (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 25 atau kurang. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini menggabungkan statistik penayangan berdasarkan perujuk yang menghasilkan penayangan terbanyak untuk playlist channel. Perujuk dikategorikan berdasarkan jenis sumber traffic, dan definisi dimensi insightTrafficSourceDetail akan mengidentifikasi sumber traffic yang menyediakan laporan tersebut.

Misalnya, jika Anda menetapkan filter insightTrafficSourceType ke ADVERTISING, laporan akan mencantumkan jenis iklan yang menghasilkan penayangan atau waktu tonton paling banyak untuk playlist channel.

Daftar Isi
Dimensi:
Wajib insightTrafficSourceDetail
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1;insightTrafficSourceType
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Opsional langganandStatus
Opsi pengurutan: -penayangan
-estimatedMinutesWatched
-playlistStarts

Catatan: Laporan ini hanya didukung untuk sumber traffic tertentu. Misalnya, sumber traffic NO_LINK_EMBEDDED tidak memiliki detail tambahan, sehingga tidak mendukung laporan ini. Lihat definisi insightTrafficSourceType untuk mengetahui detail tentang sumber traffic yang mendukung laporan ini.

Jenis perangkat dan sistem operasi

Jenis perangkat

Laporan ini menggabungkan statistik penayangan berdasarkan cara penonton menjangkau konten playlist Anda. Misalnya, Analytics mengidentifikasi jumlah penayangan yang terjadi di perangkat seluler atau konsol game.

Daftar Isi
Dimensi:
Wajib deviceType
Gunakan 0 atau lebih hari, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih operatingSystem, subscribedStatus, youtubeProduct

Sistem operasi

Laporan ini menggabungkan statistik penayangan berdasarkan sistem operasi audiens. Misalnya, mengidentifikasi jumlah penayangan playlist yang terjadi di perangkat Android atau di PlayStation.

Daftar Isi
Dimensi:
Wajib Sistem Operasi
Gunakan 0 atau lebih hari, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih deviceType, subscribedStatus, youtubeProduct

Jenis perangkat dan sistem operasi

Laporan ini menggabungkan statistik penayangan berdasarkan jenis perangkat dan sistem operasi pemirsa. Misalnya, fitur ini mengidentifikasi jumlah penayangan playlist yang terjadi di tablet Android atau di perangkat desktop Windows.

Daftar Isi
Dimensi:
Wajib deviceType, operatingSystem
Gunakan 0 atau lebih hari, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih penayangan, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Demografi penonton

Daftar Isi
Dimensi:
Gunakan 1 atau lebih ageGroup, gender
Gunakan 0 atau lebih langganandStatus
Metrik:
Wajib ViewerPercentage
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau 1 playlist, grup
Opsional langganandStatus
Catatan: Nilai viewerPercentage dalam laporan ini tidak dinormalkan untuk nilai atau kombinasi nilai yang berbeda untuk dimensi detail pemutaran (subscribedStatus dan youtubeProduct).

Misalnya, laporan yang menggunakan dimensi subscribedStatus menampilkan data viewerPercentage yang menambahkan hingga 100 persen untuk jumlah penayangan yang subscribe dan penonton datauntuk berhenti berlangganan. (Total nilai semua kolom viewerPercentage dalam laporan adalah 200 persen.)

Anda dapat menggunakan filter untuk memastikan bahwa laporan hanya berisi data viewerPercentage untuk satu nilai (atau kombinasi nilai) untuk dimensi detail pemutaran.

Playlist teratas

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 200 atau kurang. Sebelum 1 Januari 2013, data hanya tersedia untuk 10 playlist teratas. Tidak seperti sebagian besar laporan lainnya, laporan ini juga mengharuskan Anda menentukan nilai untuk parameter permintaan sort.

Laporan ini mencantumkan playlist teratas channel berdasarkan kriteria pemfilteran dan pengurutan yang ditentukan.

Daftar Isi
Dimensi:
Wajib playlist
Metrik:
Gunakan 1 atau lebih penayangan, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filter:
Wajib isCurated==1
Gunakan 0 atau 1 country, province, benua, subbenua
Gunakan 0 atau lebih playlist, subscribedStatus, youtubeProduct
Opsi pengurutan: -penayangan
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Laporan performa iklan

Catatan: Laporan performa iklan memerlukan token otorisasi yang memberikan akses ke cakupan https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Laporan performa iklan menyediakan metrik berbasis tayangan untuk iklan yang berjalan selama pemutaran video. Metrik ini memperhitungkan setiap tayangan iklan, dan setiap pemutaran video dapat menghasilkan beberapa tayangan.

Metrik performa iklan berbasis tayangan adalah:

Selain itu, beberapa laporan video mendukung metrik performa iklan berbasis pemutaran berikut. Namun, metrik ini tidak disertakan dalam laporan performa iklan.

Performa iklan menurut jenis iklan

Daftar Isi
Dimensi:
Wajib jenis iklan
Opsional hari
Metrik:
Gunakan 1 atau lebih GrossRevenue, adImpression, cpm
Filter:
Gunakan 0 atau 1 video, grup
Gunakan 0 atau 1 country, benua, subbenua