JSON-LD nedir?

JSON-LD (Bağlantılı Veriler için JavaScript Nesne Gösterimi), arama motorlarının yapılandırılmış veriler için önerdiği formattır. Bir sayfa, schema.org sözlüğündeki türleri ve özellikleri kullanarak sayfanın ne hakkında olduğunu açıklayan bir <script type="application/ld+json"> bloğu ekler; örneğin fiyatı olan bir ürün, yazarı olan bir makale veya logosu olan bir kuruluş. Google, Bing ve diğer arama motorları bu blokları okuyarak yıldız puanları, fiyatlar, breadcrumb'lar ve tarif kartları gibi zengin sonuçlar gösterir.

JSON-LD'deki hatalar sessizce başarısız olur. Sayfa yine yüklenir; ancak eksik bir virgül, yanlış yazılmış bir tür veya eksik bir zorunlu alan, arama motorlarının işaretlemeyi yok saymasına ya da sayfanın zengin sonucunu kaybetmesine neden olur.

Araç açıklaması

Bu araç, bir sayfanın HTML içeriğini sunucuda alır, tüm JSON-LD script bloklarını bulur ve her birini iki adımda kontrol eder. İlk olarak JSON-LD'nin kendisini kontrol eder: JSON'un ayrıştırılabildiğini, her öğenin schema.org'a işaret eden bir @context ve bir @type içerdiğini, ayrıca @type ve @id gibi anahtar kelimelerin doğru yazılıp doğru biçimlendirildiğini denetler. Ardından içeriği schema.org sözlüğü ve Google'ın zengin sonuç kurallarıyla karşılaştırır; bilinmeyen türleri, bir türe ait olmayan özellikleri ve eksik olan ya da yanlış biçime sahip zorunlu veya önerilen alanları bildirir.

Özellikler

  • Canlı bir sayfadaki <head> veya <body> içinde bulunan tüm JSON-LD bloklarını bulur
  • JSON söz dizimi hatalarını ayrıştırıcının mesajıyla bildirir
  • @context, @type, @id, @graph ve anahtar kelime yazımlarını kontrol eder
  • Bilinmeyen schema.org türlerini ve bir türün desteklemediği özellikleri işaretler
  • Ürünler, teklifler, incelemeler, puanlar, tarifler, iş ilanları, videolar, breadcrumb'lar ve daha fazlası için Google'ın zorunlu ve önerilen alanlarını kontrol eder
  • Her yapılandırılmış veri öğesini türü ve adıyla listeler
  • Her bloğu biçimlendirilmiş JSON olarak gösterir

Nasıl çalışır?

Sayfa yönlendirmeler izlenmeden indirilir ve en fazla ilk 3 MB okunur. Her JSON-LD bloğu ayrı ayrı ayrıştırılır ve bir @graph içindeki öğeler ayrı öğeler olarak kontrol edilir. schema.org kontrollerinde schema.org sözlüğünün tamamının bir kopyası, Google zengin sonuç kontrollerinde ise Adobe'un açık kaynaklı yapılandırılmış veri doğrulayıcısı kullanılır.

İpuçları

  • Hatalar, arama motorlarının öğeyi yok saymasının veya öğenin zengin sonuç olarak gösterilmemesinin muhtemel olduğu anlamına gelir; bu nedenle önce bunları düzeltin. Uyarılar genellikle önerilen alanlarla ilgilidir ve bunları eklemek sonucun nasıl göründüğünü iyileştirebilir.
  • JSON-LD anahtar kelimeleri büyük/küçük harfe duyarlıdır: @type çalışır, @Type çalışmaz.
  • url, image ve logo için mutlak URL'ler; 2026-09-25 veya 2026-09-25T10:00:00+02:00 gibi ISO 8601 tarihleri kullanın.
  • Araç, sunucunun döndürdüğü HTML'yi okur. Tarayıcıda JavaScript tarafından daha sonra eklenen JSON-LD bulunamaz.