Introduction

Dokumen ini menjelaskan kesamaan dan perbedaan dalam cara YouTube Analytics API dan YouTube Reporting API memberikan akses ke data YouTube Analytics. Tujuan dokumen ini adalah untuk membantu Anda memilih API yang tepat untuk aplikasi Anda.

Kedua API tersebut memungkinkan developer untuk mengambil data YouTube Analytics. Selain itu, kedua API tersebut mendukung pemilik channel YouTube dan pemilik konten YouTube, yang masing-masing dapat mengakses kumpulan laporan tertentu:

  • Laporan saluran berisi metrik aktivitas pengguna untuk saluran tertentu.

  • Laporan pemilik konten menggabungkan metrik untuk semua channel yang tertaut ke pemilik konten YouTube tertentu. Misalnya, label rekaman dapat mengambil laporan yang berisi statistik gabungan untuk channel YouTube semua artis label tersebut. Beberapa laporan pemilik konten berisi metrik aktivitas pengguna, sementara yang lainnya berisi metrik yang terkait dengan pendapatan dan performa iklan.

Reporting API juga memungkinkan beberapa pemilik konten mengakses laporan pendapatan iklan yang dikelola sistem. Data dalam laporan yang dikelola sistem hanya dapat diambil dengan Reporting API.

Semua permintaan YouTube Analytics dan YouTube Reporting API harus diberi otorisasi oleh channel atau pemilik konten yang memiliki data yang diminta.

Laporkan konten

Laporan yang diambil API berisi dua jenis data:

  • Dimensi adalah kriteria umum yang digunakan untuk menggabungkan data, seperti tanggal terjadinya aktivitas pengguna atau negara tempat pengguna berada.

    Dalam laporan, setiap baris data memiliki kombinasi nilai dimensi yang unik. Dengan demikian, kombinasi setiap nilai nilai dimensi berfungsi sebagai kunci utama untuk baris tersebut.

  • Metrik adalah ukuran individu aktivitas pengguna, performa iklan, atau estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah dan rating tontonan video (suka dan tidak suka).

Pilih API yang tepat untuk aplikasi Anda

YouTube Analytics API
YouTube Analytics API mendukung kueri yang ditargetkan secara real-time untuk membuat laporan YouTube Analytics kustom. API ini menyediakan parameter pemfilteran dan pengurutan, sehingga aplikasi panggilan tidak perlu mendukung fungsi ini secara native.

Setiap permintaan API menentukan rentang tanggal data yang akan ditampilkan. API ini juga memungkinkan Anda mengambil set data mingguan dan bulanan. Dengan demikian, aplikasi panggilan tidak perlu menyimpan set data yang diambil atau menggabungkan statistik di seluruh rentang tanggal.
YouTube Reporting API
YouTube Reporting API mengambil laporan massal yang berisi data YouTube Analytics untuk channel atau pemilik konten. Google Analytics didesain untuk aplikasi yang dapat mengimpor set data besar dan menyediakan alat untuk memfilter, mengurutkan, dan menggali data tersebut.

Setiap laporan berisi kumpulan kolom standar. Developer menggunakan API untuk menjadwalkan tugas pelaporan, yang masing-masing mengidentifikasi laporan yang harus dibuat oleh YouTube. Kemudian, YouTube membuat laporan harian yang dapat didownload secara asinkron. Setiap laporan berisi data untuk periode 24 jam yang unik.

Selain itu, YouTube secara otomatis membuat kumpulan laporan yang dikelola sistem untuk pemilik konten yang memiliki akses ke laporan terkait di YouTube Creator Studio. Laporan ini memberikan akses terprogram ke data pendapatan iklan.

Laporan yang didukung

Tabel berikut mengidentifikasi berbagai jenis laporan yang dapat Anda ambil menggunakan API. Kueri yang ditargetkan tersedia melalui YouTube Analytics API, dan laporan massal tersedia melalui YouTube Reporting API.

Data yang tersedia di satu API mungkin tidak tersedia di API lainnya. Misalnya, YouTube Analytics API memungkinkan Anda mengambil metrik aktivitas pengguna setiap minggu atau setiap bulan, tetapi YouTube Reporting API mengharuskan Anda menggabungkan data tersebut sendiri. Di sisi lain, YouTube Reporting API mendukung laporan aset untuk pemilik konten, tetapi data tersebut tidak tersedia dari YouTube Analytics API.

Jenis laporan
Laporan video Didukung untuk saluran (kueri atau massal) dan pemilik konten (kueri atau massal).

