Üç biçim, tek sözlük
Schema.org sözlüğünü sayfaya üç farklı yolla yazabilirsiniz:
- JSON-LD — veri, ayrı bir
<script type="application/ld+json">bloğunda toplanır. - Microdata — veri, görünen HTML etiketlerinin içine
itempropöznitelikleriyle serpiştirilir. - RDFa — Microdata’ya benzer, farklı öznitelik adları kullanır.
Google üçünü de okur. Ama belgelerinde JSON-LD’yi önerir ve sebebi pratiktir.
JSON-LD neden öneriliyor?
Microdata ve RDFa veriyi tasarıma yapıştırır. Fiyatı gösteren <span> silinirse ya da tema değişirse işaretleme de gider — üstelik kimse fark etmez, çünkü sayfa görünürde düzgün çalışmaya devam eder. Bu, sessizce bozulan bir kusurdur ve sessiz kusurlar aylarca yaşar.
JSON-LD’de veri tek bir blokta durur, görünen HTML’den bağımsızdır. Tasarım değişikliği veriyi bozmaz, blok tek yerden üretilir ve tek yerden kontrol edilir. Sunucu tarafında üretmek de kolaydır.
Nasıl görünür?
Blok sayfanın <head> ya da <body> bölümüne konabilir; Google ikisini de okur. İçeriği JSON’dur: @context sözlüğü (her zaman https://schema.org), @type türü, sonra o türün alanları.
Bir sayfada birden fazla blok olabilir — örneğin bir ürün bloğu ve bir yol izi bloğu. Alternatif olarak tek blokta dizi hâlinde de yazılabilir. İkisi de geçerlidir.
JavaScript ile üretilirse ne olur?
Burası kritik. Googlebot JavaScript çalıştırır, dolayısıyla tarayıcıda sonradan eklenen JSON-LD’yi genellikle görür — ama bu ikinci bir tarama turu gerektirir ve gecikir.
Yapay zeka arama tarayıcıları ise JavaScript çalıştırmaz. GPTBot, PerplexityBot ve benzerleri sayfanın ham HTML’ini alır. Yapılandırılmış veriniz yalnız tarayıcıda oluşuyorsa, o botlar için o veri hiç yoktur. Bu yüzden JSON-LD sunucu tarafında basılmalıdır.
Yaygın sözdizimi hataları
- Kaçırılmamış tırnak. Ürün açıklamasındaki bir çift tırnak JSON’u bozar; blok tamamen yok sayılır.
- Sayı yerine metin.
"price": "450,00"— virgüllü ondalık ve TL işareti geçersizdir. Doğrusu"450.00". - Sondaki fazla virgün. JSON’da son elemandan sonra virgül olmaz.
- Boş dizi bırakmak. İçi boş bir
FAQPagebloğu geçersiz yapısal veridir; blok hiç yazılmamalı.
Bu hataların ortak özelliği sessiz olmalarıdır: sayfa normal görünür, yalnız veri yok sayılır. Bu yüzden üretim otomatikse doğrulama da otomatik olmalıdır.
İlgili
Yapılandırılmış veri nedir? · Schema markup nasıl eklenir? · Zengin sonuçlar