Analyze Youtube Affiliate Performance (Alpha)

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, dan produk individual.

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:

• 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 endpointnya berbeda karena masih dalam versi alfa publik. Untuk mengambil data performa Afiliasi YouTube, Anda harus mengirim permintaan POST ke endpoint v1alpha. Berikut adalah contoh permintaan:

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

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

Melihat performa menurut konten

Untuk melihat video YouTube tertentu mana yang memiliki performa terbaik, Anda dapat membuat kueri youtube_content_performance_view. Tampilan ini menggabungkan metrik menurut video YouTube individual dan mencakup judul serta ID video.

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,
  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 engagement terbanyak

Untuk memahami produk yang diberi tag mana yang memiliki engagement 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 diurutkan berdasarkan jumlah total views dalam rentang tanggal yang ditentukan.

Melihat produk terlaris

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 diurutkan 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.

Pertimbangan penting

• Tanggal: Selalu filter kueri Anda menurut date menggunakan klausa WHERE untuk menentukan periode pelaporan. Tanggal dalam format YYYY-MM-DD.
• 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.