YouTube Analytics API: Channel Reports

Halaman ini mencantumkan laporan yang dapat diambil pemilik channel dengan YouTube Analytics API. Laporan channel memberikan metrik aktivitas pengguna untuk channel tertentu dan mengukur hal-hal seperti penayangan video, rating, dan jumlah subscriber.

  • Laporan video memberikan statistik untuk semua aktivitas pengguna yang terkait dengan video 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. Mereka 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 channel unik dari channel yang datanya Anda ambil. Pengguna yang mengizinkan permintaan harus merupakan pemilik channel.

    ID channel 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 Anda, atau Anda dapat mengambil ID channel secara terprogram menggunakan metode YouTube Data API's channels.list.)

Otorisasi

Semua permintaan YouTube Analytics API harus mendapatkan otorisasi. 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 Melihat 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 Melihat laporan moneter YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna serta metrik perkiraan pendapatan dan performa iklan.
https://www.googleapis.com/auth/youtube Mengelola akun YouTube Anda. Di YouTube Analytics API, pemilik channel menggunakan cakupan ini untuk mengelola grup YouTube Analytics dan item grup.
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 YouTube Analytics dan item grup.

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 wajib ada, dan filter negara bersifat opsional.

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

Lihat definisi parameter filters untuk 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 berikut mencantumkan dimensi, metrik, dan filter yang didukung untuk laporan video detail pemutaran menggunakan dimensi waktu dan metrik averageViewPercentage.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus, youtubeProduct
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

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

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Namun, nilai parameter day,month tidak valid karena menggunakan dua dimensi berbasis waktu, dan permintaan harus menggunakan 0 atau 1.

Terminologi tabel laporan

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

  • Istilah ini berarti nilai wajib diisi:
    • Wajib: Anda harus menyertakan nilai.
    • Gunakan tepat 1: Anda harus menyertakan satu nilai dari grup.
    • Gunakan 1 atau lebih: Anda dapat menyertakan nilai apa pun atau semua nilai dari grup, tetapi Anda harus menyertakan setidaknya satu nilai.
  • Istilah berikut berarti nilai bersifat opsional:
    • Opsional: Anda memiliki opsi untuk menyertakan nilai.
    • Gunakan 0 atau 1: Anda memiliki opsi untuk menyertakan satu nilai dari grup.
    • Gunakan 0 atau lebih: Anda memiliki opsi untuk menyertakan nilai apa pun atau semua nilai dari grup.

Laporan video

Statistik dasar

Statistik aktivitas pengguna dasar

Laporan ini memberikan statistik terkait tindakan pengguna di channel. Anda dapat memfilter laporan untuk hanya menampilkan data untuk video atau negara tertentu.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih estimatedAdRevenue
Filter:
Gunakan 0 atau 1 country, continent, subContinent
Gunakan 0 atau 1 video, grup

Statistik aktivitas pengguna dasar untuk negara bagian AS

Laporan ini memberikan statistik untuk negara bagian AS tertentu atau Distrik Columbia. Perhatikan bahwa laporan ini hanya mendukung sebagian kecil metrik yang tersedia dalam laporan khusus negara yang dijelaskan di atas.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih engagedViews, 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

Berdasarkan waktu

Aktivitas pengguna menurut negara untuk jangka waktu tertentu

Laporan ini memberikan statistik terkait tindakan pengguna di channel untuk interval waktu tertentu. Anda dapat memfilter laporan untuk hanya menampilkan data untuk video atau negara tertentu.

Daftar Isi
Dimensi:
Gunakan tepat 1 day, month
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih adImpressions
Filter:
Gunakan 0 atau 1 country, continent, subContinent
Gunakan 0 atau 1 video, grup

Aktivitas pengguna di negara bagian AS untuk jangka waktu tertentu

