Üç format
| Format | Yerleşim | Durum |
|---|---|---|
| JSON-LD | Ayrı betik bloğu | Önerilen |
| Mikroveri | HTML etiketlerine gömülü | Destekleniyor |
| RDFa | HTML etiketlerine gömülü | Destekleniyor |
Üçü de aynı Schema.org sözlüğünü kullanır; fark yalnızca yazım biçimidir.
Karşılaştırma
MİKROVERİ (HTML içine gömülü):
<div itemscope itemtype="https://schema.org/Product">
<h1 itemprop="name">Ürün Adı</h1>
<span itemprop="price">1250</span>
</div>
JSON-LD (ayrı blok):
<script type="application/ld+json">
{ "@type": "Product",
"name": "Ürün Adı",
"price": "1250" }
</script>
JSON-LD neden tercih edilir?
- İçerikten ayrıdır. HTML yapısını değiştirmeden eklenir
- Yönetimi kolaydır. Tek bir blokta toplanır
- Tasarımdan bağımsızdır. Tema değişimi etkilemez
- Etiket yöneticisiyle eklenebilir
- Hata ayıklaması basittir
Mikroveri ne zaman karşınıza çıkar?
- Eski sistemlerde ve temalarda
- Bazı hazır e-ticaret altyapılarında
- Eski eklentilerin ürettiği işaretlemede
- Bazı içerik yönetim sistemi şablonlarında
Mevcut mikroveri işaretlemesi çalışıyorsa değiştirmek zorunlu değildir.
Kritik sorun: çakışma
En sık karşılaşılan hata, aynı sayfada hem tema kaynaklı mikroveri hem eklenti kaynaklı JSON-LD bulunmasıdır. Sonuç:
- Çelişkili bilgiler
- Aynı varlığın iki kez tanımlanması
- Doğrulama hataları
- Zengin sonucun gösterilmemesi
Çakışma kontrolü
- Sayfayı test aracıyla kontrol edin
- Kaç tane aynı türde varlık algılandığına bakın
- Birden fazlaysa kaynağını bulun (tema mı, eklenti mi?)
- Birini devre dışı bırakın
- Yeniden doğrulayın
Bu kontrol, "şema ekledim ama zengin sonuç çıkmıyor" sorununun en yaygın çözümüdür.
Karar önerisi
- Yeni kurulumda: JSON-LD kullanın
- Mevcut mikroveri varsa ve çalışıyorsa: Dokunmayın
- İkisi birlikte varsa: Birini kaldırın
- Yenileme yapıyorsanız: JSON-LD'ye geçin
Ne anlama gelir?
Mikroveri ve RDFa (Microdata and RDFa), yapısal veriyi (schema) bir web sayfasına eklemenin iki farklı biçimlendirme yöntemidir. Yapısal veri, arama motoruna sayfanın içeriğini (ürün, tarif, etkinlik vb.) anlatan işaretlemedir; mikroveri ve RDFa ise bu işaretlemenin doğrudan HTML etiketlerinin içine gömülerek yazıldığı iki söz dizimidir. Günümüzde Google'ın önerdiği yöntem JSON-LD olsa da, mikroveri ve RDFa hâlâ desteklenen ve kullanımda olan alternatiflerdir.
Üç yöntem
- JSON-LD: Google'ın önerdiği, koddan ayrı yazılan modern yöntem
- Mikroveri: Yapısal veriyi HTML etiketleri içine gömer
- RDFa: Benzer biçimde HTML'e gömülü, esnek bir standart
Hangisi ne zaman?
Mikroveri ve RDFa'nın ortak özelliği, işaretlemeyi doğrudan görünen HTML içeriğinin içine yerleştirmeleridir; bu, içerik ile işaretlemenin iç içe geçmesi anlamına gelir. Bu yaklaşım işe yarar ama HTML'i karmaşıklaştırabilir ve bakımı zorlaştırabilir. Bu yüzden Google, işaretlemeyi görünen içerikten ayrı bir blok halinde yazan JSON-LD yöntemini önerir; JSON-LD daha temiz, yönetimi kolay ve hataya daha az açıktır. Yine de mevcut bir sitede mikroveri veya RDFa zaten kullanılıyorsa, bunlar hâlâ geçerli ve desteklenmeye devam eder; her şeyi JSON-LD'ye çevirmek zorunlu değildir. Yeni projeler için ise JSON-LD tercih edilmelidir. Önemli olan, hangi yöntem kullanılırsa kullanılsın, yapısal verinin doğru ve sayfadaki gerçek içerikle tutarlı olmasıdır. Bu üç yöntemi tanımak, bir sitenin mevcut işaretlemesini anlamak ve doğru kararı vermek için gereklidir.
Gerçek örnek
Bir sitenin ürün sayfaları eski mikroveri işaretlemesiyle kurulmuştu ve bakımı zordu; her tasarım değişikliğinde işaretleme bozuluyordu. Ürün yapısal verisi, koddan ayrı ve yönetimi kolay JSON-LD biçimine taşındığında, işaretleme daha sağlam ve bakımı kolay hale geldi; zengin sonuçlar korunurken kod sadeleşti.
Özet
Mikroveri ve RDFa, yapısal veriyi HTML etiketleri içine gömerek yazan iki yöntemdir. İşe yararlar ama HTML'i karmaşıklaştırır. Google, koddan ayrı ve temiz olan JSON-LD'yi önerir; mevcut mikroveri/RDFa desteklenir ama yeni projeler için JSON-LD tercih edilmelidir.