Ne anlama gelir?
JSON-LD, yapılandırılmış veriyi HTML içine gömmek yerine ayrı bir betik bloğu olarak eklemenin yoludur. Arama motorlarının önerdiği biçim budur.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Marka Adı",
"url": "https://site.com",
"logo": "https://site.com/logo.png",
"telephone": "+90 212 000 00 00"
}
</script>Diğer biçimlerle karşılaştırma
| Biçim | Nasıl çalışır | Durum |
|---|---|---|
| JSON-LD | Ayrı betik bloğu | Önerilen |
| Microdata | HTML etiketlerine gömülür | Desteklenir, bakımı zor |
| RDFa | HTML özniteliklerine gömülür | Desteklenir, az kullanılır |
Neden tercih edilir?
- HTML'den bağımsızdır. Tasarım değişse de işaretleme bozulmaz
- Bakımı kolaydır. Tek yerde durur, okunabilir
- Dinamik üretilebilir. Şablondan otomatik oluşturulur
- Etiket yöneticisiyle eklenebilir (yine de sunucu tarafı tercih edilir)
- Hata ayıklaması kolaydır
Temel alanlar
@context— her zamanhttps://schema.org@type— içerik türü@id— varlığa benzersiz kimlik verir, farklı şemalar arasında bağ kurar
@id kullanımı ileri düzeydir ama değerlidir: Aynı kuruluşu farklı sayfalarda aynı kimlikle işaretlemek, varlık ilişkisini güçlendirir.
Birden fazla şema aynı sayfada
Bir sayfa birden fazla şema içerebilir. Örneğin bir blog yazısında:
Article— yazının kendisiBreadcrumbList— navigasyon yoluFAQPage— varsa SSS bölümüOrganization— yayıncı bilgisi
Bunlar ayrı bloklar hâlinde veya @graph yapısıyla tek blokta verilebilir.
Doğrulama
Yayınlamadan önce mutlaka test edin. Arama motorlarının sunduğu zengin sonuç test araçları, sözdizimi hatalarını ve eksik zorunlu alanları gösterir.
Ayrıca Search Console'daki ilgili raporlar, canlıdaki hataları takip etmenizi sağlar.
Ne anlama gelir?
JSON-LD (JavaScript Object Notation for Linked Data), yapılandırılmış veriyi bir sayfaya eklemenin en yaygın ve Google'ın önerdiği formatıdır. Schema.org kelime dağarcığını, sayfanın görünen içeriğine karışmadan, ayrı bir betik bloğu olarak <head> veya <body> bölümüne eklemenizi sağlar. Bu ayrılık, onu diğer işaretleme yöntemlerinden daha temiz ve yönetilebilir kılar.
Neden tercih edilir?
- İçerikten ayrı, tek bir blokta durur (bakımı kolay)
- HTML'i karmaşıklaştırmaz
- Google tarafından açıkça önerilir
- Dinamik olarak eklenip yönetilmesi kolaydır
Diğer formatlardan farkı
Eski işaretleme yöntemleri (Mikroveri, RDFa), etiketleri doğrudan görünen HTML öğelerinin içine serpiştirir; bu, kodu karmaşıklaştırır ve hataya açık hale getirir. JSON-LD ise tüm yapılandırılmış veriyi tek bir yerde, içerikten bağımsız tutar. Bu yüzden hem geliştiriciler hem SEO uzmanları için en pratik seçenektir.
Gerçek örnek
Bir e-ticaret sitesi, ürün bilgilerini eski yöntemle HTML içine serpiştirmişti ve her tema değişikliğinde işaretleme bozuluyordu. JSON-LD'ye geçildiğinde, tüm ürün şeması tek bir yönetilebilir blokta toplandı; bakımı kolaylaştı ve hata riski azaldı.
Sık sorulanlar
JSON-LD eklemek zorunlu mu? Zorunlu değil ama zengin sonuç ve doğru anlaşılma için şiddetle önerilir; Google'ın tercih ettiği formattır.
Eklendikten sonra ne yapmalıyım? Mutlaka bir doğrulama aracıyla test edilmeli; küçük bir sözdizimi hatası tüm işaretlemeyi geçersiz kılabilir.
Özet
JSON-LD, yapılandırılmış veriyi sayfaya eklemenin en yaygın ve Google'ın önerdiği formatıdır. Schema.org kelime dağarcığını içerikten ayrı, tek bir betik bloğunda tutar; bu da onu diğer yöntemlerden daha temiz, yönetilebilir ve hataya dayanıklı kılar.