Analyze YouTube Affiliate Performance (Alpha)

Reports API'yi kullanarak YouTube İş Ortağı Programı'na katılan ürünlerinizle ilgili temel performans metriklerini alabilirsiniz. Bu kılavuzda, farklı içerik üreticilere, video içeriklerine ve tek tek ürünlere atfedilen satışlar, komisyonlar, siparişler, görüntülemeler ve tıklamalar gibi YouTube'a özgü satış ortağı verilerinin nasıl sorgulanacağı açıklanmaktadır.

MCQL'yi kullanarak, sorgularınızdaki tablolara benzer şekilde çalışan özel YouTube iş ortağı "görünümlerinden" metrik ve boyut seçebilirsiniz.

Ön koşullar

Bu kılavuzu kullanmadan önce şunlardan emin olun:

Alfa uç noktasını sorgulama

Bu özellik herkese açık alfa sürümünde olduğundan uç noktanın farklı olduğunu unutmayın. YouTube iş ortağı performans verilerini almak için POST isteğini v1alpha uç noktasına göndermeniz gerekir. Aşağıda örnek bir istek verilmiştir:

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

İçerik üreticiye göre performansı görme

En fazla etkileşim ve satış sağlayan YouTube içerik üreticilerini anlamak için youtube_creator_performance_view sorgusu gönderebilirsiniz. Bu görünüm, metrikleri tek tek YouTube içerik üreticilerine göre toplar ve içerik üreticilerin adlarını ve kanal kimliklerini içerir.

1 Mayıs ile 2 Mayıs 2025 tarihleri arasında satışlara göre en iyi performansı gösteren 3 içerik üreticiyi almak için kullanabileceğiniz bir MCQL SELECT ifadesi örneğini aşağıda bulabilirsiniz.

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

Bu sorgu, belirtilen tarih aralığında satış metriğine göre sıralanan ilk 3 içerik üreticinin içerik üretici başlığını, kanal kimliğini ve temel performans metriklerini getirir.

İçeriğe göre performansı görme

En iyi performansı gösteren YouTube videolarını görmek için youtube_content_performance_view sorgusunu kullanabilirsiniz. Bu görünüm, metrikleri tek tek YouTube videolarına göre toplar ve video başlıklarını ve kimliklerini içerir.

1 Mayıs ile 2 Mayıs 2025 tarihleri arasında görüntüleme sayısına göre en iyi 3 videoyu almak için kullanabileceğiniz bir MCQL SELECT ifadesi örneğini aşağıda bulabilirsiniz.

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

Bu sorgu, belirtilen tarih aralığında toplam views sayısına göre sıralanan ilk 3 videonun başlığını, video kimliğini ve temel metriklerini alır.

Ürüne göre performansı görme

YouTube satış ortağı programındaki ürünlerin performansını analiz etmek için youtube_product_performance_view sorgusu gönderebilirsiniz. Bu görünüm, metrikleri ürüne göre toplar ve ürün başlıkları ile teklif kimliklerini içerir.

1 Mayıs ile 2 Mayıs 2025 tarihleri arasında satış tutarına göre en çok satan 3 ürünü bulmak için kullanabileceğiniz bir MCQL SELECT ifadesi örneğini aşağıda bulabilirsiniz:

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

Bu sorgu, belirtilen dönemde sales metriğine göre sıralanmış ilk 3 ürünün ürün başlığını, teklif kimliğini ve performans metriklerini döndürür.

Dikkat edilecek önemli noktalar

  • Tarihler: Raporlama dönemini belirtmek için date sorgularınızı her zaman WHERE ifadelerini kullanarak filtreleyin. Tarihler YYYY-MM-DD biçimindedir.
  • Gecikme: Sorguların gecikmesi, istenen veri hacmine bağlıdır. Büyük sorgular daha uzun sürer ve zaman aşımına neden olabilir.