Analyze Youtube Affiliate Performance (Alpha)

YouTube Satış Ortağı Programı'na katılan ürünlerinizle ilgili temel performans metriklerini almak için Reports API'yi kullanabilirsiniz. Bu kılavuzda, farklı içerik üreticiler, video içerikleri ve bireysel ürünlerle ilişkilendirilmiş satışlar, komisyonlar, siparişler, görüntülemeler ve tıklamalar gibi YouTube'a özel 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:

• API çağrılarının kimliğini doğrulamak için kullanılan hesapta, performans metriklerine erişim izni veren Performans ve analizler rolü olmalıdır.
• Google Merchant Center hesabınız YouTube Satış Ortağı Programı'na katılıyor olmalıdır.

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:

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

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

En çok etkileşim ve satış sağlayan YouTube içerik üreticilerini öğrenmek 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.

Aşağıda, 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ği verilmiştir.

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

Bu sorgu, belirtilen tarih aralığında brüt 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.

Performansı içeriğe göre görüntüleme

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 2025 ile 2 Mayıs 2025 arasında görüntüleme sayısına göre en iyi 3 videoyu almak için aşağıdaki Merchant Center Sorgu Dili ifadesini accounts.reports.search yöntemine iletin:

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

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 yan tümcelerini 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.