JSON-LD (JavaScript Object Notation for Linked Data), yapılandırılmış verinin sayfaya tek bir <script type="application/ld+json"> bloğu olarak eklendiği biçimdir. Kısa cevap: sayfanın görünen HTML'ine dokunmadan, makineye okunacak bilgiyi ayrı bir kutuda vermek. Google'ın önerdiği biçim bu.
Neden bu biçim
Eski yöntem (microdata) etiketleri HTML'in içine dağıtıyordu; tasarım değişince işaretleme kırılıyordu. JSON-LD tek yerde durur, şablondan bağımsızdır ve panelden üretilebilir. Sayfanın herhangi bir yerinde olabilir; ben <head> içine koyuyorum.
Küçük bir örnek
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Örnek İşletme",
"telephone": "+90 342 000 00 00",
"address": { "@type": "PostalAddress", "addressLocality": "Gaziantep" }
}
Sık yapılan hatalar
- Sayfada olmayan bilgi. Yıldız puanı yazıp sayfada yorum göstermemek gibi. Kural ihlali sayılır.
- Her sayfaya aynı blok. Ana sayfanın işletme şeması iç sayfalarda aynen tekrarlanınca her sayfa "ben işletmeyim" der. Sayfa türüne göre değişmeli.
- Bozuk JSON. Tek bir eksik virgül bloğun tamamını geçersiz kılar ve kimse uyarmaz. Yayınlamadan önce doğrulama aracından geçirin.
- Sayfada görünenle çelişen değer. Şemada başka telefon, sayfada başka telefon. Makine ikisini de okur ve hangisine güveneceğini bilemez.
Doğrulama için Google'ın zengin sonuç testi yeterli; ayrıca şema üretici sayfasında doğru biçimde üretilmiş bir blok alıp uyarlayabilirsiniz.