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 hedef 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 tablo işlevi gören özel YouTube Satış 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 hesap, performans metriklerine erişim sağlayan Performans ve analizler rolüne sahiptir.
- Google Merchant Center hesabınız YouTube Satış Ortağı Programı'na katılıyor.
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 öğrenmek için youtube_creator_performance_view raporunu 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 ve 2 Mayıs 2025 tarihleri arasında satışlara göre en iyi performans gösteren 3 içerik üreticiyi öğrenmek için kullanabileceğiniz bir MCQL SELECT ifadesi örneği:
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 tablosunu sorgulayabilirsiniz.
Bu görünüm, metrikleri her bir YouTube videosuna göre toplar ve video başlıkları ile kimliklerini içerir. Pazar yerleri için performansı alt satıcı hesaplarına göre dökümünü yapmak üzere account_id 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 ve 2 Mayıs 2025 tarihleri arasında görüntüleme sayısına göre en iyi 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; 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 belirtilen tarih aralığında toplam views sayısına göre sıralanan en iyi 3 videonun diğer
temel metriklerini 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 tablosunu sorgulayabilirsiniz.
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ğ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ı, etiketli video sayısını ve temel metriklerini alır.
Etiketlenmiş ürün kategorisine göre performansı görme
Etiketlenen ürün kategorilerinden hangilerinin en çok etkileşim ve satış sağladığını öğrenmek için youtube_product_category_tagged_stats_view raporunu sorgulayın.
Bu görünüm, her kategorideki ürünleri etiketleyen farklı içerik üreticilerin ve videoların sayısı da dahil olmak üzere ürün sınıflandırmanızdaki ürün kategorisine (product_type) göre metrikleri toplar.
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 değerine 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öster
En çok hangi ürünlerin satıldığını anlamak 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ışlara göre sıralanan en iyi 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 performansını anlamak için youtube_campaigns_stats_view raporunu sorgulayın.
Bu görünüm; kampanya adları, başlangıç ve bitiş tarihleri, aktif içerik üretici sayıları, satış ve etkileşim metrikleri dahil olmak üzere tüm kampanyalardaki metrikleri birleştirir.
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 tarihte toplam orders sayısına göre sıralanan en iyi 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örme
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üm, bir kampanya içindeki içerik üretici başına metrikleri (kanal başlıkları, video sayıları ve etiketli ürün başlıkları dahil) birleştirir.
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örme
Belirli içerik üretici videolarının bir kampanyada nasıl performans gösterdiğini öğrenmek için youtube_campaign_videos_stats_view raporunu sorgulayın.
Bu görünüm, bir kampanyadaki içerik üretici için video düzeyinde performans metrikleri sağlar. Bu metrikler arasında video başlıkları, video biçimleri ve etiketli ürünler yer alır.
Belirli bir içerik üretici ve kampanya için 20 Mayıs 2026 tarihinde 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 her ürünün nasıl performans gösterdiğini anlamak için youtube_campaign_products_stats_view raporunu sorgulayın.
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 aralığında 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 her zaman
WHEREyan tümcelerini kullanarak sorgularınızıdateile filtreleyin. TarihlerYYYY-MM-DDbiçimindedir. - Zorunlu filtreler: Bazı kampanya görünümleri,
WHEREifadesinde ek filtreler gerektirir:youtube_individual_campaign_stats_view:campaign_idvedate.youtube_campaign_videos_stats_view:campaign_id,channel_idvedate.youtube_campaign_products_stats_view:campaign_idvedate.
- Gecikme: Sorguların gecikmesi, istenen verilerin hacmine bağlıdır. Büyük veri kümelerini kapsayan sorgular daha uzun sürer ve zaman aşımına neden olabilir.