Dokümanlar

Sorun rehberi · Yapılandırılmış veri

JSON-LD ayrıştırma hatası

ÖnemOrta
KategoriYapılandırılmış veri
KapsamSayfa başına
EmekAz
DoğrulamaGörevi tamamlayınca yeniden tarama
Kural anahtarıjsonld_parse_error

Kısa cevap

Sayfadaki en az bir <script type="application/ld+json"> bloğu JSON olarak ayrıştırılamadı. Arama motorları ayrıştırılamayan bir bloğu tamamen atlar; dolayısıyla içerdiği işaretleme (ürün, makale, breadcrumb) hiçbir işe yaramaz. Bu sorun aramadaki zengin sonuçları etkiler. Sık görülen sebepler: sondaki fazladan virgül, bir metin içinde kaçışsız tırnak ya da satır sonu veya PHP/Liquid çıktısını yanlış yere basan bir şablon. Şemayı geçerli bir JSON haline getirin.

Neden önemli

HTML'in aksine JSON'da hata toleransı yoktur: tek bir yersiz virgül bütün bloğu geçersiz kılar. Sayfanın geri kalanı etkilenmez (dizine ekleme ve sıralama yapısal veriye bağlı değildir), ama o bloğun üreteceği tüm zengin sonuçlar kaybolur.

Glimana bunu nasıl tespit eder

Glimana tarama sırasında her JSON-LD bloğunu ayrıştırır ve herhangi bir blok ayrıştırılamadığında tetiklenir. Kanıtta hatalı blok sayısı gösterilir; hatanın tam konumunu Zengin Sonuçlar Testi ya da bir JSON doğrulayıcı gösterir.

Nasıl düzeltilir

  1. Glimana'da etkilenen sayfaları bulun. Sorunlar › JSON-LD ayrıştırma hatası bölümünü açın. Etkilenen her sayfa bir satırdır; Glimana'nın o sayfa için kaydettiği kanıtı (ölçülen değer, soruna yol açan öğe ya da hedef adres) görmek için satırı açın. Aynı liste Görevler altındaki görev kartında da yer alır; sayfanın Sayfalar altındaki kendi ayrıntı görünümü ise tüm sinyallerini gösterir.
  2. Düzeltmeyi platformunuzda uygulayın.

    1. Bloğu kopyalayın, sayfa kaynağından bir JSON doğrulayıcıya (ya da Zengin Sonuçlar Testi'ne) yapıştırarak hatanın satırını ve sütununu görün.
    2. Olağan şüphelileri düzeltin: son özellikten sonra kalan virgül, bir başlık ya da açıklamanın içinde \" olarak kaçışlanmamış bir ", metin içinde ham satır sonu, hiçbir şey basmayan bir şablon değişkeni (geriye "name": , bırakır).
    3. Kaçışlamayı kaynakta yapın. Şablon değerleri elle yazılmış bir metnin içine eklemek yerine bir JSON kodlayıcıdan (json_encode, | json, JSON.stringify) geçirmelidir.

    Blok bir SEO eklentisinden geliyorsa hata genellikle özel bir şema alanında ya da bir tema parçasındadır; hangisi olduğunu bulmak için özel şemayı geçici olarak devre dışı bırakın. Temada elle yazılmış şema parçalarında yazı başlıklarındaki tırnaklar klasik bir sebeptir.

    Temadaki JSON-LD her değerde | json kullanmalıdır ("name": {{ product.title | json }}), "name": "{{ product.title }}" değil; tırnak ya da kesme işareti içeren bir ürün başlığı ikinci biçimi bozar.

    Şemayı bir dizi/nesne olarak kurun ve dilin JSON kodlayıcısıyla serileştirin; metinleri asla birleştirerek oluşturmayın. Basılan bloğu ayrıştıran bir test ekleyin.

  3. Yayımlayın ve önbellekleri temizleyin. Kaydedip yayımlayın, ardından tarayıcının yeni sürümü göreceğinden emin olun: WordPress — önbellek eklentinizde sayfa önbelleğini temizleyin ve CDN'i boşaltın; Shopify — tema ve içerik değişiklikleri kaydedildiği anda yayına girer, ancak mağazanın önünde bir CDN varsa onu boşaltın; özel kod — dağıtımı yapın ve uç (edge) önbelleği boşaltın. Canlı HTML'in değiştiğini gizli bir pencerede ya da curl -s https://your-domain/page | grep -i '<title\|canonical\|robots' ile kontrol edin; Glimana, web tarayıcınızın önbelleğindekini değil, sunucunun gönderdiğini okur.

  4. Glimana'da doğrulayın. Görevi Görevler altında açıp Yaptım düğmesine tıklayın. Etkilenen sayfalar birkaç saat içinde doğrulama taramasına alınır; sayfadaki her JSON-LD bloğu sorunsuz ayrıştırıldığında görev kapanır. Kontrol yine başarısız olursa görev bir notla Yeni durumuna döner; geçerse Etki raporlarında Giderilen teknik sorunlar altında listelenir. Daha erken kontrol etmek için sorundaki Etkilenen sayfaları yeniden tara düğmesini kullanın.

Düzeltme nasıl doğrulanır

Yeniden tarayın; sayfadaki her JSON-LD bloğu ayrıştırılabildiğinde görev kapanır.

Kaynaklar

Bu sayfa işinize yaradı mı?

Son güncelleme 2026-10-10 · Destekle iletişim