AI okunabilirliği, bir web sayfasındaki önemli bilgilerin yapay zeka ajanları tarafından doğru, güncel ve makinece anlaşılabilir biçimde alınabilmesidir. Örneğin ürün fiyatını sunucunun ürettiği HTML’de 1.299 TL, JavaScript çalıştıktan sonra tarayıcıda 1.249 TL görüyorsanız iki ayrı içerik katmanı oluşur. Kısa cevap: Hydration mismatch tek başına AI botuna mutlaka eski veri göndermez; ancak güncel bilgi yalnızca istemci tarafında yükleniyor veya SSR çıktısı önbellekte kalıyorsa bazı ajanlar ilk HTML’deki eski ya da eksik veriyi okuyabilir.
Bu nedenle hedef, yalnızca tarayıcıda doğru görünen bir sayfa üretmek değil, ham HTTP yanıtı, JavaScript kapalı görünüm ve JavaScript sonrası DOM arasındaki farkı ölçmektir. AI sistemlerinin tümü aynı tarama yöntemini kullanmaz: bazıları yalnızca HTTP yanıtını işler, bazıları JavaScript çalıştıran bir tarayıcı kullanabilir. Hangi katmanın okunduğunu varsaymak yerine 6 kontrolü aynı URL üzerinde uygulayın.
Hydration mismatch AI botuna eski veriyi nasıl ulaştırır?
Hydration mismatch, sunucu HTML’si ile React’in istemcideki ilk render çıktısı farklı olduğunda oluşur. Eski veri riski ise çoğunlukla stale SSR önbelleği, istemci tarafında yapılan veri çekimi veya zamanla değişen değerlerin birleşiminden doğar. Bu yüzden mismatch bir belirti, veri akışındaki tutarsızlık ise asıl inceleme alanıdır.
SSR, sunucunun tarayıcıya gönderdiği ilk HTML’dir. Bu HTML, JavaScript hiç çalışmadan da görülebilen içeriktir. Hydration sırasında React bu işaretlemeye olay dinleyicileri bağlar ve kendi sanal ağacıyla eşleştirme yapar. İlk istemci render’ı sunucudaki metin, nitelik veya düğüm yapısından farklıysa konsolda hata ya da uyarı oluşabilir. React bazı metin farklarını toparlayabilse de bu davranış, içeriğin tüm botlar için güncel kalacağı anlamına gelmez.
SSR ve istemci HTML farkını hangi 6 kontrolde bulabilirsiniz?
1. İlk HTTP yanıtında güncel veri var mı?
Önce JavaScript çalıştırmadan sunucunun ne gönderdiğini kaydedin. Yanıt gövdesinde başlık, fiyat, stok, tarih veya yapılandırılmış veri bulunmuyorsa JS çalışmadan içerik okunamaz. Yanıt eskiyse sorun hydration’dan önce, veri kaynağı ya da önbellek katmanındadır.
Komut satırında farklı User-Agent değerleriyle aynı URL’yi alın. User-Agent tek başına gerçek bir AI tarayıcısını taklit etmez; yine de CDN veya sunucu kurallarının farklı yanıt verip vermediğini gösterebilir.
curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html
2. View Source ile canlı DOM arasında ne değişiyor?
Tarayıcıdaki View Source, büyük ölçüde sunucudan gelen kaynak HTML’yi; Elements paneli ise JavaScript sonrası canlı DOM’u gösterir. Bu iki çıktıyı ayrı ayrı kaydedin ve önemli içerik düğümlerini karşılaştırın. Fiyat, açıklama, tarih ve JSON-LD içindeki değerler aynı değilse farkın kaynağını işaretleyin.
Bir farkın varlığı her zaman SEO hatası değildir. Örneğin React’in olay dinleyicisi bağlaması görünür metni değiştirmez. Buna karşılık sunucuda bulunan bir stok metninin istemcide kaldırılması veya yalnızca istemcide eklenmesi AI okunabilirliğini doğrudan etkileyebilir.
3. React hydration hatası hangi bileşende oluşuyor?
Tarayıcı konsolundaki hydration uyarısını ve component stack bilgisini kaydedin. React 18 ve sonraki sürümlerde hydrateRoot için onRecoverableError kullanarak üretim ortamındaki olayları izleyebilirsiniz. Hatanın yalnızca log’u susturuluyorsa problem çözülmüş sayılmaz.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration farkı', error.message, info.componentStack);
}
});
Hata mesajını URL, bileşen ve veri sürümüyle birlikte loglayın; kişisel veri göndermeyin. Bir sayfada aynı uyarı 3 farklı bileşende görülüyorsa ortak bir tarih formatı, locale veya başlangıç verisi üreticisi arayın.
4. Tarih, saat, locale veya rastgele değer ilk render’ı değiştiriyor mu?
Date.now(), Math.random(), tarayıcı saat dilimi, para biçimi ve window gibi kaynaklar sunucu ile istemcide farklı sonuçlar üretebilir. Sunucuda sabit bir ISO tarihini veya önceden biçimlendirilmiş etiketi üretin; istemcide değişken değeri hydration sonrasındaki useEffect içinde güncelleyin.
Örneğin sunucu UTC, tarayıcı ise Europe/Istanbul saat diliminde çalışıyorsa aynı zaman damgası farklı güne dönüşebilir. İlk HTML’de kesin bir tarih göstermeniz gerekiyorsa hem metni hem de veri sürümünü sunucudan istemciye aynı payload içinde taşıyın.
5. Güncel veri yalnızca istemci tarafındaki fetch ile mi geliyor?
Bir içerik useEffect içinde çekiliyorsa JavaScript kapalı istemcide ve yalnızca HTTP yanıtını okuyan ajanda görünmeyebilir. Kritik bilgi için ilk SSR yanıtına başlangıç verisini koyun. İstemci fetch’i son güncellemeyi alabilir; fakat ilk render aynı başlangıç değerinden başlamalıdır.
SSR’nin 10:00’da ürettiği ürün fiyatı ile istemcinin 10:01’de API’den aldığı fiyat farklıysa bu durum beklenen bir güncelleme olabilir. Ancak AI ajanı sadece ilk HTML’yi işliyorsa ikinci fiyatı hiç görmez. Bu farkı içerik kaynağı, üretim zamanı ve API yanıt zamanı ile birlikte raporlayın.
6. CDN, ISR veya uygulama önbelleği eski SSR çıktısını tutuyor mu?
Yanıt başlıklarındaki Age, ETag, Last-Modified, Cache-Control ve CDN’e özgü cache durumunu inceleyin. Sunucu veritabanından güncel fiyatı alsa bile CDN 300 saniyelik eski HTML döndürebilir. İçeriğin değiştiği anda purge, kısa revalidation veya uygun bir no-store politikası kullanın.
Önbelleği devre dışı bırakan rastgele sorgu parametresiyle yapılan test, gerçek ziyaretçi yolunu her zaman temsil etmez. Bu nedenle normal URL’yi 2 veya 3 farklı ağdan, aynı header’larla ve zaman damgası kaydı tutarak karşılaştırın. 200 yanıtın gövdesi farklıysa varyasyon kuralını da kontrol edin.
Teknik kontrol listesi
- Sayfanın ham HTML’sini
curlile kaydedin; önemli metin, canonical ve JSON-LD alanlarını işaretleyin. - View Source çıktısını JavaScript sonrası Elements DOM’u ile karşılaştırın; yalnızca sınıf veya olay bağlayıcısı değil, görünür içerik farklarını ayırın.
- JavaScript’i devre dışı bırakarak ürün, makale veya hizmet için gerekli bilgilerin okunabildiğini test edin.
- React konsol uyarılarını URL, bileşen ve veri sürümüyle izleyin;
suppressHydrationWarningkullanımını düzeltme yerine geçirmeyin. - Tarih, saat, locale ve rastgele değerleri ilk render’dan çıkarın veya sunucudan istemciye aynı değeri taşıyın.
- CDN ve uygulama önbelleğinde TTL, ETag, revalidation ve purge akışını içerik güncelleme anında doğrulayın.
Örnek senaryo: ürün fiyatı SSR’de eski, DOM’da güncel
Bir e-ticaret sayfasında ERP, ürünü 1.249 TL’ye güncelliyor. Fakat CDN’in 300 saniyelik TTL’si nedeniyle sunucu 1.299 TL içeren HTML’yi döndürmeye devam ediyor. React bileşeni hydration sonrasında API çağrısı yapıyor ve tarayıcıda 1.249 TL gösteriyor. Kullanıcı Elements panelinde doğru fiyatı görürken, JS çalıştırmayan bir AI okuyucu ham HTML’de 1.299 TL bulabilir.
Doğru düzeltme, yalnızca hydration uyarısını kapatmak değildir. SSR’nin güncel kaynaktan veri almasını, CDN’in ERP güncellemesinden sonra temizlenmesini ve istemcinin aynı başlangıç değerini kullanmasını sağlayın. Aşağıdaki desen, sunucu etiketinin ilk istemci render’ında korunmasını; API yanıtı geldikten sonra kontrollü değişmesini sağlar:
function Price({ initialLabel, initialValue }) {
const [price, setPrice] = useState({
label: initialLabel,
value: initialValue
});
useEffect(() => {
fetch('/api/price/abc', { cache: 'no-store' })
.then(response => response.json())
.then(nextPrice => setPrice(nextPrice));
}, []);
return <p data-price={price.value}>{price.label}</p>;
}
Burada initialLabel ve initialValue SSR ile istemciye aynı aktarılmalıdır. API yanıtı örneğin { label: '1.249 TL', value: 1249 } biçiminde dönebilir. Test sırasında önce ssr.html dosyasını, sonra JavaScript etkin tarayıcıdaki DOM’u kaydedin; ardından diff -u ile yalnızca fiyat düğümünü değil, JSON-LD ve erişilebilirlik metinlerini de inceleyin.
Sayfa değişken veriyi gerçekten istemcide güncelliyorsa, bu güncellemenin ne zaman gerçekleştiğini ölçün. Örneğin 180 milisaniyede tamamlanan bir fetch tarayıcı kullanıcısı için görünür olabilir; fakat sunucu yanıtını hiç render etmeyen bir ajan bu süreyi yaşamaz. AI okunabilirliği açısından kritik bilgi ilk HTML’de bulunmalı ve oradaki değer geçerli veri politikanızla uyumlu olmalıdır.
Sık yapılan hatalar
- Hydration uyarısını bastırmayı, eski veya eksik içeriği düzeltmek sanmak.
- Yalnızca ekran görüntüsünü kontrol edip ham HTTP yanıtını hiç incelememek.
- Fiyat, stok veya makale gövdesini yalnızca
useEffectiçindeki API çağrısına bırakmak. - Sunucu ve istemcide farklı locale, saat dilimi ya da para biçimi kullanmak.
- CDN cache temizliğini doğrulamadan içerik güncellemesinin anında yayınlandığını varsaymak.
- Bir tarayıcı botunun davranışını tüm AI ajanlarına genellemek.
Sonuç olarak hydration mismatch, önce SSR çıktısı ile istemcinin ilk render’ını karşılaştırmanız gereken bir sinyaldir. Eski verinin gerçekten AI botuna gidip gitmediğini anlamak için ham yanıtı, JavaScript kapalı görünümü, canlı DOM’u, React log’larını ve önbellek başlıklarını aynı URL üzerinde birlikte değerlendirin.