Laporan video menyediakan statistik untuk semua aktivitas pengguna yang terkait dengan video di channel atau video pemilik konten. Misalnya, laporan ini berisi jumlah penayangan yang diterima video Anda. Di YouTube Analytics API, beberapa laporan video pemilik konten juga menyertakan metrik estimasi pendapatan dan performa iklan.
Laporan playlist Didukung untuk saluran (kueri atau massal) dan pemilik konten (kueri atau massal).

Laporan playlist memberikan statistik yang secara khusus terkait dengan jumlah tontonan video yang terjadi dalam konteks playlist. YouTube Reporting API mendukung laporan retensi penonton untuk playlist, tetapi YouTube Analytics API tidak mendukung laporan serupa.
Laporan performa iklan Didukung untuk pemilik konten (kueri atau massal).

Laporan performa iklan memberikan metrik berbasis tayangan untuk iklan yang dijalankan selama pemutaran video. Metrik ini memperhitungkan setiap tayangan iklan, dan setiap pemutaran video dapat menghasilkan beberapa tayangan.
Laporan estimasi pendapatan Didukung untuk pemilik konten (massal).

Laporan estimasi pendapatan memberikan total estimasi pendapatan untuk video dari sumber iklan yang dijual Google dan dari sumber non-iklan. Laporan ini juga berisi beberapa metrik performa iklan. Perhatikan bahwa laporan yang dikelola sistem berisi pendapatan yang sebenarnya.
Laporan aset Didukung untuk pemilik konten (massal).

Laporan aset memberikan metrik aktivitas pengguna yang terkait dengan video yang tertaut ke aset pemilik konten. Video disertakan dalam laporan pemilik konten jika pemilik konten telah mengklaim video tersebut sebagai video yang cocok dengan salah satu aset pemilik konten. Video tersebut mungkin telah diupload oleh pemilik konten atau pengguna YouTube lainnya.
Laporan yang dikelola sistem Didukung untuk pemilik konten yang memiliki akses ke laporan terkait di bagian Laporan di Creator Studio YouTube.

Laporan yang dikelola sistem memberikan data pendapatan aktual yang diperoleh aset dan video. Laporan tambahan mencantumkan video yang diklaim dan aset yang cocok dengan video tersebut. Perhatikan bahwa tidak semua laporan Creator Studio saat ini tersedia di API.

Catatan: YouTube secara otomatis membuat laporan yang dikelola sistem untuk pemilik konten yang memiliki akses ke laporan terkait di Creator Studio. Akibatnya, proses untuk mengambil laporan ini berbeda dengan jenis laporan lainnya dalam daftar ini. Lihat dokumentasi untuk laporan yang dikelola sistem guna mendapatkan informasi selengkapnya.

Perbedaan utama

Tabel berikut menyoroti perbedaan penting antara YouTube Analytics dan Reporting API.

Fitur YouTube Analytics API YouTube Reporting API
Proses untuk mengambil data Setiap permintaan API menentukan dimensi dan metrik yang akan ditampilkan, serta jangka waktu pengembalian data. Aplikasi menjadwalkan tugas pelaporan. Untuk setiap pekerjaan, YouTube membuat laporan harian yang dapat didownload secara asinkron.
Rentang Tanggal Beberapa laporan API menetapkan tanggal terjadinya aktivitas pengguna. Beberapa laporan tersebut mendukung dimensi untuk menggabungkan metrik aktivitas pengguna menurut bulan. Semua laporan API menentukan hari terjadinya aktivitas pengguna. Aplikasi yang menggunakan API dapat mengimplementasikan fitur untuk menggabungkan data selama interval berkala.
Memfilter data Anda dapat memfilter laporan agar hanya menyertakan baris yang dimensinya memiliki nilai tertentu. API ini juga mendukung beberapa dimensi, seperti benua dan subbenua, yang hanya digunakan sebagai filter. API ini mendukung download massal set data lengkap. Sheet tidak mendukung pemfilteran atau menampilkan data untuk dimensi hanya filter. Aplikasi klien menyimpan data yang didownload dan menerapkan fiturnya sendiri untuk memfilter data tersebut.
Pengurutan Laporan dapat diurutkan berdasarkan nilai metrik yang ditampilkan. Beberapa laporan hanya mendukung hasil dalam jumlah terbatas. Misalnya, laporan yang mencantumkan video yang paling banyak ditonton dari sebuah channel akan menampilkan maksimum 200 baris. API ini mendukung download massal set data lengkap. Aplikasi klien dapat menerapkan fiturnya sendiri untuk mengurutkan data yang didownload.
Enumerasi Laporan API berisi nilai teks, seperti "ANDROID" atau "CHANNEL", untuk mengidentifikasi nilai dimensi yang dienumerasi. Laporan API berisi bilangan bulat yang dapat dipetakan ke nilai teks.
Kuota Server API mengevaluasi setiap kueri untuk menentukan biaya kuotanya. Bagian penggunaan kuota menjelaskan metodologi secara lebih mendetail. Penggunaan kuota tidak menjadi masalah karena data diambil satu kali, lalu difilter, diurutkan, dan dikueri dalam aplikasi.
Laporan unik
  • Aktivitas pengguna terkait subtitel
  • Data retensi penonton untuk playlist
  • Laporan estimasi pendapatan untuk pemilik konten (tersedia 2 laporan yang berbeda)
  • Laporan aset untuk pemilik konten (tersedia 11 laporan yang berbeda)
