Rehber
JSON-LD'de @context eksik: yapılandırılmış veri neden tanınmıyor?
@context, JSON-LD'deki türlerin schema.org sözlüğünden geldiğini söyler. Eksik veya yanlış olduğunda Google verinizin ne anlama geldiğini bilemez. Doğru kullanımı anlatıyoruz.
JSON-LD bloğunuzda @type ve tüm özellikler doğru görünüyor ama doğrulayıcı hiçbir şey tanımıyor. En sık sebeplerden biri, verinin hangi sözlüğe ait olduğunu söyleyen @context satırının eksik olmasıdır.
KTYAPTECH SEO Analyzer bu sorunu SCHEMA-MISSING-CONTEXT-001 koduyla, “@context eksik” başlığı altında ve yüksek önem derecesiyle raporlar (Yapılandırılmış veri). Bu rehber, bulgunun ne anlama geldiğini, neden önemli olduğunu ve adım adım nasıl düzeltileceğini anlatıyor.
Eksik @context nedir?
@context, JSON-LD'de kullanılan terimlerin (Product, name, offers...) hangi sözlükten geldiğini belirtir. Google'ın yapılandırılmış veri özellikleri için bu değer "https://schema.org" olmalıdır.
SEO Analyzer, @context içermeyen veya tanınmayan bir bağlam kullanan en üst düzey düğümleri raporlar.
Neden önemli? SEO ve kullanıcı deneyimine etkisi
@context olmadan özellik adları anlamsız anahtarlardır; Google veriyi schema.org türleri olarak yorumlayamaz ve zengin sonuç uygunluğu kaybolur.
Sorun nasıl tespit edilir?
- SEO Analyzer raporundaki “@context eksik” bulgusunu inceleyin.
- JSON-LD bloklarının en üst düzeyinde "@context": "https://schema.org" satırını arayın.
- Zengin Sonuçlar Testi'nde öğenin algılanıp algılanmadığına bakın.
Adım adım çözüm
- Her <script type="application/ld+json"> bloğunun en üst düzey nesnesine "@context": "https://schema.org" ekleyin.
- Birden fazla öğeyi tek blokta veriyorsanız @graph dizisi ve tek bir @context kullanın.
- Yazım hatalarını düzeltin (context yerine @context, http yerine https).
- Şablon veya eklenti kaynaklı blokları kontrol edin.
@graph ile birden fazla öğe
Organization, WebSite, BreadcrumbList ve Article gibi birden fazla öğeyi tek blokta vermek için @graph dizisi kullanılabilir; @context bu durumda en üst düzeyde bir kez yazılır.
Sık yapılan hatalar
- Bağlamı yalnızca ilk blokta yazıp diğerlerinde unutmak.
- @context değerini protokolsüz veya yanlış yazmak.
Düzeltmeyi nasıl doğrularsınız?
- Zengin Sonuçlar Testi'nde öğelerin algılandığını görün.
- SEO Analyzer'ı yeniden çalıştırın.
Sık sorulan sorular
http://schema.org de çalışır mı?
Genellikle tanınır, ancak https://schema.org kullanmak önerilir.
İç içe nesnelerde tekrar @context yazmalı mıyım?
Hayır; en üst düzeyde bir kez yazmak yeterlidir.
Özet
Her JSON-LD bloğunun en üst düzeyinde "@context": "https://schema.org" bulunmalıdır. Birden fazla öğe için @graph kullanın ve yazım hatalarını düzeltin.
Sitenizde bu ve benzeri sorunların olup olmadığını görmek için KTYAPTECH Ücretsiz SEO Analizi aracını kullanabilirsiniz: rapordaki her bulgunun yanında, sorunu anlatan çözüm rehberine giden bir bağlantı bulunur.
Kategoriler
Etiketler
Kaynaklar
Paylaş
İlgili içerikler
URL'de büyük harf kullanmak SEO'ya zarar verir mi?
Adres yolları büyük-küçük harfe duyarlıdır: /Urunler ve /urunler farklı adreslerdir. Büyük harf kullanımının yarattığı yinelenen adres ve kırık bağlantı riskini anlatıyoruz.
2 dk okuma
Yazıyı okuSonda eğik çizgi (trailing slash): /sayfa ve /sayfa/ ikisi de açılıyorsa
Aynı sayfa hem eğik çizgili hem eğik çizgisiz adreste 200 dönüyorsa Google iki ayrı sayfa görür. Tek bir biçim seçip diğerini yönlendirmeyi anlatıyoruz.
3 dk okuma
Yazıyı okuÇok parametreli adresler: filtre ve sıralama URL'leri taramayı nasıl etkiler?
Renk, beden, fiyat ve sıralama filtreleri birleştikçe binlerce adres üretilir. Google bu adresleri taramaya çalışırken önemli sayfalarınıza sıra gelmeyebilir. Parametre yönetimini anlatıyoruz.
3 dk okuma
Yazıyı oku
