Menganalisis Performa Afiliasi YouTube (Alfa)

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 dikaitkan dengan berbagai kreator, konten video, produk individual, kategori produk, dan kampanye yang ditargetkan.

Penggunaan API Program Afiliasi YouTube dan data terkait harus mematuhi dengan 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 bahwa:

Membuat kueri endpoint alfa

Karena fitur ini berada 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 cara mengambil laporan, lihat accounts.reports.search. Berikut contoh permintaan:

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 interaksi dan penjualan terbanyak, Anda dapat membuat kueri youtube_creator_performance_view. Tampilan ini menggabungkan metrik menurut kreator YouTube individual dan mencakup judul kreator serta ID channel.

Berikut adalah 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 metrik untuk 3 kreator teratas yang diberi peringkat berdasarkan metrik penjualan bruto dalam rentang tanggal yang ditentukan.

Melihat performa menurut konten

Untuk melihat video YouTube tertentu yang memiliki performa terbaik, Anda dapat membuat kueri the youtube_content_performance_view. Tampilan ini menggabungkan metrik menurut video YouTube individual dan mencakup judul serta ID video. Untuk marketplace, sertakan account_id untuk mengelompokkan performa menurut akun sub-penjual individual. Untuk melihat jumlah komisi yang didanai oleh sub-penjual dan platform marketplace, sertakan seller_commissions dan platform_commissions.

Untuk mengambil 3 video teratas berdasarkan penayangan antara 1 Mei dan 2 Mei 2025, teruskan pernyataan MCQL berikut ke accounts.reports.search metode:

SELECT
  title,
  video_id,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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, ID akun sub-penjual (account_id), total komisi (commissions), komisi yang didanai penjual (seller_commissions), komisi yang didanai platform (platform_commissions), dan metrik utama lainnya untuk 3 video teratas yang diberi peringkat berdasarkan jumlah total views dalam rentang tanggal yang ditentukan. Catatan: Anda tidak dapat menggunakan account_id dalam klausa MCQL WHERE untuk memfilter hasil.

Melihat produk yang diberi tag dengan interaksi terbanyak

Untuk memahami produk yang diberi tag mana yang memiliki interaksi dan penjualan terbanyak, Anda dapat membuat kueri youtube_product_tagged_stats_view. Tampilan ini menggabungkan metrik menurut produk yang diberi tag individual, termasuk judul dan ID penawarannya.

Berikut adalah contoh pernyataan MCQL SELECT yang dapat Anda gunakan untuk mendapatkan 10 produk teratas berdasarkan penayangan antara 20 Januari 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 diberi peringkat berdasarkan jumlah total views dalam rentang tanggal yang ditentukan.

Melihat performa menurut kategori produk yang diberi tag

Untuk memahami kategori produk yang diberi tag mana yang mendorong interaksi dan penjualan terbanyak, buat kueri youtube_product_category_tagged_stats_view. Tampilan ini menggabungkan metrik menurut kategori produk (product_type) dalam taksonomi produk Anda, termasuk jumlah kreator dan video berbeda yang memberi tag pada produk di setiap kategori.

Gunakan pernyataan MCQL SELECT berikut untuk mendapatkan 10 kategori produk yang diberi tag teratas yang diberi peringkat berdasarkan penjualan bruto pada 1 September 2026:

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10
    

Kueri ini mengambil kategori produk (product_type), jumlah kreator yang memberi tag, jumlah video yang diberi tag, dan metrik performa utama untuk 10 kategori produk teratas yang diberi peringkat berdasarkan gross_sales pada 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 adalah contoh pernyataan MCQL SELECT yang dapat Anda gunakan untuk mendapatkan 10 produk teratas yang diberi peringkat berdasarkan penjualan bruto antara 20 Januari 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 bruto, dalam rentang tanggal yang ditentukan.

Melihat performa di semua kampanye

Untuk memahami performa kampanye afiliasi Anda secara keseluruhan, buat kueri the youtube_campaigns_stats_view. Tampilan ini menggabungkan metrik di semua kampanye, termasuk nama kampanye tanggal mulai dan berakhir, jumlah kreator aktif, serta metrik penjualan dan interaksi.

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 diberi peringkat berdasarkan jumlah total orders pada tanggal yang ditentukan.

Melihat performa kampanye menurut kreator

Untuk menganalisis performa kreator individual yang berpartisipasi dalam kampanye tertentu, buat 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 diberi peringkat berdasarkan total penayangan dalam kampanye dan tanggal yang ditentukan.

Melihat performa kampanye menurut video

Untuk melihat performa video kreator tertentu dalam kampanye, buat kueri the 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 diberi peringkat berdasarkan jumlah total views untuk channel kreator kampanye, dan tanggal yang ditentukan.

Melihat performa kampanye menurut produk

Untuk memahami performa produk individual dalam kampanye, buat 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 judul video, URL video, dan metrik performa utama untuk 10 produk teratas yang diberi peringkat berdasarkan jumlah total views dalam kampanye dan tanggal yang ditentukan.

Pertimbangan penting

  • Tanggal: Selalu filter kueri Anda menurut date menggunakan klausa WHERE untuk menentukan periode pelaporan. Tanggal dalam format YYYY-MM-DD.
  • Filter wajib: Beberapa tampilan kampanye memerlukan filter tambahan dalam klausa WHERE :
    • youtube_individual_campaign_stats_view: campaign_id dan date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id, dan date.
    • youtube_campaign_products_stats_view: campaign_id dan date.
  • 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.