Laporan ini memberikan statistik terkait aktivitas pengguna untuk negara bagian tertentu di Amerika Serikat atau Distrik Columbia. Perhatikan bahwa laporan ini hanya mendukung sebagian kecil metrik yang tersedia dalam laporan khusus negara yang dijelaskan di atas.

Daftar Isi
Dimensi:
Gunakan tepat 1 day, month
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih engagedViews, 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 memberikan statistik terkait aktivitas pengguna berdasarkan negara untuk suatu channel. Anda dapat memfilter laporan untuk hanya menampilkan data untuk video tertentu.

Daftar Isi
Dimensi:
Wajib country
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih estimatedAdRevenue
Filter:
Gunakan 0 atau 1 continent, subContinent
Gunakan 0 atau 1 video, grup

Aktivitas pengguna menurut provinsi

Laporan ini memberikan statistik aktivitas pengguna untuk negara bagian AS dan Distrik 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 engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Wajib country==US
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 berisi 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 engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Opsi pengurutan: -views
-estimatedMinutesWatched

Aktivitas pengguna menurut DMA

Laporan ini berisi statistik aktivitas pengguna menurut Area Pasar yang Ditunjuk (DMA). Untuk laporan ini, Anda harus menetapkan nilai parameter filters ke country==US atau memfilter ke provinsi tertentu (negara bagian AS).

Daftar Isi
Dimensi:
Wajib dma
Gunakan 0 atau 1 day
month
creatorContentType
subscribedStatus
Metrik:
Gunakan 1 atau lebih engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
Filter:
Gunakan 0 atau 1 country==US
province
Gunakan 0 atau 1 grup
video
Opsi pengurutan: -views
-estimatedMinutesWatched

Detail pemutaran

Laporan detail pemutaran memberikan statistik yang terkait dengan atribut penayangan berikut:

  • Apakah video yang ditonton adalah 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. Oleh karena itu, setiap subbagian berikut mencantumkan dua laporan. Satu laporan mendukung dimensi (dan filter) liveOrOnDemand, sementara laporan lainnya mendukung metrik averageViewPercentage.

Aktivitas pengguna menurut status berlangganan

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

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Gunakan 0 atau 1 country, continent, subContinent
Gunakan 0 atau 1 video, grup
Opsional subscribedStatus

Aktivitas pengguna menurut status berlangganan untuk provinsi

Laporan ini memberikan metrik aktivitas pengguna untuk penonton yang berlangganan dan tidak berlangganan di negara bagian AS atau Distrik 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 engagedViews, 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 dicakup oleh laporan. Dimensi, jika ada, menunjukkan bahwa Anda ingin data dalam laporan diagregasi menurut hari, bulan, dll.

Detail pemutaran dengan dimensi waktu opsional dan statistik liveOrOnDemand

Laporan ini memberikan statistik detail pemutaran untuk interval waktu tertentu. Dimensi (dan filter) liveOrOnDemand didukung.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
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. Mendukung metrik averageViewPercentage.

Daftar Isi
Dimensi:
Gunakan 0 atau lebih creatorContentType, subscribedStatus, youtubeProduct
Gunakan 0 atau 1 day, month
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
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. Dimensi (dan filter) liveOrOnDemand didukung.

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

Laporan berikut mirip dengan laporan sebelumnya. API 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 engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 continent, subContinent
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 memberikan statistik detail pemutaran untuk negara bagian AS dan District of Columbia. Dimensi (dan filter) liveOrOnDemand didukung.

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

Laporan berikut mirip dengan laporan sebelumnya. API 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 engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Wajib country==US
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih subscribedStatus, youtubeProduct

Lokasi pemutaran

Laporan lokasi pemutaran video

Laporan ini memberikan statistik terkait 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 engagedViews, views, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus

