Anda dapat mengambil metrik performa utama untuk produk yang berpartisipasi dalam Program Afiliasi YouTube menggunakan Reports API. Panduan ini menjelaskan cara membuat kueri data afiliasi khusus YouTube, seperti penjualan, komisi, pesanan, penayangan, dan klik, yang diatribusikan ke berbagai kreator, konten video, dan produk individual.
Anda dapat menggunakan MCQL untuk memilih metrik dan dimensi dari "penayangan" Afiliasi YouTube khusus, yang berfungsi seperti tabel dalam kueri Anda.
Prasyarat
Sebelum menggunakan panduan ini, pastikan:
- Akun yang digunakan untuk mengautentikasi panggilan API memiliki peran Performa dan insight yang memberikan akses ke metrik performa.
- Akun Google Merchant Center Anda berpartisipasi dalam Program Afiliasi YouTube.
Membuat kueri endpoint alfa
Perhatikan bahwa karena masih dalam versi alfa publik, endpointnya berbeda. Untuk mengambil
data performa Afiliasi YouTube, Anda perlu mengirim permintaan POST ke
endpoint v1alpha
.
Berikut contoh permintaannya:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
Melihat performa menurut kreator
Untuk memahami kreator YouTube mana yang mendorong engagement dan penjualan terbanyak, Anda dapat membuat kueri youtube_creator_performance_view
.
Tampilan ini menggabungkan metrik menurut masing-masing kreator YouTube dan mencakup judul kreator dan ID channel.
Berikut contoh pernyataan SELECT MCQL yang dapat Anda gunakan untuk mendapatkan 3 kreator dengan performa terbaik berdasarkan penjualan antara 1 Mei dan 2 Mei 2025.
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
Kueri ini mengambil judul kreator, ID channel, dan metrik performa utama untuk 3 kreator teratas yang diurutkan berdasarkan metrik penjualan dalam rentang tanggal yang ditentukan.
Melihat performa menurut konten
Untuk melihat video YouTube tertentu yang memiliki performa terbaik, Anda dapat membuat kueri
youtube_content_performance_view
.
Tampilan ini menggabungkan metrik menurut masing-masing video YouTube dan mencakup judul serta ID video.
Berikut contoh pernyataan SELECT MCQL yang dapat Anda gunakan untuk mendapatkan 3 video teratas berdasarkan penayangan antara 1 Mei dan 2 Mei 2025.
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
Kueri ini mengambil judul video, ID video, dan metrik utama untuk 3 video teratas yang diurutkan berdasarkan jumlah total views
dalam rentang tanggal yang ditentukan.
Melihat performa menurut produk
Untuk menganalisis performa setiap produk dalam Program Afiliasi YouTube, Anda dapat membuat kueri youtube_product_performance_view
.
Tampilan ini menggabungkan metrik menurut produk dan menyertakan judul produk dan ID penawaran.
Berikut adalah contoh pernyataan SELECT MCQL yang dapat Anda gunakan untuk menemukan 3 produk teratas berdasarkan jumlah penjualan antara 1 Mei dan 2 Mei 2025:
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
Kueri ini menampilkan judul produk, ID penawaran, dan metrik performa untuk
3 produk teratas, yang diurutkan berdasarkan metrik sales
, selama periode yang ditentukan.
Pertimbangan penting
- Tanggal: Selalu filter kueri Anda menurut
date
menggunakan klausaWHERE
untuk menentukan periode pelaporan. Tanggal dalam formatYYYY-MM-DD
. - Latensi: Latensi kueri akan bergantung pada volume data yang diminta. Kueri besar akan membutuhkan waktu lebih lama dan dapat menyebabkan waktu tunggu habis.