YouTube satış ortağı performansını analiz etme (alfa)

Raporlama alt API'sini kullanarak YouTube İş Ortağı Programı'na katılan ürünlerinizle ilgili temel performans metriklerini alabilirsiniz. Bu kılavuzda, farklı içerik üreticilere, video içeriklerine, tek tek ürünlere ve hedeflenen kampanyalara 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.

YouTube Satış Ortağı Programı API'lerini ve ilişkili verileri kullanımınız YouTube Alışveriş geliştirici politikalarına uygun olmalıdı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:

Alfa uç noktasını sorgulama

Bu özellik herkese açık alfa sürümünde olduğundan uç nokta farklıdır. YouTube iş ortağı performans verilerini almak için POST isteğini v1alpha uç noktasına göndermeniz gerekir. Raporları alma hakkında daha fazla bilgi için accounts.reports.search sayfasına bakın. Örnek bir istek:

HTTP

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

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --compressed

Performansı içerik üreticiye göre görüntüleme

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 üretici başlıkları ile 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.

İç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 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

En fazla etkileşim ve satış sağlayan etiketli ürünleri öğrenmek için youtube_product_tagged_stats_view sorgusunu kullanabilirsiniz. Bu görünüm, başlıkları ve teklif kimlikleri de dahil olmak üzere metrikleri tek tek etiketlenmiş ürünlere göre toplar.

ifadesiyle 20-21 Ocak 2026 tarihleri arasında en çok görüntülenen 10 ürünü almak 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ı, etiketlenmiş video sayısını ve temel metriklerini alır.

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

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

SELECT 20-21 Ocak 2026 tarihleri arasında brüt satışa göre sıralanan ilk 10 ürünü almak için kullanabileceğiniz bir MCQL ifadesi ö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.

Tüm kampanyalardaki performansı görme

Satış ortağı kampanyalarınızın genel olarak nasıl performans gösterdiğini anlamak için youtube_campaigns_stats_view sorgusunu gönderin. Bu görünüm, kampanya adları, başlangıç ve bitiş tarihleri, etkin içerik üretici sayıları, satış ve etkileşim metrikleri dahil olmak üzere tüm kampanyalardaki metrikleri toplar.

23 Nisan 2026'da sipariş sayısına göre en iyi performans gösteren 10 kampanyayı almak için aşağıdaki MCQL SELECT ifadesini kullanın: 

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10

Bu sorgu, belirtilen tarihte toplam orders sayısına göre sıralanan ilk 10 kampanyanın kampanya kimliğini, kampanya adını, tarih aralığını, etkin içerik üretici sayısını ve temel performans metriklerini alır.

Kampanya performansını içerik üreticiye göre görüntüleme

Belirli bir kampanyaya katılan bireysel içerik üreticilerin performansını analiz etmek için youtube_individual_campaign_stats_view sorgusunu gönderin. Bu görünümde, kanal başlıkları, video sayıları ve etiketlenmiş ürün başlıkları da dahil olmak üzere bir kampanyadaki içerik üretici başına metrikler toplanır.

23 Nisan 2026'da belirli bir kampanyada görüntüleme sayısına göre en iyi 10 içerik üreticiyi almak için aşağıdaki MCQL SELECT ifadesini kullanın: 

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Bu sorgu, belirtilen kampanya ve tarihte toplam görüntüleme sayısına göre sıralanan ilk 10 içerik üreticinin içerik üretici kanalı başlığını, video sayısını, ürün başlıklarını ve temel performans metriklerini alır.

Kampanya performansını videoya göre görüntüleme

Belirli içerik üretici videolarının bir kampanya içindeki performansını görmek için youtube_campaign_videos_stats_view sorgusunu gönderin. Bu görünümde, bir kampanyadaki içerik üreticinin video düzeyindeki performans metrikleri (video başlıkları, video biçimleri ve etiketlenmiş ürünler dahil) gösterilir.

SELECT ifadesini kullanarak 20 Mayıs 2026'da belirli bir içerik üretici ve kampanyanın görüntüleme sayısına göre en iyi 10 videosunu alın: 

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10

Bu sorgu, belirtilen içerik üreticinin kanalı, kampanyası ve tarihi için toplam views sayısına göre sıralanan ilk 10 videonun video başlığını, video biçimini (content_type), etiketlenmiş ürün başlıklarını ve temel performans metriklerini alır.

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

Bir kampanyadaki tek tek ürünlerin nasıl performans gösterdiğini anlamak için youtube_campaign_products_stats_view sorgusunu gönderin. Bu görünüm, ürün başlıkları, ilişkili video ayrıntıları ve satış metrikleri dahil olmak üzere bir kampanyadaki ürün düzeyinde performans metriklerini sağlar.

20 Haziran 2026'da belirli bir kampanyadaki en çok görüntülenen 10 ürünü almak için aşağıdaki MCQL SELECT ifadesini kullanın: 

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Bu sorgu, belirtilen kampanya ve tarihte toplam views sayısına göre sıralanan ilk 10 ürün için içerik üreticinin kanal başlığını, ürün başlığını, video başlığını, video URL'sini ve temel performans 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.
  • Zorunlu filtreler: Bazı kampanya görünümleri, WHERE ifadesinde ek filtreler gerektirir:
    • youtube_individual_campaign_stats_view: campaign_id ve date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id ve date.
    • youtube_campaign_products_stats_view: campaign_id ve date.
  • 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.
Önceki
Explore your competitive landscape
Sonraki
Use Merchant Center Query Language