Dimensi unik grup (dimensi hanya filter)
benua (dimensi hanya filter)
subbenua (dimensi filter saja)
bulan
isCurated==1 (dimensi hanya filter)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Metrik unik unik
RelativeRetentionPerformance
penayanganPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impressions
card_teaser_click_rate
card_teaser_clicks
card_teaser_impressions
estimated_partner_adsense_revenue
estimated_partner_doubleclick_revenuesimpansimpan

Perbedaan penamaan antara API

Kedua API saat ini menggunakan konvensi penamaan yang berbeda untuk mengidentifikasi dimensi dan metrik. Saat ini, nama YouTube Analytics API menggunakan camelCase, sedangkan nama YouTube Reporting API menggunakan nama yang dipisahkan garis bawah.

Tabel berikut mengidentifikasi nama berbeda yang digunakan oleh kedua API untuk mengidentifikasi metrik dan dimensi yang sama. Dalam beberapa kasus, perbedaan antara kedua nama tersebut lebih dari yang akan Anda dapatkan setelah mengonversi nama dari camelCase menjadi garis bawah. Misalnya, dimensi video di YouTube Analytics API diberi nama video_id di YouTube Reporting API.

Dimensi

Nama YouTube Analytics API Nama YouTube Reporting API
adType jenis_iklan
ageGroup age_group [kelompok_usia]
aset asset_id
audienceType audience_retention_type
channel id_saluran
claimStatus status_diklaim
PemilikKonten id_pemilik_konten
country kode_negara
hari tanggal
JenisPerangkat jenis_perangkat
elapsedVideoTimeRatio persentase_waktu_video_lewat
gender gender
insightPlaybackLocationDetail detail_pemutaran_lokasi
insightPlaybackLocationType play__location_type
insightTrafficSourceDetail detail_sumber_traffic
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
Sistemoperasi sistem_operasi
playlist playlist_id
province kode_provinsi
berbagiLayanan layanan_sharding
subscribedStatus subscribe_status
subtitleBahasa subtitle_bahasa
uploaderType uploader_type
video id_video

Metrik

Nama YouTube Analytics API Nama YouTube Reporting API
Penghasilan iklan estimated_partner_ad_revenue
annotationImpression annotation_impressions
annotationClickableImpression annotation_clickable_impressions
annotationClicks annotation_klik
annotationClickThroughRate anotasi_klik_melalui_rasio
annotationClosableImpression annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate anotasi_tutup_rasio
AudienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
KartuKlikRate rasio_klik_kartu
cardKlik kartu_klik
CardImpression card_impressions
CardTeaserClickRate rasio_klik_teaser kartu
CardTeaserClicks klik_kartu_teaser
cardTeaserImpression kartu_teaser_tayangan
komentar komentar
tidak suka tidak suka
penghasilan estimated_partner_revenue
estimatedMinutesWatched digunakan watch_time_minutes
estimatedPartnerAdSenseRevenue estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue estimated_partner_doubleclick_revenue
Pendapatan kotor estimated_youtube_ad_revenue
impressionBasedCpm estimated_cpm
tayangan ad_impressions
suka suka
monetizationdPlaybacks estimated_monetizationd_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistMulai playlist_starts
savesDitambahkan playlist_saves_ditambahkan
savesDihapus playlist_saves_removed
membagikan membagikan
subscriber yang Diperoleh subscriber_yang diperoleh
subscribers Hilang subscribers_lost
videosMenambahToPlaylist videos_added_to_playlists
videosRemovedFromPlaylist videos_removed_from_playlist [video_dihapus_dari_playlist]
viewerPercentage views_Persentase
penayangan penayangan