PWA Sitesinde SEO Sorunları: Service Worker ve İndeksleme İlişkisi

Service worker önbellek stratejileri ve app shell mimarisi, Googlebot'un PWA sitelerini tarama ve indeksleme biçimini doğrudan etkiler. Hangi yapılandırmaların indeksleme sorunlarına yol açtığı ve SEO uyumlu service worker yapılandırmasının nasıl kurulduğu adım adım ele alınıyor.

Progressive Web App mimarisinde service worker, kullanıcıya hızlı ve kesintisiz bir deneyim sunar; ancak aynı katman, Googlebot'un içeriğinize erişme biçimini sessizce değiştirebilir. Önbellek stratejisi, app shell yapısı ve fetch olaylarının işlenme sırası bir araya geldiğinde, botun aldığı yanıt kullanıcının aldığından farklılaşır. PWA sitelerinde görülen bazı indeksleme sorunları bu farkın doğrudan sonucudur.

Bir sayfanın URL'i düzgün görünür, robots.txt'te engel yoktur, canonical etiketi yerli yerindedir ve JavaScript render de çalışıyor gibidir. Yine de Search Console kapsamında sayfa "tarandı, şu an indekslenmiyor" durumunda takılı kalır. PWA projelerinde bu tablo sık karşılaşılan bir durumdur ve çoğunlukla servis katmanında başlar.

Googlebot, modern Chrome altyapısı üzerinde çalışır; dolayısıyla service worker'ı tarayıcı gibi kaydeder ve JavaScript'i çalıştırabilir. Fakat botun render süreci kuyruklanır ve gecikmeyle tamamlanır. Bu gecikme içinde service worker'ın sunduğu yanıt, önbelleğin durumuna göre içerik içerebilir ya da içermeyebilir. Sorunun kaynağını bulmak için service worker yaşam döngüsünü, önbellek katmanını ve botun render sürecindeki gecikmeyi birlikte değerlendirmek gerekir.

Service worker Googlebot'un tarama akışını nasıl değiştirir

Normal bir HTTP isteğinde Googlebot, sunucuya doğrudan bağlanır ve yanıt alır. Service worker devreye girdiğinde bu akış değişir. Service worker, tarayıcı ile ağ arasında bir ara katman gibi konumlanır; fetch olayını dinler, isteği yakalar ve önbellekten, ağdan ya da her ikisinin kombinasyonundan yanıt üretir. Googlebot sayfayı ilk kez ziyaret ettiğinde service worker henüz aktif olmayabilir. İkinci ve sonraki ziyaretlerde ise aktif bir service worker devreye girer.

Bu durum şunu yaratır: aynı URL için farklı ziyaretlerde farklı yanıtlar dönebilir. İlk taramada sayfa sunucudan gelir. Sonraki taramada önbellekten. Önbellekteki sürüm güncel değilse bot eski içerikle karşılaşır; sayfada kritik içerik değiştiyse Googlebot değişimi geç fark eder ya da hiç fark etmez.

Bir service worker'ın yaşam döngüsü üç aşamadan oluşur: kurulum, bekleme ve aktivasyon. Güncellenen bir service worker, eski sürüm tamamen kapatılmadan aktif olmaz. Googlebot birden fazla URL'i paralel tarayabildiğinden, eski ve yeni service worker sürümleri aynı anda aktif olabilir. Bu çakışma, aynı sitenin farklı sayfalarında botun farklı önbellek versiyonlarıyla karşılaşmasına neden olur.

App shell mimarisi içerik görünürlüğünü nasıl sınırlar

App shell mimarisi, uygulamanın iskeletini - header, footer, navigasyon - önbellekte tutar; içeriği ise dinamik olarak API çağrısıyla yükler. Kullanıcı için bu yaklaşım anında yükleme hissi verir. Googlebot için ise HTML yanıtı başlangıçta içeriksiz olabilir.

Bot sayfayı aldığında şunu görür: birkaç satır iskelet HTML ve içeriği çeken bir JavaScript bloğu. JavaScript işleme kuyruğuna girer. Bot, sayfayı render ederken önbellekten app shell'i alır, ardından API çağrısı yapar. Fakat bu API isteği kendi başına ayrı bir işlem olduğundan, botun render bütçesi aşılırsa içerik hiç yüklenmeyebilir.

