İçeriğe geç

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.

2 dk okumaOrta seviyeGeçerlilik dönemi: 2026 Eylül itibarıyla
JSON-LD'de @context eksik: yapılandırılmış veri neden tanınmıyor? — editoryal kapak görseli

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.
Eksik @context: yanlış ve doğru uygulamanın karşılaştırması
Eksik @context: sorunlu durum ve doğru uygulama yan yana.

Adım adım çözüm

  1. Her <script type="application/ld+json"> bloğunun en üst düzey nesnesine "@context": "https://schema.org" ekleyin.
  2. Birden fazla öğeyi tek blokta veriyorsanız @graph dizisi ve tek bir @context kullanın.
  3. Yazım hatalarını düzeltin (context yerine @context, http yerine https).
  4. Ş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.

Eksik @context için düzeltme örneği
Tek bağlam altında birden fazla öğe.

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

  1. Google Search Central — Yapılandırılmış veriye giriş
  2. Schema.org — Başlangıç rehberi
  3. Google — Zengin Sonuçlar Testi (Rich Results Test)

Paylaş