Google, Campaign Manager 360 API'ye rapor verisini tek senkron istekte döndüren reportData.query uç noktasını ekledi. Geliştiriciler boyut, metrik ve filtreleri istek gövdesinde tanımlayıp yapılandırılmış JSON yanıtı alabiliyor. Önce rapor kaynağı oluşturma, çalıştırma, durumunu sorgulama ve dosya indirme adımları zorunlu değil.
Bu değişiklik medya performansını otomatik karar sistemlerine bağlayan ajanslar ve kurumsal ekipler için anlamlı. Etkileşimli pano, kampanya sağlık kontrolü veya destek aracında birkaç soruya hızlı yanıt vermek kolaylaşıyor. Ancak yeni uç nokta eski Reports servisini kaldırmıyor. Büyük veri setleri, zamanlanmış işler ve CSV ya da Excel çıktısı gereken akışlar için geleneksel raporlama hâlâ öneriliyor.
Yeni uç nokta nasıl çalışıyor?
reportData.query, Campaign Manager 360 raporlama verisini senkron biçimde sorguluyor. İstek içinde tarih aralığı, boyutlar, metrikler, filtreler, sıralama ve sayfalama bilgileri tanımlanabiliyor. Yanıt indirilebilir dosya yerine JSON olarak geliyor. Uygulama bu veriyi doğrudan tabloya, uyarıya veya analitik katmana dönüştürebiliyor.
En belirgin fark rapor kaynağı yaşam döngüsünün ortadan kalkması. Geleneksel akışta önce rapor yapılandırması oluşturulur, iş başlatılır, tamamlanma durumu periyodik olarak kontrol edilir ve sonuç dosyası indirilir. Yeni akışta uygun sorgu tek istek ve yanıt döngüsünde tamamlanır.
Sorgu en fazla 60 saniye çalışabiliyor. Bu sınır yeni yöntemin “bütün veriyi her seferinde çek” yaklaşımı olmadığını gösteriyor. Uygun kullanım, kontrollü tarih aralığı ve belirli boyutlarla hızlı cevap üretmek. Çok geniş reklamveren, kampanya, yaratıcı ve günlük kırılım aynı sorguya doldurulursa zaman aşımı veya sayfalama yükü oluşabilir.
Bu metinsiz Fark Studio şeması tek istekli senkron sorgu ile rapor oluşturma, bekleme ve dosya indirme yolunu karşılaştırır. Gerçek API konsolu değildir.
Kimleri etkiliyor?
Campaign Manager 360'ı kaynak olarak kullanan ajans mühendisliği ekipleri, pazarlama veri ekipleri, BI geliştiricileri, medya operasyonları ve kurumsal reklamverenler doğrudan etkileniyor. Yalnızca Google Ads arayüzünde çalışan küçük ekipler için değişiklik sınırlı olabilir. Bu bir kampanya optimizasyon ayarı değil, veri erişim altyapısı güncellemesi.
Bir ajans müşteri panelinde son 24 saatin teslimatını göstermek, planlanan ile gerçekleşeni karşılaştırmak veya belirli bir yaratıcıdaki anormalliği hızla sorgulamak istiyorsa yeni yol daha az operasyonel adım gerektirir. Destek ekibi de önceden hazırlanmış dosyayı beklemek yerine dar kapsamlı bir sorguyla sorunu inceleyebilir.
Türkiye'deki büyük reklamverenler ve bölgesel ajanslar için uygulanabilirlik, mevcut CM360 kullanımına bağlı. Platformu kullanmayan marka için yalnızca haber değeri taşır. CM360 verisini veri ambarına alan kuruluşta ise entegrasyon maliyetini ve pano gecikmesini azaltabilir.
Yeni yöntem eski raporlamanın yerine geçiyor mu?
Hayır. Google'ın resmî dokümanı Reports servisini büyük veri setleri, zamanlanmış raporlar ve indirilebilir CSV veya Excel dosyaları gereken sistemler için öneriyor. reportData.query etkileşimli ve dar sorgular için daha uygundur. İki yöntemin bir arada kullanılması beklenir.
Örneğin gece bütün hesapların önceki gün verisini arşive yazan ETL işi klasik rapor yolunda kalabilir. Buna karşılık kullanıcı panelde tarih filtresini değiştirdiğinde açılan özet, yeni uç noktaya gidebilir. Birini diğerine zorla dönüştürmek yerine gecikme, veri hacmi, tekrar sıklığı ve çıktı biçimi ölçülmeli.
Bu Fark Studio karar görseli küçük ve hızlı sorguları etkileşimli panoya, büyük ve zamanlanmış veri yüklerini dosya arşivine yönlendirir. Resmî mimari şema değildir.
Kesinleşen ve belirsiz noktalar
Kesinleşenler: uç nokta Campaign Manager 360 API v5 içinde mevcut; senkron JSON yanıtı sağlıyor; rapor kaynağı oluşturmayı gerektirmiyor; 60 saniyelik çalışma sınırı var; geleneksel Reports servisi desteklenmeye devam ediyor.
Belirsiz olan, her mevcut entegrasyonda sağlayacağı gerçek hız ve maliyet kazancı. Sonuç sorgu genişliğine, hesap yapısına, kota kullanımına, ağ gecikmesine ve uygulamanın önbellek stratejisine bağlı. Google her pano için garanti edilen yanıt süresi veya maliyet düşüşü yayımlamıyor.
Veri eşitliği de test edilmeli. Eski dosya raporu ile yeni JSON sorgusunda tarih, saat dilimi, filtre, dönüşüm tanımı ve boyut kapsamı aynı değilse farklı sonuç görmek normaldir. Bu fark yeni uç noktanın hatası olarak yorumlanmamalı.
Türkiye'deki ekipler şimdi ne yapmalı?
1. Mevcut CM360 rapor işlerini etkileşimli, zamanlanmış ve arşiv amaçlı olarak sınıflandırın. 2. Yüksek gecikme yaşayan fakat dar veri döndüren üç sorguyu pilot için seçin. 3. Eski ve yeni yöntem için tarih, saat dilimi, filtre, boyut ve metrik sözlüğünü birebir eşitleyin. 4. Sonuç satır sayısı, toplamlar, null değerler ve sayfalama davranışı için otomatik karşılaştırma testi yazın. 5. 60 saniye sınırına yaklaşan sorguları daha küçük tarih veya hesap parçalarına bölün. 6. Kota, hata, gecikme ve yeniden deneme ölçümlerini gözlemlenebilir hâle getirin. 7. Etkileşimli kullanıcı sorgularına kısa önbellek, arşiv işlerine kalıcı depolama politikası uygulayın. 8. Eski Reports akışını pilot bitmeden kapatmayın. Geri dönüş yolu korunsun. 9. Pano üzerindeki “son güncelleme” zamanını açık gösterin. Gerçek zaman ifadesini sıfır gecikme vaadine dönüştürmeyin.
Nerede beklemek gerekir?
Bütün raporlama altyapısını tek seferde taşımak için bekleyin. Önce dar bir kullanım durumunda veri eşitliği ve operasyon kazancı ölçülmeli. Büyük CSV dışa aktarımlarını yalnızca yeni olduğu için senkron sorguya çevirmeyin. 60 saniyelik sınır ve kota davranışı üretim yükünde test edilmeden eski işi kaldırmayın.
Beklememeniz gereken alan entegrasyon envanteri. Hangi raporun kullanıcı etkileşimi, hangisinin arşiv ve faturalama için kritik olduğu bilinmiyorsa doğru API yolu seçilemez.
Fark Studio yorumu
“Gerçek zamanlı” etiketi çoğu zaman ölçüm kalitesinden daha hızlı karar vaadi yaratır. Asıl değer, gerekli soruyu daha az operasyonel adımla sormak ve yanıtın kapsamını açık tutmaktır. Hızlı ama yanlış tanımlanmış metrik, yavaş rapordan daha tehlikeli olabilir.
Dijital pazarlama, performans pazarlama ve web geliştirme ekipleri veri sözlüğü ile entegrasyon kararını birlikte vermeli. CM360 raporlamanızı pano, arşiv ve uyarı senaryolarına ayırmak istiyorsanız Fark Studio ile ölçüm mimarisi çalışması planlayabilirsiniz.
Kaynaklar
Google Ads Developers Blog, Query report data with Campaign Manager 360, 12 Ağustos 2026; yeni uç noktanın resmî duyurusu.
Google for Developers, Query report data, 14 Temmuz 2026 güncellemesi; istek yapısı, alanlar ve kullanım ayrıntıları.
Google for Developers, Reporting overview, 14 Temmuz 2026 güncellemesi; senkron sorgu ile Reports servisi arasındaki resmî seçim rehberi.
Search Engine Land, Google adds real-time reporting endpoint to Campaign Manager 360 API, 12 Ağustos 2026; sektör etkisinin radar özeti.