Render bütçesi aşıldığında Search Console "İçerik kısmen işlendi" şeklinde bir uyarı üretmez; sayfa yalnızca başlık ve meta açıklamasıyla indekslenir ya da hiç indekslenmez. App shell mimarisi kullanan bir sitede bu durumu URL İnceleme aracıyla test etmek gerekir: "Canlı URL'yi Test Et" seçeneği, botun aldığı gerçek render çıktısını gösterir.

Önbellek stratejisi seçimi indeksleme kararını doğrudan etkiler

Service worker'da seçilen önbellek stratejisi, botun ne gördüğünü belirler. En yaygın üç strateji şunlardır: cache-first, network-first ve stale-while-revalidate. Her birinin SEO üzerindeki etkisi birbirinden farklıdır.

cache-first stratejisinde istek önce önbelleğe gider; önbellekte içerik varsa ağa hiç çıkılmaz. İçerik güncellendiğinde kullanıcı yeni sürümü alır, ancak Googlebot önbellek temizlenene ya da service worker güncellenene kadar eski sürümle karşılaşmaya devam eder. Sık güncellenen haber veya ürün sayfaları için cache-first seçmek SEO açısından risklidir.

stale-while-revalidate önce önbellekten yanıt döner, arka planda ağdan taze sürümü getirir ve bir sonraki istek için kaydeder. Kullanıcı her zaman hızlı yanıt alır; ancak Googlebot ilk istekte önbellekteki eski sürümü görür. Güncel sürümü bir sonraki taramada alır. Bir sonraki taramanın ne zaman gerçekleşeceği kontrolünüzde değildir.

network-first, SEO açısından en güvenli seçenektir. İstek önce ağa gider; ağ başarısız olursa önbellekten yanıt dönülür. Bu yapıda bot her zaman sunucudaki güncel içeriği alır. Performans açısından ise en yavaş stratejidir çünkü her istekte ağ gecikmesi yaşanır. Hangi rotaların hangi stratejiyle hizmet verdiğini bilinçli seçmek gerekir: statik varlıklar (CSS, font, ikon) için cache-first uygun olabilir, HTML belgeleri ve API yanıtları için network-first tercih edilmelidir.

robots.txt ve service worker kayıt çakışması

Service worker kaydı genellikle bir JavaScript dosyasıyla gerçekleşir: navigator.serviceWorker.register('/sw.js'). Bu dosyanın taranabilir olması gerekir. robots.txt'te /sw.js veya service worker'ın önbelleğe aldığı kaynak dosyalarını engellemek, service worker'ın kaydedilmesini ya da güncellenmesini kesintiye uğratabilir.

Daha yaygın bir sorun şudur: bazı PWA yapılandırmaları tüm URL'leri service worker üzerinden yönlendirmek için /* kapsamı tanımlar. Bu kapsamın robots.txt'teki yönlendirme kurallarıyla örtüşüp örtüşmediği kontrol edilmelidir. Özellikle /app/, /api/ veya /assets/ gibi önbelleklenen yolların erişilebilirliği gözden geçirilmelidir.

Service worker'ın fetch olayında respondWith ile sayfayı engelleyip özel bir yanıt döndürmesi de sorun yaratır. Googlebot bu durumda 200 yanıt alır ancak içerik sunucu HTML'inden farklıdır. "URL taranıyor, indekslenmiyor" bildirimi bu senaryoda sık görülür: bot sayfaya ulaşır, render eder, ancak içeriği yetersiz bulduğu için indekslemez.

Dinamik render ve service worker bir arada kullanıldığında

Bazı PWA siteleri, botlara farklı içerik sunmak için dinamik render çözümlerine başvurur. Mantık şudur: tarayıcı istek yaptığında JS ağırlıklı app shell döner; Googlebot istek yaptığında pre-render edilmiş HTML yanıt döner. Fakat dinamik render sunucuda çalışırken service worker istemcide çalışır. Bu ikisi bağımsız katmanlardır.

Service worker aktif olduğunda, dinamik render için yapılandırılmış sunucu yönlendirmesi devre dışı kalabilir. Çünkü service worker isteği önce yakalar; yanıt önbellekten gelirse sunucu hiç devreye girmez. Dinamik render ve service worker bir arada kullanılıyorsa, service worker'ın botlara gelen istekleri önbellekten değil ağdan karşıladığından emin olmak gerekir.

