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:
- 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ç 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 başlıklı makaleyi inceleyin.
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örme
En çok etkileşim ve satış sağlayan YouTube içerik üreticilerini öğrenmek için youtube_creator_performance_view sorgusunu kullanabilirsiniz.
Bu görünüm, metrikleri tek tek YouTube içerik üreticilerine göre toplar ve içerik üreticilerin başlıklarını ve kanal kimliklerini içerir.
SELECT 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 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 arasındaki 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, 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ışa sahip 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.
SELECT ifadesi örneğini kullanarak 20-21 Ocak 2026 tarihleri arasında en çok görüntülenen 10 ürünü elde edebilirsiniz:
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ı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.
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ı ile 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 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.
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 ü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.
Kampanya performansını ürüne göre görüntüleme
Bir kampanyadaki her ürünün nasıl performans gösterdiğini anlamak için youtube_campaign_products_stats_view sorgusunu gönderin.
Bu görünüm, bir kampanya içindeki ürün düzeyinde performans metriklerini (ürün başlıkları, ilişkili video ayrıntıları ve satış metrikleri dahil) sağlar.
20 Haziran 2026'da belirli bir kampanyanın en çok görüntülenen 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 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
WHEREifadelerini kullanarak sorgularınızı her zamandateile filtreleyin. TarihlerYYYY-MM-DDbiçimindedir. - Zorunlu filtreler: Bazı kampanya görünümleri,
WHEREifadesinde ek filtreler gerektirir:youtube_individual_campaign_stats_view:campaign_idvedateyoutube_campaign_videos_stats_view:campaign_id,channel_idvedate.youtube_campaign_products_stats_view:campaign_idvedate
- 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.