JSON-LD yapılandırılmış veri okunamıyor: sözdizimi hataları nasıl düzeltilir?

Ürün sayfalarınıza yapılandırılmış veri eklediniz ama Zengin Sonuçlar Testi “Ayrıştırma hatası” diyor. Genellikle sebep küçük bir sözdizimi hatasıdır: fazladan bir virgül, kaçırılmamış bir tırnak ya da bir ürün açıklamasındaki satır sonu.

KTYAPTECH SEO Analyzer bu sorunu SCHEMA-PARSE-ERROR-001 koduyla, “Yapılandırılmış veri okunamıyor” başlığı altında ve yüksek önem derecesiyle raporlar (Yapılandırılmış veri). Bu rehber, bulgunun ne anlama geldiğini, neden önemli olduğunu ve adım adım nasıl düzeltileceğini anlatıyor.

Okunamayan yapılandırılmış veri nedir?

JSON-LD, yapılandırılmış veriyi <script type="application/ld+json"> içinde JSON biçiminde veren yöntemdir. JSON katı bir biçimdir: sondaki fazla virgüller, tek tırnaklar, yorum satırları ve kaçırılmamış özel karakterler bloğun tamamını geçersiz kılar.

SEO Analyzer JSON-LD bloklarını ayrıştırır ve okunamayanları yüksek önemde raporlar, çünkü hatalı bir blok hiç yokmuş gibi davranır.

Neden önemli? SEO ve kullanıcı deneyimine etkisi

Ayrıştırılamayan bir blok Google tarafından tamamen yok sayılır; ürün, değerlendirme, SSS, kırıntı gibi zengin sonuç özelliklerine uygunluk kaybolur.

Hata çoğu zaman yalnızca belirli sayfalarda (özel karakter içeren ürün adları gibi) oluştuğu için fark edilmesi gecikir.

Sorun nasıl tespit edilir?

• SEO Analyzer raporundaki “Yapılandırılmış veri okunamıyor” bulgusunda hatalı blokları görün.
• Zengin Sonuçlar Testi veya Schema.org doğrulayıcısında sayfayı test edin.
• Search Console'daki zengin sonuç raporlarında “Ayrıştırılamayan yapılandırılmış veri” hatalarını inceleyin.

Adım adım çözüm

1. Hatalı blokları doğrulayıcıda açın ve hata satırını bulun.
2. JSON-LD'yi şablonda metin birleştirerek değil, bir nesne oluşturup JSON serileştirici (JSON.stringify, json_encode) ile üretin; kaçış karakterleri otomatik doğru olur.
3. Sondaki virgülleri, yorum satırlarını ve tek tırnakları kaldırın.
4. Script içine gömülen JSON'da </script> dizisinin kaçırıldığından emin olun.
5. Yapılandırılmış veri üreten kodu farklı ürün adı ve açıklama örnekleriyle test edin.

Neden elle birleştirme hatalıdır?

Ürün adında tırnak, açıklamada satır sonu veya ters eğik çizgi olduğunda elle birleştirilen JSON bozulur. Serileştiriciler bu karakterleri her zaman doğru kaçırır.

Sık yapılan hatalar

• JSON-LD'yi şablonda metin birleştirerek üretmek.
• Yalnızca bir örnek sayfayı test etmek.
• Hata veren bloğu tamamen kaldırıp yapılandırılmış veriden vazgeçmek.

Düzeltmeyi nasıl doğrularsınız?

• Zengin Sonuçlar Testi'nde hata kalmadığını görün.
• Search Console zengin sonuç raporlarını izleyin.
• SEO Analyzer'ı yeniden çalıştırın.

Sık sorulan sorular

Bir hatalı blok diğerlerini de etkiler mi?

Her script bloğu ayrı ayrıştırılır; hatalı blok yok sayılır, diğerleri etkilenmez.

Microdata mı, JSON-LD mi?

Google JSON-LD'yi önerir; bakımı ve doğrulaması daha kolaydır.

Özet

Tek bir sözdizimi hatası tüm JSON-LD bloğunu geçersiz kılar. Yapılandırılmış veriyi nesne olarak oluşturup serileştiriciyle üretin ve farklı içeriklerle test edin.

Sitenizde bu ve benzeri sorunların olup olmadığını görmek için KTYAPTECH Ücretsiz SEO Analizi aracını kullanabilirsiniz: rapordaki her bulgunun yanında, sorunu anlatan çözüm rehberine giden bir bağlantı bulunur.