Çoğu ekibin elinde zaten bir Google sıralama raporu var. Bu, Search Console'daki Performans sekmesinin tıklamaya göre sıralanıp ekran görüntüsü alınarak slayta yapıştırılmış hâli. Sıralamaları gösteriyor. Neyin değiştiğini, neden değiştiğini ya da kimsenin bu konuda ne yapması gerektiğini göstermiyor.
Bu akış bunu tek oturumda çözüyor. Bir sorgu kümesi tanımlıyorsunuz, Codex'e yazılı bir rapor sözleşmesi veriyorsunuz ve her hafta aynı biçimde rapor üretmesini sağlıyorsunuz. İlk kurulum yaklaşık 90 dakika sürüyor. Sonraki her çalıştırma on dakikanın altında.
Akışın tamamı: ham dışa aktarımlar girer, sabit biçimli tek bir rapor çıkar, sonunda bir insan kararı verilir.
Sonunda elinizde ne olacak
Kimin için: bir sitenin raporlamasından sorumlu olan ve Search Console erişimi zaten bulunan herkes için. Geliştirici olmanız gerekmiyor, ama Codex'in okuyabileceği bir dosya saklama alanınız olması gerekiyor.
Bitirdiğinizde elinizde: kaydedilmiş bir rapor şablonu, Codex'in her çalıştırmada izlediği yazılı bir talimat dosyası ve gerçek bir haftaya ait tamamlanmış bir rapor.
Ön koşullar: doğrulanmış bir Search Console mülkü, gerçekten önemsediğiniz 20-50 sorguluk bir liste, proje klasörüne erişimi olan bir Codex ve ileri sürümü istiyorsanız kendi sitenizin deposuna okuma erişimi.
Bitti tanımı: raporu SEO yapmayan birine verebiliyorsunuz ve o kişi hangi üç sorguya bakılacağını ve nedenini söyleyebiliyor.
Süre: ilk kurulum için yaklaşık 90 dakika, sonrasında çalıştırma başına 10 dakikanın altında.
Performans raporu neden sıralama raporu değil
Search Console size dört sütun veriyor: tıklamalar, gösterimler, TO ve ortalama konum. Bu bir ölçüm tablosu. Sıralama raporunun ise farklı bir soru kümesini yanıtlaması gerekiyor ve 2026 sinyalleri bu açığı eskisinden daha da büyüttü.
9 Eylül 2026'da yayımlanan Zyppy uzman anketi, 131 uygulayıcıdan 13.665 veri noktası topladı. Tıklama ve davranış sinyalleri %29,4, marka sinyalleri %27,0, teknik SEO sağlığı %17,5 çıktı. Teknik sağlığı geçen üç sinyalden ikisi konum sütununda görünmüyor. Bu sayıların neyi değiştirdiğine dair ayrı bir uygulama rehberimiz var, ama raporlama açısından kısa özet şu: raporunuz yalnızca sıralamaları gösteriyorsa, en az hareket eden sinyal hakkında rapor veriyorsunuz.
Codex'in kapattığı açık tam olarak bu. Size Google'ın bir şeyi neden değiştirdiğini söylemez. Değişimin kanıtını, sizin söyleyebileceğiniz kadar tutarlı biçimde bir araya getirir.
Başlamadan önce: dört karar
Bunları bir şey yazmadan önce verin, çünkü sonradan değiştirmek raporu baştan kurmak demek.
- Sorgu kümesi. 20-50 sorgu, işin düşünme biçimine uyan iki ya da üç kovaya bölünmüş. "Ürün", "karşılaştırma", "destek" ifadeleri "yüksek / orta / düşük hacim"den daha iyi çalışır.
- Karşılaştırma penceresi. Son 28 günü önceki 28 günle karşılaştırın. Daha kısa pencereler gürültülüdür; daha uzunları aradığınız değişimi gizler.
- Eşik. Neyin raporlanmaya değer sayılacağına karar verin. Beş konumdan fazla kayan bir sorgu ya da tıklamalar sabitken %30'dan fazla oynayan gösterimler makul varsayılanlar.
- Depolama yeri. Tek klasör, tek adlandırma kuralı.
reports/ranking/YYYY-MM-DD.mdve ham dışa aktarımlar için birdata/alt klasörü. Codex'in tutarlı bir yazma yerine ihtiyacı var.
Adım 1: ham veriyi dışa aktarın
Search Console'u açın, mülkünüzü seçin ve Performans'a gidin. Tarih aralığını 56 güne ayarlayın ki 28'e 28 karşılaştırma tek bir dışa aktarımdan mümkün olsun, ardından Dışa Aktar düğmesiyle Sorgular sekmesinin CSV'sini indirin.
Aynısını Sayfalar için, mobil ile masaüstü ayrımını raporlayacaksanız Cihazlar için de yapın.
Beklenen çıktı: data/ içinde, adında dışa aktarma tarihi olan üç CSV dosyası.
Kalite kontrolü: sorgu CSV'sini açın ve ilk veri satırının "anonymous" kelimesini içeren bir sorgu olmadığını doğrulayın. Search Console seyrek sorguları gizler ve bunu kontrol etmezseniz o satırlar raporunuzda adsız hareket olarak görünür.
Başarısız olursa: dışa aktarma kesilmişse tarih aralığınız satır sınırına göre fazla geniştir. 28 günlük pencereleri ayrı ayrı dışa aktarın, birleştirmeyi Codex yapsın.
Adım 2: rapor sözleşmesini yazın
Akışın üçüncü haftayı geçip geçmeyeceğini belirleyen adım budur. Sözleşmeyi Codex'in her çalıştırmada okuduğu bir dosyaya koyun: proje kökündeki AGENTS.md ya da rapor klasöründeki özel bir talimat dosyası.
Sözleşmenin beş şeye ihtiyacı var, başka hiçbir şeye yok:
Sözleşme bloğu | Ne yazılır | Neden önemli |
|---|---|---|
Girdiler | Tam dosya yolları ve tarih aralığı kuralı | Ajanın pencere uydurmasını engeller |
Eşikler | Sizin bantlarınız, sayı olarak | Bir tabloyu karara dönüştürür |
Çıktı biçimi | Üç bölüm, bu sırayla | 30. haftayı 1. haftayla karşılaştırılabilir tutar |
Güven kuralları | Veri bir değişimi açıklamadığında ne yazılacak | Kendinden emin saçmalığı önler |
Sınırlar | Ajanın yapmaması gerekenler | Siz güvenene kadar yalnızca okuma |
Çalışan bir sürüm şöyle görünür:
## Sıralama raporu sözleşmesi
Girdiler: data/queries-*.csv, data/pages-*.csv
Pencere: son 28 gün ile önceki 28 gün. İki tarihi de rapor başlığında belirt.
Yalnızca üç şeyi raporla:
1. Hareket eden sorgular: 5 konumdan fazla kayan, ya da tıklamalar sabitken
gösterimleri %30'dan fazla artan, ya da ilk 10'dan çıkan her sorgu.
2. Muhtemel açıklama: yalnızca dosyalardaki veriyi kullan. Dosyalar hareketi
açıklamıyorsa "bu veriyle açıklanmıyor" yaz.
3. Gelecek hafta kontrol: işaretlenen her sorgu için bir satır, incelenecek
sayfayı ya da sorguyu tam adıyla belirt.
Veride işaret edemediğin bir nedeni asla belirtme. Asla site değişikliği önerme.
reports/ranking/ dışındaki hiçbir dosyayı asla düzenleme.Beklenen çıktı: bir talimat dosyası, sürüm kontrolüne eklenmiş ya da verinin yanına kaydedilmiş.
Kalite kontrolü: sözleşmeyi sesli okuyun. Herhangi bir satır hiç düzenleme yapmadan başka bir siteye uyabiliyorsa, bir şeyi kısıtlayamayacak kadar belirsizdir.
Başarısız olursa: Codex sürekli yeni bölüm ekliyorsa çıktı biçimi yeterince belirli değildir. Üç başlığı istediğiniz ifadeyle birebir adlandırın.
Raporun anatomisi. Kullanılan dosyaları tam olarak listeleyen altbilgi, inceleyenlerin en çok güvendiği ve çoğu şablonun atladığı kısımdır.
Adım 3: ilk raporu üretin
Codex'i klasöre yönlendirin ve sözleşmeye göre bir rapor isteyin. Sohbet yanıtı değil dosya isteyin, böylece çıktı incelenebilir ve karşılaştırılabilir olur.
İlk çalıştırma, verinizin gerçekte neye benzediğini keşfettiğiniz yerdir. İki üç tur düzeltme bekleyin. Bu normaldir ve tüm akışın en ucuz kısmıdır.
Beklenen çıktı: başlığı, üç bölümü ve kullanılan dosyaları listeleyen altbilgisi olan reports/ranking/YYYY-MM-DD.md.
Kalite kontrolü: işaretlenen iki sorgu seçin ve sayıları Search Console'da elle doğrulayın. Tutuyorsa hat sağlamdır. Tutmuyorsa durun ve veri adımını düzeltin. Bozuk bir girdinin üstünde analizi ayıklamaya çalışmayın.
Başarısız olursa: en sık görülen başarısızlık, dışa aktarma ile sözleşme arasındaki tarih uyuşmazlığıdır. Her çalıştırmada iki tarihi de başlığa sabitleyin, böylece iki günlük kayma sabit bir ayı sessizce çöküşe çeviremez.
Kurduğum ilk sürüm, neredeyse hiçbir şeyin kıpırdamadığı bir haftada on bir hareket eden sorgu bildirdi. Sözleşme iyiydi, dışa aktarma değildi. 30 günlük bir dosyanın 28 günlük pencereyle karşılaştırılması, iki günlük eksik veriyi site çapında bir çöküş gibi gösterdi. Artık sözleşme iki aralık uyuşmuyorsa çalışmayı reddediyor ve o hata bir daha görünmedi.
Adım 4: ajanın yazamayacağı satırı ekleyin
Her rapora bir insan paragrafı girer: geçen hafta neyi yayınladık, değiştirdik ya da bozduk.
Bu süs değil. Kendi sürümünüzü algoritma güncellemesine yazan bir ajanı yakalamanın en hızlı yolu budur. Rapor bir ürün sayfası grubunun düştüğünü söylerken notunuz şablonun salı günü değiştiğini söylüyorsa, açıklama aralığı anında daralır.
Beklenen çıktı: raporun en başında, bir insanın yazdığı iki üç cümle.
Kalite kontrolü: not ile hareket bölümü birbiriyle çelişiyorsa, o çelişki rapordaki en değerli satırdır. Üstünü örtmek yerine görünür bırakın.
Adım 5: göndermeden önce doğrulayın
Rapor masanızdan çıkmadan önce şu üç kontrolü yapın.
- Tarihler. İki pencere de başlıkta belirtilmiş ve dışa aktarmayla uyuşuyor.
- İki örnek kontrol. İşaretlenen iki sorgu elle doğrulanmış.
- Bir çelişki kontrolü. Öne sürülen herhangi bir açıklama, alttaki dosya listesinde olmayan bir veriye atıf yapıyor mu?
Üçü de geçerse rapor paylaşılabilir. Bu, muhakemenizin bir taslağıdır, yerine geçen bir şey değil.
Hazır olduğunuzda ileri düzey yol
Önce akışı dört hafta elle çalıştırın. Ancak aynı hata sınıfını iki kez düzelttikten sonra otomatikleştirin.
Sonrasında yükseltmeler kademeli:
- Çalıştırmayı planlayın. Haftalık zamanlanmış bir çalıştırma, siz dizüstünü açmadan raporu yazar. İnsan paragrafını zorunlu alan tutun ki rapor onsuz çıkamasın.
- Anlık görüntüleri sürüm kontrolünde saklayın. Her çalıştırma bir commit olur. İki hafta arasındaki fark, iki raporun herhangi birinden hızlı okunur.
- İkinci bir mülk ekleyin. Rakip ya da marka sorguları ana rapora karıştırılmadan, aynı sözleşmeyle ayrı bir raporda durur.
- Bir dış sinyal ekleyin. Markalı arama ya da yanıt payı kontrolü, 2026 anketindeki marka sinyalini teorik olmaktan çıkarıp ölçülebilir kılar.
Otomatikleştirilmemesi gereken şey: öneri adımı. Bir ajan site değişikliği önermeye başladığı an, raporlamadan yayına geçmişsinizdir ve inceleme yükü kazanılan zamandan hızlı artar.
Sorun giderme
Belirti | Muhtemel neden | Çözüm |
|---|---|---|
Her sorgu düşmüş gibi görünüyor | Dışa aktarımlar arasında tarih aralığı kayması | İki pencereyi hem sözleşmeye hem başlığa sabitleyin |
Rapor boş | Trafik düzeyiniz için eşikler fazla katı | Konum eşiğini düşürmeden önce gösterim eşiğini düşürün |
Her hafta aynı beş sorgu | Sorgu kümesi fazla dar | Kovalara uzun kuyruk ve karşılaştırma sorguları ekleyin |
Açıklamasız hareket | Düşük hacimli sorgularda normal | "Bu veriyle açıklanmıyor" çıktısını koruyup devam edin |
Sayılar Search Console ile uyuşmuyor | Dışa aktarmada mülk ya da filtre uyuşmazlığı | Her seferinde aynı mülkten ve aynı filtre kümesinden aktarın |
Akışı koruyun
Üç bakım alışkanlığı bunu ilk çeyrekten sonra da işe yarar tutar.
Sorgu kümesini her çeyrek gözden geçirin. Geçen yılın önceliklerini kovalayan bir rapor sıralama raporu değil, tarih dersidir.
Search Console değiştiğinde sözleşmeyi yeniden okuyun. Google, Performans raporu arayüzünü ve dışa aktarma alanlarını düzenli olarak günceller. Bir alan kaybolursa sözleşmenin aynı gün düzenlenmesi gerekir.
Eski raporları saklayın. Bu çeyreğin raporunu geçen yılın aynı çeyreğiyle karşılaştırmak, gerçek düşüşü mevsimsellikten ayırmanın tek ucuz yoludur.
Sık sorulan sorular (SSS)
Özellikle Codex mi gerekiyor? Hayır. Akış; dosya okuyabilen, zamanlamayla çalışabilen ve incelenebilir çıktı yazabilen her ajanla çalışır. Siteniz zaten bir depodaysa Codex iyi uyar, çünkü rapor karşılaştırabileceğiniz bir commit olur.
Yalnızca ücretsiz araçlarla olur mu? Olur. Akışın tamamı ücretsiz olan Search Console verisi ve ajan üzerinde çalışır. Ücretli bir sıralama takipçisine yalnızca rakip sıralamaları ya da kendi mülkünüzde göremediğiniz sıralamalar gerektiğinde ihtiyaç duyarsınız.
Search Console'daki Performans raporundan farkı ne? Performans raporu size bir tablo gösterir. Bu akış bir karar üretir: hangi sorgular eşiği geçti, veri neyi açıklıyor neyi açıklamıyor, gelecek hafta ne incelenecek. Ayrıca kayıt tutar, arayüz bunu yapmaz.
Sitemin trafiği çok azsa? Gösterim eşiğini düşürün ve 28 günü önceki 28 günle değil, geçen yılın aynı 28 günüyle karşılaştırın. Düşük hacimli siteler haftadan haftaya karşılaştırmadan çok yıldan yıla karşılaştırmadan sinyal alır.
Rapora AI Overview ya da AI atıfları eklenmeli mi? İsterseniz kendi sözleşmesi olan ayrı bir bölüm ekleyin. Sıralama raporunun dışında tutun, çünkü kaynaklar ve ölçüm farklıdır ve karıştırmak ikisini de okumayı zorlaştırır.
Yazar: Leo Harrington, Auspia'da 500'den fazla yönetici raporu için SEO analitiği çevirmeni. Leo, arama verisini uzman olmayanların da harekete geçebileceği raporlara dönüştürmeyi yazıyor.