Detail lokasi pemutaran (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menyetel 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 sematan yang menghasilkan penayangan atau waktu tonton terbanyak untuk video channel.

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

Sumber traffic

Sumber traffic

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

Catatan: Laporan ini menampilkan error jika hasil perkalian # video yang dikueri X # hari dalam rentang tanggal melebihi 50.000. Misalnya, kueri yang mengambil data untuk 500 ID video dapat meminta data selama maksimum 100 hari. Untuk mengurangi jumlah baris yang ditampilkan permintaan, pisahkan kueri Anda menjadi beberapa kueri yang menentukan lebih sedikit video atau tetapkan rentang tanggal yang lebih pendek.

Daftar Isi
Dimensi:
Wajib insightTrafficSourceType
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus

Detail sumber traffic (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menyetel 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 konten channel. Perujuk dikategorikan menurut jenis sumber traffic, dan definisi dimensi insightTrafficSourceDetail mengidentifikasi sumber traffic yang laporannya tersedia. Misalnya, jika Anda menyetel filter insightTrafficSourceType ke ADVERTISING, laporan akan mencantumkan jenis iklan yang menghasilkan penayangan atau waktu tonton terbanyak untuk konten channel.

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

Catatan: Laporan ini hanya didukung untuk sumber traffic tertentu. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, dan NO_LINK_EMBEDDED adalah beberapa sumber traffic yang tidak didukung.

Jenis perangkat dan sistem operasi

Jenis perangkat

Laporan ini menggabungkan statistik tontonan berdasarkan cara penonton menjangkau konten video Anda. Misalnya, 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 engagedViews, views, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistem operasi

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

Daftar Isi
Dimensi:
Wajib operatingSystem
Gunakan 0 atau lebih creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistem operasi dan jenis perangkat

Laporan ini menggabungkan statistik penayangan berdasarkan sistem operasi dan jenis perangkat penonton. Misalnya, metrik ini mengidentifikasi jumlah penayangan 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 engagedViews, views, estimatedMinutesWatched
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct

Demografi penonton

Laporan ini menggabungkan statistik penayangan berdasarkan kelompok usia dan gender penonton.

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, continent, subContinent
Gunakan 0 atau 1 video, grup
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus
Catatan: Nilai viewerPercentage dalam laporan ini tidak dinormalisasi untuk nilai atau kombinasi nilai yang berbeda untuk dimensi detail pemutaran (subscribedStatus, liveOrOnDemand, atau youtubeProduct).

Misalnya, laporan yang menggunakan dimensi subscribedStatus menampilkan data viewerPercentage yang berjumlah hingga 100 persen untuk penayangan subscriber dan data viewerPercentage yang berjumlah hingga 100 persen untuk penayangan non-subscriber. (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 memberikan statistik yang menunjukkan seberapa sering video channel dibagikan di berbagai platform media sosial.

Daftar Isi
Dimensi:
Wajib sharingService
Gunakan 0 atau lebih creatorContentType, subscribedStatus
Metrik:
Gunakan 1 atau lebih saham
Filter:
Gunakan 0 atau 1 country, continent, subContinent
Gunakan 0 atau 1 video, grup
Opsional subscribedStatus

Retensi penonton

Laporan ini mengukur kemampuan video dalam mempertahankan audiensnya dan juga menunjukkan seberapa sering bagian tertentu dari video ditonton. Dimensi elapsedVideoTimeRatio mengukur jumlah video yang telah berlalu untuk nilai metrik yang sesuai. Metrik dapat dibagi menjadi dua kategori:

  • Retensi audiens

    Metrik ini menunjukkan seberapa baik video mempertahankan penontonnya.

    • audienceWatchRatio adalah rasio yang membandingkan jumlah berapa kali sebagian video ditonton dengan total jumlah penayangan video.
    • relativeRetentionPerformance menunjukkan seberapa baik video mempertahankan penonton selama pemutaran dibandingkan dengan video YouTube lain yang berdurasi serupa.

  • Statistik tontonan terperinci

    Metrik ini memberikan informasi tentang seberapa sering bagian tertentu dari video ditonton.

    • startedWatching menunjukkan seberapa sering penonton mulai menonton video selama segmen tertentu dalam video.
    • stoppedWatching menunjukkan seberapa sering penonton berhenti menonton video selama segmen video tertentu.
    • totalSegmentImpressions menunjukkan seberapa sering segmen tertentu video ditonton.

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

Daftar Isi
Dimensi:
Wajib elapsedVideoTimeRatio
Metrik:
Gunakan 1 atau lebih audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
Filter:
Wajib video
Gunakan 0 atau lebih audienceType
subscribedStatus
youtubeProduct

Penonton serentak (untuk livestream)

Laporan ini menampilkan penonton serentak pada posisi tertentu untuk satu video live stream. Filter menentukan video. Dimensi posisi umumnya mewakili satu menit.

Daftar Isi
Dimensi:
Gunakan 0 atau 1 livestreamPosition
Metrik:
Gunakan 1 atau lebih averageConcurrentViewers
peakConcurrentViewers
Filter:
Wajib video

Video teratas

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 200 atau kurang. Data sebelum 1 Januari 2013 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 menurut negara, benua, atau subContinent.

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih estimatedAdRevenue
Filter:
Gunakan 0 atau 1 country, continent, subContinent
Opsi pengurutan: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Video teratas menurut negara bagian (<= 200 hasil)

Laporan ini mencantumkan video teratas channel di negara bagian tertentu di Amerika Serikat atau Distrik Columbia. Perhatikan bahwa laporan ini hanya mendukung sebagian kecil metrik yang tersedia dalam laporan khusus negara yang dijelaskan di atas.

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

Video teratas untuk penonton yang berlangganan atau berhenti berlangganan(<= 200 hasil)

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

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filter:
Opsional subscribedStatus
Gunakan 0 atau 1 country, continent, subContinent
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video teratas menurut Produk YouTube (<= 200 hasil)

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

Daftar Isi
Dimensi:
Wajib video
Opsional creatorContentType
Metrik:
Gunakan 1 atau lebih engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
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, yang difilter menurut salah satu 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 engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filter:
Gunakan 0 atau 1 country, province, continent, subContinent
Gunakan 0 atau lebih liveOrOnDemand, subscribedStatus, youtubeProduct
Opsi pengurutan: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Laporan playlist

Laporan playlist berisi metrik yang terkait dengan aktivitas pengguna yang terkait dengan video dalam playlist pemilik channel. Dua versi laporan ini tersedia, dan untuk setiap laporan yang tersedia, bagian berikut berisi deskripsi setiap versi:

Metrik video gabungan

Metrik ini memberikan metrik aktivitas pengguna dan tayangan iklan yang digabungkan untuk semua video dalam playlist yang juga dimiliki oleh channel yang memiliki playlist tersebut. Metrik untuk video yang dimiliki channel lain tidak dihitung dalam penggabungan. Akibatnya, jika channel membuat playlist yang hanya berisi video yang dimiliki channel lain, laporan untuk playlist tersebut tidak akan memberikan nilai untuk metrik ini.

Lihat bagian metrik playlist yang didukung untuk mengetahui daftar metrik video gabungan yang didukung YouTube.

Metrik dalam playlist

Metrik ini mencerminkan aktivitas dan engagement pengguna dalam konteks halaman playlist. Metrik ini mencakup penayangan untuk semua video dalam playlist, terlepas dari channel mana yang memilikinya, tetapi hanya menghitung penayangan yang terjadi dalam konteks playlist.

Metrik playlist yang didukung

Daftar Isi
Metrik video gabungan engagedViews, views, estimatedMinutesWatched, averageViewDuration
Metrik dalam playlist playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

Statistik dasar

Laporan ini memberikan statistik terkait interaksi pengguna dengan video dalam playlist channel. Anda dapat memfilter laporan untuk hanya menampilkan data untuk playlist tertentu.

Daftar Isi
Dimensi:
[None]
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Berdasarkan waktu

Laporan ini memberikan statistik terkait interaksi pengguna dengan video dalam playlist channel. Anda dapat memfilter laporan untuk hanya menampilkan data untuk playlist tertentu.

Daftar Isi
Dimensi:
Gunakan tepat 1 day, month
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Geografi pengguna

Aktivitas playlist menurut negara

Laporan ini memberikan statistik terkait interaksi yang dilakukan pengguna di negara tertentu dengan video dalam playlist channel.

Daftar Isi
Dimensi:
Wajib country
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filter:
Gunakan tepat 1 playlist, grup
Gunakan 0 atau 1 continent, subContinent

Aktivitas playlist menurut provinsi

Laporan ini memberikan statistik aktivitas playlist untuk negara bagian AS dan District of Columbia. Untuk laporan ini, Anda harus memfilter hasil untuk menampilkan data hanya untuk Amerika Serikat.

Daftar Isi
Dimensi:
Wajib province
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filter:
Wajib country==US
Gunakan tepat 1 playlist, grup

Lokasi pemutaran

Laporan ini memberikan statistik terkait jenis halaman atau aplikasi tempat pemutaran video playlist Anda terjadi.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationType
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Detail lokasi pemutaran (<= 25 hasil)

Catatan: Laporan ini mengharuskan Anda menyetel 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 sematan yang menghasilkan penayangan atau waktu tonton terbanyak untuk video dalam playlist channel.

Daftar Isi
Dimensi:
Wajib insightPlaybackLocationDetail
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Wajib insightPlaybackLocationType==EMBEDDED
Gunakan tepat 1 playlist, grup
Opsi pengurutan: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Sumber traffic

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

Daftar Isi
Dimensi:
Wajib insightTrafficSourceType
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

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 video dalam playlist channel. Perujuk dikategorikan menurut jenis sumber traffic, dan definisi dimensi insightTrafficSourceDetail mengidentifikasi sumber traffic yang laporannya tersedia.

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

Daftar Isi
Dimensi:
Wajib insightTrafficSourceDetail
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Wajib insightTrafficSourceType==ADVERTISING (atau nilai lain yang didukung)
Gunakan tepat 1 playlist, grup
Opsi pengurutan: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Catatan: Laporan ini hanya didukung untuk sumber traffic tertentu. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, dan NO_LINK_EMBEDDED adalah beberapa sumber traffic yang tidak didukung.

Jenis perangkat dan sistem operasi

Jenis perangkat

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

Daftar Isi
Dimensi:
Wajib deviceType
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Sistem operasi

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

Daftar Isi
Dimensi:
Wajib operatingSystem
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Sistem operasi dan jenis perangkat

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

Daftar Isi
Dimensi:
Wajib deviceType, operatingSystem
Metrik:
Gunakan 1 atau lebih engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filter:
Gunakan tepat 1 playlist, grup

Demografi penonton

Daftar Isi
Dimensi:
Gunakan 1 atau lebih ageGroup, gender
Metrik:
Wajib viewerPercentage
Filter:
Gunakan tepat 1 playlist, grup

Playlist teratas

Catatan: Laporan ini mengharuskan Anda menetapkan parameter maxResults ke nilai bilangan bulat 200 atau kurang. Data sebelum 1 Januari 2013 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 averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Opsi pengurutan: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Laporan keanggotaan

Pembatalan langganan

Laporan ini memberikan statistik yang menunjukkan alasan pengguna membatalkan langganan channel mereka.

Daftar Isi
Dimensi:
Gunakan 0 atau 1 membershipsCancellationSurveyReason
Metrik:
Wajib membershipsCancellationSurveyResponses

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 memberikan metrik berbasis tayangan iklan 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 iklan 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 adType
Opsional hari
Metrik:
Gunakan 1 atau lebih grossRevenue, adImpressions, cpm
Filter:
Gunakan 0 atau 1 video, grup
Gunakan 0 atau 1 country, continent, subContinent