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

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

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 Satış 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. Aşağıda örnek bir istek verilmiştir:

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

İçerik üreticiye göre performansı görüntüleme

En çok etkileşim ve satış sağlayan YouTube içerik üreticilerini anlamak için youtube_creator_performance_view tablosunu sorgulayabilirsiniz. Bu görünüm, metrikleri her bir YouTube içerik üreticisine 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 en iyi 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. Pazar yerleri için, performansı bireysel alt satıcı hesaplarına göre ayırmak üzere account_id öğesini ekleyin. Alt satıcılar ve pazar yeri platformu tarafından finanse edilen komisyon tutarlarını görüntülemek için seller_commissions ve platform_commissions sütunlarını ekleyin.

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,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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 en iyi 3 videonun video başlığını, video kimliğini, alt satıcı hesap kimliğini (account_id), toplam komisyonları (commissions), satıcı tarafından finanse edilen komisyonları (seller_commissions), platform tarafından finanse edilen komisyonları (platform_commissions) ve diğer önemli metrikleri alır. Not: Sonuçları filtrelemek için MCQL WHERE yan tümcesinde account_id kullanamazsınız.

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

Etiketlenen ürünlerden hangilerinin en fazla etkileşim ve satış sağladığını anlamak için youtube_product_tagged_stats_view sorgusu yapabilirsiniz. Bu görünüm, başlıkları ve teklif numaraları da dahil olmak üzere etiketlenmiş ürünlere göre metrikleri birleştirir.

20 ve 21 Ocak 2026 tarihleri arasında görüntüleme sayısına göre en popüler 10 ürünü almak için kullanabileceğiniz bir MCQL SELECT ifadesi örneği: 

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.

Etiketlenmiş ürün kategorisine göre performansı inceleme

Hangi etiketli ürün kategorilerinin en fazla etkileşim ve satış sağladığını anlamak için youtube_product_category_tagged_stats_view sorgusunu kullanın. Bu görünüm, ürün sınıflandırmanızdaki ürün kategorisine (product_type) göre metrikleri toplar. Bu metrikler arasında, her kategorideki ürünleri etiketleyen farklı içerik üreticilerin ve videoların sayısı da yer alır.

1 Eylül 2026'da brüt satışlara göre sıralanan en popüler 10 etiketli ürün kategorisini almak için aşağıdaki MCQL SELECT ifadesini kullanın: 

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10

Bu sorgu, belirtilen tarihte gross_sales ölçütüne göre sıralanan ilk 10 ürün kategorisi için ürün kategorisini (product_type), etiketlenen içerik üretici sayısını, etiketlenen video sayısını ve temel performans metriklerini alır.

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

En çok satış yapan ürünleri öğrenmek için youtube_product_sold_stats_view tablosunu sorgulayabilirsiniz.

20 ve 21 Ocak 2026 tarihleri arasında brüt satışlara göre sıralanan en iyi 10 ürünü almak için kullanabileceğiniz bir MCQL SELECT ifadesi örneği: 

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 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 tarihteki toplam orders sayısına göre sıralanan ilk 10 kampanyanın kampanya kimliğini, kampanya adını, tarih aralığını, aktif 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 içerik üreticilerin performansını ayrı ayrı analiz etmek için youtube_individual_campaign_stats_view raporunu sorgulayın. 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 kampanya için görüntüleme sayısına göre en popüler 10 içerik üreticiyi almak üzere 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 üretici için 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 kullanın. Bu görünüm, bir kampanyadaki içerik üretici için video düzeyinde performans metrikleri (video başlıkları, video biçimleri ve etiketli ürünler dahil) sağlar.

20 Mayıs 2026'da belirli bir içerik üretici ve kampanya için görüntüleme sayısına göre en iyi 10 videoyu almak üzere aşağıdaki MCQL SELECT ifadesini kullanı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 üretici kanalı, kampanya ve tarih için toplam views sayısına göre sıralanan ilk 10 videonun video başlığını, video biçimini (content_type), etiketlenen ürün başlıklarını ve temel performans metriklerini alır.

Kampanya performansını ürüne göre 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, bir kampanyadaki ürün düzeyinde performans metriklerini (ör. ürün başlıkları, ilişkili video ayrıntıları ve satış metrikleri) gösterir.

20 Haziran 2026'da belirli bir kampanyanın görüntüleme sayısına göre en iyi 10 ürünü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 tarih içinde toplam views sayısına göre sıralanan en iyi 10 ürün için içerik üretici 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
Analyze UCP agentic performance (Alpha)