Dokumen ini menjelaskan persamaan dan perbedaan cara YouTube Analytics API dan YouTube Reporting API memberikan akses ke data YouTube Analytics, sehingga Anda dapat memilih API yang tepat untuk aplikasi Anda.
Kedua API ini memungkinkan Anda mengambil data YouTube Analytics. Selain itu, kedua API mendukung pemilik channel YouTube dan pemilik konten YouTube, yang masing-masing dapat mengakses serangkaian laporan tertentu:
-
Laporan channel berisi metrik aktivitas pengguna untuk channel tertentu.
-
Laporan pemilik konten menggabungkan metrik untuk semua channel yang ditautkan ke pemilik konten YouTube tertentu. Misalnya, sebuah 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 laporan 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 diizinkan oleh pemilik channel atau konten yang memiliki data yang diminta.
Melaporkan 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 nilai dimensi setiap baris berfungsi sebagai kunci utama untuk baris tersebut.
-
Metrik adalah pengukuran individual aktivitas pengguna, performa iklan, atau estimasi pendapatan. Metrik aktivitas pengguna mencakup hal-hal seperti jumlah penayangan video dan rating (suka dan tidak suka).
Memilih API yang tepat untuk aplikasi Anda
- YouTube Analytics API
- YouTube Analytics API mendukung kueri bertarget real-time untuk membuat laporan YouTube Analytics kustom. API menyediakan parameter pemfilteran dan pengurutan, sehingga aplikasi panggilan tidak perlu mendukung fungsi ini secara native.
Setiap permintaan API menentukan rentang tanggal yang datanya 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 sebuah channel atau pemilik konten. API ini dirancang untuk aplikasi yang dapat mengimpor set data besar dan yang menyediakan alat untuk memfilter, mengurutkan, dan menggali data tersebut.
Setiap laporan berisi serangkaian kolom standar. Anda menggunakan API untuk menjadwalkan tugas pelaporan, yang masing-masing mengidentifikasi laporan yang harus dibuat 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 serangkaian 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 bertarget tersedia menggunakan YouTube Analytics API, dan laporan massal tersedia menggunakan 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 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 channel (query atau bulk) dan pemilik konten (query atau bulk). Laporan video memberikan statistik untuk semua aktivitas pengguna yang terkait dengan video 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 perkiraan pendapatan dan metrik performa iklan. |
| Laporan playlist | Didukung untuk channel (query atau bulk) dan pemilik konten (query atau bulk). Laporan playlist memberikan statistik yang secara khusus terkait dengan penayangan 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 iklan untuk iklan yang berjalan 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 pendapatan estimasi 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 aktual. |
| Laporan aset | Didukung untuk pemilik konten (massal). Laporan aset memberikan metrik aktivitas pengguna yang terkait dengan video yang ditautkan ke aset pemilik konten. Video disertakan dalam laporan pemilik konten jika pemilik konten telah mengklaim video tersebut sebagai kecocokan salah satu aset pemilik konten. Video tersebut dapat diupload oleh pemilik konten atau oleh pengguna YouTube lain. |
| Laporan yang dikelola sistem | Didukung untuk pemilik konten yang memiliki akses ke laporan terkait di menu Laporan Creator Studio YouTube. Laporan yang dikelola sistem menyediakan data pendapatan aktual yang diperoleh aset dan video. Laporan tambahan mencantumkan video yang diklaim dan aset yang cocok dengan video tersebut. Tidak semua laporan Creator Studio tersedia di API. Catatan: YouTube otomatis membuat laporan yang dikelola sistem untuk pemilik konten yang memiliki akses ke laporan terkait di Creator Studio. Akibatnya, proses pengambilan laporan ini berbeda dengan jenis laporan lainnya dalam daftar ini. Lihat dokumentasi untuk laporan yang dikelola sistem untuk mengetahui informasi selengkapnya. |
Perbedaan utama
Tabel berikut menjelaskan perbedaan penting antara YouTube Analytics API dan YouTube 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 data akan ditampilkan. | Aplikasi menjadwalkan tugas pelaporan. Untuk setiap tugas, YouTube membuat laporan harian yang dapat didownload secara asinkron. |
| Rentang Tanggal | Beberapa laporan API menentukan 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 menerapkan fitur untuk menggabungkan data untuk interval berkala. |
| Memfilter data | Anda dapat memfilter laporan agar hanya menyertakan baris yang memiliki nilai tertentu untuk dimensi. API ini juga mendukung beberapa dimensi, seperti continent dan subContinent, yang hanya digunakan sebagai filter. | API ini mendukung download massal set data lengkap. Tidak mendukung pemfilteran atau menampilkan data untuk dimensi hanya filter. Aplikasi klien menyimpan data yang didownload dan menerapkan fiturnya sendiri untuk memfilter data. |
| Pengurutan | Laporan dapat diurutkan berdasarkan nilai metrik yang ditampilkan. Beberapa laporan hanya mendukung sejumlah hasil yang terbatas. Misalnya, laporan yang mencantumkan video yang paling banyak ditonton di suatu channel menampilkan maksimal 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 di-enumerasi. | 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 |
|
|
| Dimensi unik | group (dimensi hanya filter) continent (dimensi hanya filter) subContinent (dimensi hanya filter) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Metrik unik | uniques relativeRetentionPerformance viewsPerPlaylistStart 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_revenue playlist_saves_added playlist_saves_removed |
Perbedaan penamaan antara API
Kedua API menggunakan konvensi penamaan yang berbeda untuk mengidentifikasi dimensi dan metrik. Nama YouTube Analytics API menggunakan camelCase, seperti adType. Nama YouTube Reporting API menggunakan huruf kecil dan garis bawah, seperti ad_type.
Tabel berikut mengidentifikasi berbagai nama yang digunakan kedua API untuk mengidentifikasi metrik dan dimensi yang sama. Dalam beberapa kasus, perbedaan antara kedua nama lebih dari yang akan Anda dapatkan setelah mengonversi nama dari camelCase ke garis bawah. Misalnya, dimensi video di YouTube Analytics API diberi nama video_id di YouTube Reporting API.