Analyze Youtube Affiliate Performance (Alpha)

YouTube Satış Ortağı Programı'na katılan ürünlerinizle ilgili temel performans metriklerini, Reporting alt API'sini kullanarak alabilirsiniz. Bu kılavuzda, farklı içerik üreticiler, video içerikleri ve tek tek ürünlerle ilişkilendirilen 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.

Sorgularınızda tablolar gibi işlev gören özel YouTube iş ortağı görünümlerinden metrik ve boyut seçmek için Merchant Center Sorgu Dili'ni (MCQL) kullanabilirsiniz.

Ö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 sağlayan 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.

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,
  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 tarihleri arasında en çok görüntülenen ilk 3 videoyu almak için aşağıdaki MCQL 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.

En çok etkileşim alan etiketli ürünleri görme

Hangi etiketli ürünlerin en çok etkileşim ve satış aldığını anlamak için youtube_product_tagged_stats_view sorgusunu kullanabilirsiniz. Bu görünüm, başlıkları ve teklif kimlikleri de dahil olmak üzere tek tek etiketlenmiş ürünlere göre metrikleri toplar.

SELECT ifadesiyle, 20-21 Ocak 2026 tarihleri arasında görüntüleme sayısına göre ilk 10 ürünü elde etmek için kullanabileceğiniz bir MCQL SELECT ifadesi örneğini aşağıda bulabilirsiniz:

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

Bu sorgu, belirtilen tarih aralığında toplam views sayısına göre sıralanan ilk 10 ürünün başlıklarını, etiketlenen video sayısını ve temel metriklerini alır.

En çok satılan ürünleri görme

En çok satılan ürünleri öğrenmek için youtube_product_sold_stats_view sorgusunu kullanabilirsiniz.

SELECT ifadesiyle, 20-21 Ocak 2026 tarihleri arasında brüt satışa göre sıralanan ilk 10 ürünü elde etmek için kullanabileceğiniz bir MCQL örneğini aşağıda bulabilirsiniz:

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

Bu sorgu, belirtilen tarih aralığında brüt satışa göre sıralanan ilk 10 ürünün satış verilerini, komisyonlarını 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 veri kümelerini kapsayan sorgular daha uzun sürer ve zaman aşımına neden olabilir.