- Konu sahibi
- #1
Search Console API ile arayüzde görülen verilerin farklı olması çoğunlukla bir hata değildir. İki tarafta tarih aralığı, mülk türü, arama türü, filtreler, boyutlar ve veri kapsamı aynı değilse sonuçlar değişir. Ayrıca Search Console anonimleştirilmiş sorguları göstermez, API genellikle yalnızca en üstteki sonuç satırlarını döndürür ve veriler işlenirken arayüz ile API arasında geçici fark oluşabilir.
Örneğin arayüzde bir sayfanın toplam tıklamasını görürken API isteğinde
Search Console verileri, seçilen boyutlara göre gruplanır. Sadece ülke boyutuyla alınan bir rapor ile ülke, cihaz, sayfa ve sorgu boyutlarının tamamıyla alınan rapor aynı ayrıntı düzeyine sahip değildir. Daha fazla boyut kullanıldığında veri daha çok satıra bölünür ve API'nin döndürdüğü sonuç kümesi toplamı temsil etmeyebilir.
Başlıca fark kaynakları şunlardır:
Bir site için arayüzde belirli bir günün toplam tıklaması 1.000 olsun. API'de aynı gün
Aynı karşılaştırmayı önce boyutsuz, yalnızca toplam metrikleri isteyen bir istekle yapmak daha sağlıklıdır. Ardından ayrıntılı istekle dönen satırların toplamını ayrıca değerlendirin; ayrıntılı satır toplamını arayüzdeki toplamın kesin eşdeğeri olarak kullanmayın.
Aşağıdaki tablo, farkın kaynağını hızlıca ayırmanıza yardımcı olur.
API’de rowLimit istek başına en fazla 25.000’dir. startRow ile sayfalama yapılabilir; bu, iç raporlama/gizlilik sınırlarını kaldırmaz. Google’ın performans veri çekme rehberinde günlük site ve arama türü başına 50.000 üst satır sınırı belirtilir. Eksik detay için tekrar tekrar aynı isteği göndermek tüm sorguları açığa çıkarmaz.
Toplamları eşleştirirken aggregationType ve responseAggregationType değerlerini de kontrol edin; byProperty ile byPage aynı sayım değildir. dataState=final işlenmiş veriyi, all ise mevcut ön veriyi de kapsar; son günleri karşılaştırırken aynı tazelik kapsamını seçin. CTR veya konum satırlarını basitçe toplamayın/ortalamasını almayın; CTR toplam tıklama/gösterim, konum ise uygun gösterim ağırlığıyla değerlendirilir.
API satırlarının toplamını kesin toplam sanmak: Ayrıntılı raporlarda görünmeyen anonimleştirilmiş veya düşük hacimli kayıtlar olabilir.
UTC tarihini doğrudan Search Console günü kabul etmek: Günlük raporlar ile UTC sınırları aynı olmayabilir. Gece yarısı çevresindeki verilerde tarih kapsamını özellikle kontrol edin.
Boyutları değiştirdiği halde karşılaştırmaya devam etmek: Arayüzde yalnızca sayfa seçiliyken API'de sorgu ve cihaz eklemek aynı raporu üretmez.
Son gün verisini kesin sonuç saymak: Yeni veriler işlenirken değerler güncellenebilir. Fark birkaç gün sonra da sürüyorsa önce kapsam ve filtreleri yeniden karşılaştırın.
Hayır. Önce sorgu gizliliği, dönen satır kapsamı, boyutlar ve mülk türü kontrol edilmelidir. Fark yalnızca ayrıntılı API satırlarını toplarken ortaya çıkıyorsa bu genellikle kapsam farkıdır.
Hayır. Daha fazla satır istemek dönen ayrıntıyı artırabilir; ancak anonimleştirilmiş sorguların gösterilmemesi ve Search Console raporlama sınırları nedeniyle arayüz toplamının birebir elde edileceği garanti edilmez.
Örneğin arayüzde bir sayfanın toplam tıklamasını görürken API isteğinde
page ve query boyutlarını birlikte kullanırsanız, anonimleştirilmiş sorguların ve döndürülmeyen daha düşük hacimli satırların toplamı eksik kalabilir. Bu nedenle API yanıtındaki satırları toplamak, arayüzdeki toplam değeri her zaman yeniden üretmez.Farkın nasıl oluştuğu
Search Console verileri, seçilen boyutlara göre gruplanır. Sadece ülke boyutuyla alınan bir rapor ile ülke, cihaz, sayfa ve sorgu boyutlarının tamamıyla alınan rapor aynı ayrıntı düzeyine sahip değildir. Daha fazla boyut kullanıldığında veri daha çok satıra bölünür ve API'nin döndürdüğü sonuç kümesi toplamı temsil etmeyebilir.
Başlıca fark kaynakları şunlardır:
- Tarih ve saat dilimi: Arayüzde seçilen günler ile API'de gönderilen
startDateveendDatedeğerlerini aynı kabul etmeden önce tarih dilimini kontrol edin. Günlük startDate/endDate aralığı PT (Pacific Time, yaz/kış saatine göre UTC−7/−8) kullanır ve iki uç günü de kapsar; İstanbul veya UTC gece yarısı aynı sınır değildir. Saatlik hour boyutunu günlük raporla karıştırmayın. - Mülk seçimi: Alan adı mülkü ile URL öneki mülkü aynı kapsamı ifade etmez.
http,https, alt alan adı veya doğrulanmış farklı mülkler ayrı sonuç verebilir. - Filtre ve arama türü: Web, görsel, video veya haber arama türleri; ülke, cihaz, sayfa, sorgu ve arama görünümü filtreleri sonuca doğrudan etki eder.
- Anonimleştirilmiş sorgular: Gizlilik nedeniyle bazı sorgular raporlarda gösterilmez. Bu sorguların tıklama ve gösterimleri, sorgu satırlarını tek tek topladığınızda görünmeyebilir.
- Sonuç satırı sınırı: API isteği ayrıntılı boyutlarla çok sayıda satır üretebilir. Yanıt, tüm olası satırlar yerine raporlama sınırları içindeki satırları döndürebilir.
- Veri işleme zamanı: Son günlere ait veriler daha sonra güncellenebilir. API ve arayüz aynı anda sorgulansa bile işlenme aşaması kısa süreli olarak farklı görünebilir.
Somut örnek: neden toplam tutmuyor?
Bir site için arayüzde belirli bir günün toplam tıklaması 1.000 olsun. API'de aynı gün
query ve page boyutlarıyla 700 tıklama dönerse bu, API'nin yanlış olduğu anlamına gelmez. Kalan bölüm anonimleştirilmiş sorgulardan, döndürülmeyen düşük hacimli satırlardan veya farklı mülk ve tarih kapsamından kaynaklanabilir.Aynı karşılaştırmayı önce boyutsuz, yalnızca toplam metrikleri isteyen bir istekle yapmak daha sağlıklıdır. Ardından ayrıntılı istekle dönen satırların toplamını ayrıca değerlendirin; ayrıntılı satır toplamını arayüzdeki toplamın kesin eşdeğeri olarak kullanmayın.
Karşılaştırmayı doğru yapmak
Aşağıdaki tablo, farkın kaynağını hızlıca ayırmanıza yardımcı olur.
| Kontrol | İki tarafta aynı olması gereken değer | Fark varsa olası açıklama |
|---|---|---|
| Mülk | Aynı Search Console mülkü | Alan adı ve URL öneki kapsamları karışmış olabilir |
| Tarih | Aynı başlangıç ve bitiş günü | Saat dilimi veya henüz işlenmemiş son günler |
| Kapsam | Aynı arama türü ve filtreler | Web, cihaz, ülke ya da sayfa filtresi farklı olabilir |
| Ayrıntı | Aynı boyutlar | Anonim sorgular ve satır döndürme sınırı |
Uygulanabilir kontrol sırası
- Arayüzde kullandığınız mülkün tam olarak hangisi olduğunu not edin ve API isteğinde aynı mülkü kullanın. Özellikle alan adı mülkünü bir URL öneki mülküyle karşılaştırmayın.
- Aynı başlangıç ve bitiş tarihlerini seçin. Son günleri karşılaştırıyorsanız verilerin tamamlanmamış olabileceğini dikkate alın; kesin raporlamada işlenmesi tamamlanmış bir dönem kullanın.
- Arama türünü, ülke, cihaz, sayfa ve sorgu filtrelerini eşitleyin. İlk denemede tüm filtreleri kaldırıp yalnızca temel toplam metrikleri karşılaştırın.
- Önce boyutsuz veya az boyutlu bir API isteği çalıştırın. Sonuçlar eşleşiyorsa boyutları birer birer ekleyerek farkın hangi boyutta başladığını bulun.
- Ayrıntılı satırları toplarken bunun yalnızca API'nin döndürdüğü görünür satırların toplamı olduğunu belirtin. Bu toplamı arayüzdeki toplamla aynı kabul etmeyin.
- Sonuç sürekli farklıysa istek gövdesini, kullanılan mülkü, tarihleri, filtreleri ve API yanıtındaki satır sayısını kaydedin. Böylece sorunun kapsam farkı mı, veri gecikmesi mi olduğunu ayırabilirsiniz.
API’de rowLimit istek başına en fazla 25.000’dir. startRow ile sayfalama yapılabilir; bu, iç raporlama/gizlilik sınırlarını kaldırmaz. Google’ın performans veri çekme rehberinde günlük site ve arama türü başına 50.000 üst satır sınırı belirtilir. Eksik detay için tekrar tekrar aynı isteği göndermek tüm sorguları açığa çıkarmaz.
Toplamları eşleştirirken aggregationType ve responseAggregationType değerlerini de kontrol edin; byProperty ile byPage aynı sayım değildir. dataState=final işlenmiş veriyi, all ise mevcut ön veriyi de kapsar; son günleri karşılaştırırken aynı tazelik kapsamını seçin. CTR veya konum satırlarını basitçe toplamayın/ortalamasını almayın; CTR toplam tıklama/gösterim, konum ise uygun gösterim ağırlığıyla değerlendirilir.
Sık yapılan hatalar
API satırlarının toplamını kesin toplam sanmak: Ayrıntılı raporlarda görünmeyen anonimleştirilmiş veya düşük hacimli kayıtlar olabilir.
UTC tarihini doğrudan Search Console günü kabul etmek: Günlük raporlar ile UTC sınırları aynı olmayabilir. Gece yarısı çevresindeki verilerde tarih kapsamını özellikle kontrol edin.
Boyutları değiştirdiği halde karşılaştırmaya devam etmek: Arayüzde yalnızca sayfa seçiliyken API'de sorgu ve cihaz eklemek aynı raporu üretmez.
Son gün verisini kesin sonuç saymak: Yeni veriler işlenirken değerler güncellenebilir. Fark birkaç gün sonra da sürüyorsa önce kapsam ve filtreleri yeniden karşılaştırın.
Kaynaklar
Sık sorulan sorular
API verisi arayüzden düşükse raporlama sistemi bozuk mudur?
Hayır. Önce sorgu gizliliği, dönen satır kapsamı, boyutlar ve mülk türü kontrol edilmelidir. Fark yalnızca ayrıntılı API satırlarını toplarken ortaya çıkıyorsa bu genellikle kapsam farkıdır.
Daha fazla satır istemek arayüzdeki toplamı kesin olarak verir mi?
Hayır. Daha fazla satır istemek dönen ayrıntıyı artırabilir; ancak anonimleştirilmiş sorguların gösterilmemesi ve Search Console raporlama sınırları nedeniyle arayüz toplamının birebir elde edileceği garanti edilmez.