Bunun için kullanıcı ajanı kontrolü service worker içinde yapılabilir; ancak bu yaklaşım kendi riskleri olan bir çözümdür. Google'ın bot kimliğine göre içerik ayrıştırılmamalıdır - yönlendirme altyapı düzeyinde, sunucuda gerçekleştirilmelidir. Service worker, içerik farklılaştırma değil önbellekleme aracı olarak tutulmalıdır.

Service worker'ı SEO uyumlu yapılandırmak için pratik adımlar

İlk adım, HTML belgelerini agresif önbellekleme stratejisinden çıkarmaktır. CSS, font ve ikon dosyaları için cache-first kullanılabilir; HTML dosyaları network-first ile hizmet vermelidir. Workbox kullanılıyorsa rota bazlı strateji tanımı şu şekilde görünür:

// HTML belgeler için network-first
registerRoute(
  ({ request }) => request.destination === 'document',
  new NetworkFirst()
);

// Statik varlıklar için cache-first
registerRoute(
  ({ request }) => ['style', 'script', 'image'].includes(request.destination),
  new CacheFirst()
);

İkinci adım, önbellek sürüm yönetimidir. Service worker her güncellendiğinde önbellek anahtarının değişmesi gerekir; aksi halde eski içerik silinmez. Kullanılmayan önbellek girişlerini temizlemek için activate olayında eski anahtarlar kaldırılmalıdır.

Üçüncü adım, sayfa URL'lerinin canonical değerleriyle uyumlu yanıt vermesidir. Service worker URL yeniden yazma yapıyorsa - örneğin /urun/ isteklerini /app/urun/ üzerinden yanıtlıyorsa - botun aldığı canonical etiketiyle gerçek URL örtüşmeyebilir. Bu çakışma indekslenebilirliği doğrudan olumsuz etkiler ve izlenmesi güçtür çünkü sunucu tarafında görünmez.

Search Console'da PWA kaynaklı sorunları tanımak

Kapsam raporunda şu desenler PWA kaynaklı sorunlara işaret eder: "Tarandı, şu an indekslenmiyor" durumundaki URL sayısının ani artması, tarama hatalarının service worker güncelleme döngüleriyle çakışması ve indekslenen sayfa sayısının belirli tarihlerden itibaren düşmesi.

URL İnceleme aracının "Canlı URL'yi Test Et" seçeneği, botun o an gördüğü render çıktısını döndürür. Sayfa HTML'inin içerik içerip içermediği ve canonical değerinin doğru olup olmadığı buradan doğrulanabilir. Fakat bu test tek bir anlık görüntüdür; service worker davranışı ziyaret sırasına göre değişebildiğinden, testin birden fazla kez çalıştırılması daha güvenilir sonuç verir.

Tarama istatistiklerinde "Alınan yanıt" raporu da dikkat gerektiren bir veridir. Belirli URL grubunun 304 yanıtlarını sürekli döndürmesi, service worker'ın ağa hiç çıkmadığını ve önbellekten yanıt ürettiğini gösterebilir. 304 yanıtı teknik olarak geçerlidir; ancak içerik değiştiği halde 304 dönüyorsa Googlebot güncellemeyi almaz.

PWA mimarisi, arama motoru indeksleme süreçlerini temelden değiştiren bir katman ekler. Service worker'ı yapılandırırken alınan her karar - önbellek stratejisi, kapsam, güncelleme politikası - sayfalarınıza botların erişimini doğrudan etkiler. Teknik SEO açısından bu katmanın görünmez kalmaması gerekir. Service worker davranışını belgelendirmek, önbellek politikalarını hangi rotalara uygulandığını izlemek ve indeksleme verilerini service worker güncellemeleriyle ilişkilendirmek, PWA projelerinde sürdürülebilir bir arama görünürlüğü için zorunlu pratiklerdir.

En az karmaşık yapı en iyi başlangıç noktasıdır. Tüm URL'leri kapsayan agresif önbellek stratejileri yerine, içerik sayfaları için sade bir network-first yapılandırması ve statik varlıklar için cache-first ayrımı hem performansı hem indekslenebilirliği birlikte korur. Sonradan karmaşıklık eklemek mümkündür; mevcut bir indeksleme sorununu service worker katmanında izole etmek ise zaman alır ve her zaman kolay değildir.