Anda dapat mengambil metrik performa utama untuk produk yang berpartisipasi dalam Program Afiliasi YouTube menggunakan sub-API Pelaporan. Panduan ini menjelaskan cara membuat kueri data afiliasi khusus YouTube, seperti penjualan, komisi, pesanan, penayangan, dan klik, yang diatribusikan ke berbagai kreator, konten video, produk individual, dan kampanye yang ditargetkan.
Penggunaan API Program Afiliasi YouTube dan data terkait oleh Anda harus mematuhi kebijakan developer YouTube Shopping.
Anda dapat menggunakan Bahasa Kueri Merchant Center (MCQL) untuk memilih metrik dan dimensi dari tampilan 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
Karena fitur ini dalam versi alfa publik, endpointnya berbeda. Untuk mengambil
data performa Afiliasi YouTube, Anda harus mengirim permintaan POST ke
endpoint v1alpha. Untuk mengetahui informasi selengkapnya tentang pengambilan laporan, lihat
accounts.reports.search.
Berikut contoh permintaannya:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
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' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--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 MCQL SELECT yang dapat Anda gunakan untuk mendapatkan
3 kreator dengan performa terbaik berdasarkan penjualan antara 1 Mei dan 2 Mei 2025:
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
Kueri ini mengambil judul kreator, ID channel, dan metrik performa utama untuk 3 kreator teratas yang diurutkan berdasarkan metrik penjualan kotor 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 setiap video YouTube dan mencakup
judul dan ID video.
Untuk mengambil 3 video teratas berdasarkan penayangan antara 1 Mei dan 2 Mei 2025,
teruskan pernyataan MCQL berikut ke metode
accounts.reports.search:
SELECT title, video_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '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 produk yang diberi tag dengan interaksi terbanyak
Untuk memahami produk bertag mana yang memiliki interaksi dan penjualan terbanyak,
Anda dapat membuat kueri
youtube_product_tagged_stats_view.
Tampilan ini menggabungkan metrik menurut masing-masing produk yang diberi tag, termasuk
judul dan ID penawarannya.
Berikut contoh pernyataan MCQL SELECT yang dapat Anda gunakan untuk mendapatkan
10 produk teratas berdasarkan penayangan antara 20 dan 21 Januari 2026:
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
Kueri ini mengambil judul, jumlah video yang diberi tag, dan metrik utama untuk
10 produk teratas yang diurutkan berdasarkan jumlah total views dalam
rentang tanggal yang ditentukan.
Melihat produk yang paling banyak terjual
Untuk memahami produk mana yang memiliki penjualan terbanyak, Anda dapat membuat kueri
youtube_product_sold_stats_view.
Berikut contoh pernyataan MCQL SELECT yang dapat Anda gunakan untuk mendapatkan
10 produk teratas yang diurutkan berdasarkan penjualan kotor antara 20 dan 21 Januari 2026:
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
Kueri ini mengambil data penjualan, komisi, dan metrik utama untuk 10 produk teratas yang diurutkan berdasarkan penjualan kotor, dalam rentang tanggal yang ditentukan.
Melihat performa di semua kampanye
Untuk memahami performa kampanye afiliasi Anda secara keseluruhan, kueri
youtube_campaigns_stats_view.
Tampilan ini menggabungkan metrik di semua kampanye, termasuk nama kampanye, tanggal mulai dan akhir, jumlah kreator aktif, serta metrik penjualan dan engagement.
Gunakan pernyataan MCQL SELECT berikut untuk mendapatkan 10
kampanye teratas berdasarkan pesanan pada 23 April 2026:
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
Kueri ini mengambil ID kampanye, nama kampanye, rentang tanggal, jumlah
kreator aktif, dan metrik performa utama untuk 10 kampanye teratas
yang diurutkan berdasarkan jumlah total orders pada tanggal yang ditentukan.
Melihat performa kampanye menurut kreator
Untuk menganalisis performa masing-masing kreator yang berpartisipasi dalam kampanye tertentu, kueri
youtube_individual_campaign_stats_view.
Tampilan ini menggabungkan metrik per kreator dalam kampanye, termasuk
judul channel, jumlah video, dan judul produk yang diberi tag.
Gunakan pernyataan MCQL SELECT berikut untuk mendapatkan 10
kreator teratas berdasarkan penayangan untuk kampanye tertentu pada 23 April 2026:
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Kueri ini mengambil judul channel kreator, jumlah video, judul produk, dan metrik performa utama untuk 10 kreator teratas yang diurutkan berdasarkan total penayangan dalam kampanye dan tanggal yang ditentukan.
Melihat performa kampanye menurut video
Untuk melihat performa video kreator tertentu dalam kampanye, kueri
youtube_campaign_videos_stats_view.
Tampilan ini memberikan metrik performa tingkat video untuk kreator dalam kampanye, termasuk judul video, format video, dan produk yang diberi tag.
Gunakan pernyataan MCQL SELECT berikut untuk mendapatkan 10 video teratas
berdasarkan penayangan untuk kreator dan kampanye tertentu pada 20 Mei 2026:
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
Kueri ini mengambil judul video, format video (content_type),
judul produk yang diberi tag, dan metrik performa utama untuk 10 video teratas
yang diurutkan berdasarkan jumlah total views untuk channel, kampanye, dan tanggal
kreator yang ditentukan.
Melihat performa kampanye menurut produk
Untuk memahami performa setiap produk dalam kampanye,
jalankan kueri
youtube_campaign_products_stats_view.
Tampilan ini memberikan metrik performa tingkat produk dalam kampanye,
termasuk judul produk, detail video terkait, dan metrik penjualan.
Gunakan pernyataan MCQL SELECT berikut untuk mendapatkan 10
produk teratas berdasarkan penayangan untuk kampanye tertentu pada 20 Juni 2026:
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
Kueri ini mengambil judul channel kreator, judul produk, judul video, URL video, dan metrik performa utama untuk 10 produk teratas yang diurutkan berdasarkan jumlah total views dalam kampanye dan tanggal yang ditentukan.
Pertimbangan penting
- Tanggal: Selalu filter kueri Anda menurut
datemenggunakan klausaWHEREuntuk menentukan periode pelaporan. Tanggal dalam formatYYYY-MM-DD. - Filter wajib: Beberapa tampilan kampanye memerlukan filter tambahan dalam klausa
WHERE:youtube_individual_campaign_stats_view:campaign_iddandate.youtube_campaign_videos_stats_view:campaign_id,channel_id, dandate.youtube_campaign_products_stats_view:campaign_iddandate.
- Latensi: Latensi kueri bergantung pada volume data yang diminta. Kueri yang mencakup set data besar memerlukan waktu lebih lama dan dapat menyebabkan waktu tunggu habis.