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.

Sorgularınızda tablolar gibi işlev gören özel YouTube İş Ortağı "görünümlerinden" metrik ve boyut seçmek için MCQL'yi kullanabilirsiniz.

Ö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 sorgusunu kullanabilirsiniz. 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 en çok görüntülenen ilk 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 video başlığını, video kimliğini ve temel metriklerini alır.

Dikkat edilecek önemli noktalar

  • Tarihler: Raporlama dönemini belirtmek için WHERE ifadelerini kullanarak sorgularınızı her zaman date ile 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.