Yapısal Veri (Schema) Hataları ve Çözümleri: Hata Giderme Rehberi

Sayfanıza yapısal veri (schema) eklediniz, doğru yaptığınızdan eminsiniz; ama aramada ne yıldız çıkıyor ne de zengin sonuç. Ya da Search Console bir sabah “Geçersiz öğe” bildirimiyle sizi karşılıyor ve mesajın ne anlama geldiğini kestiremiyorsunuz. Yapısal veride en yorucu kısım işaretlemeyi yazmak değil, bir şey ters gittiğinde nerede hata olduğunu bulmaktır.

Bu yazı tam olarak bunun için: yapısal verinin ne olduğunu baştan anlatan değil, hataları teşhis edip çözmeye odaklı bir hata giderme rehberi. Yapısal verinin temelleri ve nasıl ekleneceği için önce schema markup nedir yazısına göz atmanızı öneririm; burada varsayımımız işaretlemeyi zaten eklediğiniz ama beklediğiniz sonucu alamadığınızdır.

Önce Netleştirelim: “Hata” mı, “Uyarı” mı?

Doğrulama araçlarının verdiği geri bildirimleri iki kovaya ayırmadan hiçbir sorunu doğru önceliklendiremezsiniz. Google’ın araçları iki tür sorun gösterir ve ikisi tamamen farklı şeydir:

Kısacası: bir hata öğenizi tümden devre dışı bırakır; bir uyarı ise “bunu da eklersen daha iyi olur” demektir. Search Console’da yüzlerce “uyarı” görüp panikleyen çok kişi tanıdım; oysa asıl kovalanması gereken kırmızı “hata” satırlarıdır.

Hangi Aracı Ne Zaman Kullanmalısınız?

Yanlış aracı kullanmak, en sık yapılan görünmez hatadır. Üç araç vardır ve üçü farklı soruya cevap verir:

• Rich Results Test (Zengin Sonuçlar Testi): “Bu sayfa Google’da zengin sonuç için uygun mu?” sorusunu yanıtlar. Yalnızca Google’ın desteklediği türleri (Product, Recipe, Breadcrumb, Article vb.) tanır. Desteklemediği bir türü doğru yazsanız bile “algılanabilir öğe yok” der; bu bir hata değildir.
• Schema Markup Validator (validator.schema.org): “İşaretlemem schema.org söz dizimine ve kelime dağarcığına uygun mu?” sorusunu yanıtlar. Google desteği umurunda değildir; saf sözdizimi ve geçerlilik denetimi yapar. Bir tür Rich Results Test’te görünmüyorsa, gerçekten geçersiz mi yoksa sadece Google tarafından desteklenmiyor mu ayırt etmek için buraya bakın.
• Search Console, Geliştirmeler bölümü: Yukarıdaki ikisi tek sayfayı anlık test eder. Search Console ise Google’ın sitenizde gerçekten taradığı canlı verinin toplu raporudur. Tek sayfa değil, tüm sitede hangi türde kaç geçerli/hatalı öğe olduğunu ve zaman içindeki değişimini gösterir.

En Sık Yapılan Yapısal Veri Hataları ve Çözümleri

Aşağıdaki sekiz başlık, denetimlerde en çok karşıma çıkan hatalar. Her biri için önce belirtiyi, sonra hatalı ve düzeltilmiş işaretlemeyi vereceğim. Örnekleri JSON-LD ile veriyorum; Google’ın da önerdiği yöntem budur.

1. Ayrıştırılamayan Yapısal Veri (Unparsable Structured Data)

Bu, Google’ın işaretlemeyi hiç okuyamadığı, yani JSON’un bozuk olduğu durumdur. Genellikle tek bir eksik virgül veya kapanmayan bir süslü paranteze bağlıdır ve tüm işaretlemeyi çöpe atar.

Hatalı

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Ergonomik Ofis Koltuğu"   <-- virgül eksik
  "brand": "Konfor"
}

Doğru

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Ergonomik Ofis Koltuğu",
  "brand": "Konfor"
}

En sinsi varyantı, tema veya eklentinin tırnak işaretlerini “akıllı tırnağa” (” “) çevirmesidir. JSON yalnızca düz çift tırnak (“) kabul eder. Bir de dizgi içinde kaçırılmamış tırnak sorunu vardır: metinde tırnak geçiyorsa " biçiminde kaçırılmalıdır; aksi halde “Bad escape sequence” hatası alırsınız.

2. Yanlış Değer Türü (Incorrect Value Type)

İşaretleme geçerli görünür ama bir alana beklenen türden farklı bir değer verirsiniz. En klasiği fiyattır: Google fiyatı para birimi sembolü ve binlik ayraç olmadan, düz sayı olarak bekler.

Hatalı

"offers": {
  "@type": "Offer",
  "price": "1.499,90 TL",
  "priceCurrency": "Türk Lirası"
}

Doğru

"offers": {
  "@type": "Offer",
  "price": "1499.90",
  "priceCurrency": "TRY"
}

Aynı hata tarihlerde de olur: datePublished gibi alanlar ISO 8601 biçiminde (2026-07-24) olmalıdır, “24 Temmuz 2026” değil. Para birimi de her zaman üç harfli ISO kodudur (TRY, USD, EUR).

3. Zorunlu Alanların Eksik Olması (Missing Field)

Her schema türünün, zengin sonuca uygun sayılması için doldurulması gereken zorunlu alanları vardır. En sık takılınan yer Product’tur: bir ürünün zengin sonuç için ya offers, ya review ya da aggregateRating alanlarından en az birini taşıması gerekir.

Çözüm, ilgili türün Google dokümanındaki “zorunlu özellikler” listesine bakıp eksik alanı tamamlamaktır. Zorunlu alanı uyduramıyorsanız (örneğin gerçek bir yorum yoksa), o alanı boş geçmek yerine o zengin sonuç türünü hedeflemekten vazgeçin; sahte veriyle doldurmak bir sonraki maddedeki riski doğurur.

4. İşaretleme ile Sayfadaki İçeriğin Uyuşmaması

Bu bir sözdizimi hatası değil, bir politika ihlalidir ve en tehlikelisidir. İşaretlemede beyan ettiğiniz bilgi, sayfada kullanıcının gördüğü içerikle birebir aynı olmalıdır. Sayfada 4,2 puan görünürken schema’da 5,0 yazmak, sayfada olmayan bir fiyatı işaretlemek ya da kullanıcıya gösterilmeyen içeriği işaretlemek buna girer.

Kural basittir: işaretleme, sayfanın görünür içeriğinin bir kopyasıdır, süsü değil. Görünür kılmadığınız hiçbir şeyi işaretlemeyin.

5. Google’ın Artık Desteklemediği İşaretlemeler (FAQ ve HowTo)

Burası, eski rehberlerin çoğunun güncellenmediği ve insanların en çok “hata yok ama zengin sonuç da yok” diye takıldığı yerdir. Google, 2023’ten itibaren FAQ zengin sonuçlarını yalnızca sınırlı sayıda yetkili devlet ve sağlık sitesiyle sınırladı; HowTo zengin sonuçlarını ise tamamen kaldırdı.

Bunun pratik sonucu şu: FAQPage veya HowTo işaretlemeniz teknik olarak tamamen geçerli olabilir, Validator’da hata vermez; ama sıradan bir site için aramada artık açılır soru-cevap ya da adım görseli çıkmaz. Bu bir hata değil, bir politika değişikliğidir. İşaretlemeyi yazım hatası sanıp saatlerce “düzeltmeye” çalışmak boşa emektir.

6. Sahte veya Kendinden Menşeli Yorum İşaretlemesi

Yıldızlı sonuçların çekiciliği, birçok siteyi kendi kendine yorum uydurmaya itiyor. Google’ın politikası açıktır: bir işletmenin kendisi hakkında sitesine gömdüğü “kendinden menşeli” (self-serving) yorumlar için yıldız zengin sonucu gösterilmez. Ana sayfaya AggregateRating ile “4,9 / 2500 yorum” gömmek tipik bir örnektir ve genelde ya yok sayılır ya da ihlal olarak işaretlenir.

Yorum işaretlemesi, işaretlenen şey belirli bir ürün veya hizmet olduğunda ve yorumlar gerçekten toplandığında anlamlıdır. Kuruluşun kendisini kendi puanıyla işaretlemek değil.

7. Aynı İşaretlemeyi Her Sayfaya Kopyalamak

Sık görülen bir kolaycılık: tek bir schema bloğunu (çoğu zaman Organization veya bir Product) tema geneline gömüp her sayfada aynısını yayınlamak. Organization gibi kuruluş kimliği işaretlemesi tüm sitede tek bir varlığı tanımlar; her ürün ya da blog sayfasına ayrıca kopyalanması gereksizdir ve sayfanın gerçek içeriğiyle çelişir.

Doğru yaklaşım, işaretlemeyi sayfa türüne göre eşlemektir: kuruluş kimliği ve WebSite bilgisi site genelinde bir kez; her blog yazısında Article; her ürün sayfasında yalnızca o ürünün Product’ı; her sayfada kendi Breadcrumb’ı. İşaretleme, o sayfanın ne olduğunu anlatmalı; sitenin tamamını değil.

8. Mobil ve Masaüstü İşaretleme Tutarsızlığı

Google artık siteleri mobil öncelikli (mobile-first) indeksler; yani değerlendirmede esas aldığı, sayfanızın mobil sürümüdür. İşaretlemeniz masaüstü şablonda olup mobil şablonda düşüyorsa, doğrulama araçlarında (çoğu masaüstünü test eder) her şey yeşil görünürken Google gerçekte hiçbir işaretleme görmez.

Ayrı mobil sürüm ya da farklı bir mobil tema kullanıyorsanız, işaretlemenin iki sürümde de aynı ve eksiksiz olduğunu doğrulayın. Test ederken Rich Results Test’in mobil botla tarama sonucuna bakmak, bu tuzağı erken yakalar.

Adım Adım Hata Giderme Akışı

Bir yapısal veri sorunuyla karşılaştığınızda tahminle uğraşmak yerine şu sırayı izleyin. Bu akış, sorunu birkaç dakikada doğru katmanda yakalar:

1. Önce doğru araç: Sayfayı Rich Results Test’e girin. Hiç öğe algılanmadıysa, türü Validator’da doğrulayın; geçerliyse sorun “Google bu türü desteklemiyor” olabilir (bkz. FAQ/HowTo).
2. Hata mı, uyarı mı ayırın: Yalnızca kırmızı “hata” satırlarını hedefe alın. Uyarıları not edin ama önceliklendirmeyin.
3. Sözdizimi mi, mantık mı: Mesaj “parsing / escape / missing ‘,'” diyorsa sözdizimi hatasıdır; JSON’u bir doğrulayıcıdan geçirin. “Incorrect value type / missing field” diyorsa alan hatasıdır; türün zorunlu alan listesine bakın.
4. Sayfa-işaretleme uyumu: İşaretlemedeki her değerin sayfada görünür karşılığı var mı, elle kontrol edin. Yoksa değeri işaretlemeden çıkarın.
5. Canlıda doğrula ve bekle: Düzeltmeyi yayınlayın, Rich Results Test’i canlı URL’de tekrarlayın, sonra Search Console’daki ilgili raporda “Düzeltmeyi doğrula” deyin. Google’ın yeniden tarayıp raporu güncellemesi genelde birkaç gün ila iki hafta sürer; hemen sonuç beklemeyin.

Search Console “Geliştirmeler” Raporunu Doğru Okumak

Tekil test araçları anlık fotoğraf çeker; asıl sağlık takibi Search Console’daki Geliştirmeler bölümündedir. Burada Google’ın sitenizde bulduğu her desteklenen tür (Breadcrumb, Ürünler, Makaleler vb.) ayrı bir rapor olarak listelenir ve her öğe üç durumdan birindedir:

• Geçerli: Öğe sorunsuz; zengin sonuca uygun.
• Uyarı içeren geçerli: Öğe uygun ama önerilen bir alan eksik. Zengin sonuç çıkabilir; iyileştirme fırsatı.
• Hata: Zorunlu bir alan eksik/geçersiz; öğe uygun değil. Önce bunlar.

Bir hatayı düzelttikten sonra ilgili rapordaki “Düzeltmeyi doğrula” düğmesine basmak önemlidir: bu, Google’a o sayfaları öncelikli yeniden taramasını söyler ve sürecin ilerleyişini rapordan izleyebilirsiniz. Grafiğin sıfıra inmesini beklerken, aynı hatanın yeni yayınlanan sayfalarda tekrarlamadığından da emin olun; çünkü bu tür hatalar genelde şablon kaynaklıdır ve tek sayfada değil, o şablonu kullanan her sayfada birden ortaya çıkar. Search Console’un bütününü teknik SEO tarafıyla birlikte ele almak, kök nedeni bulmayı kolaylaştırır.

Yapısal Veri Hataları Hakkında Sık Sorulan Sorular

Yapısal veri hatası sıralamamı düşürür mü?

Sözdizimi hatası genelde sıralamayı doğrudan düşürmez; yalnızca o öğenin zengin sonucunu engeller, yani görsel avantajı kaybedersiniz. Asıl risk, sayfayla uyuşmayan veya politika ihlali içeren işaretlemededir; bu, elle uygulanan işleme ve tüm sitenin zengin sonuçlarının kapanmasına yol açabilir.

Search Console’da yüzlerce uyarı görüyorum, hepsini düzeltmeli miyim?

Hayır. Uyarılar önerilen alanların eksikliğini gösterir ve öğe hâlâ zengin sonuca uygundur. Önce kırmızı “hata” satırlarını çözün. Uyarıları ise zaman buldukça, tıklama oranını artırma potansiyeli yüksek türlerden başlayarak iyileştirin.

FAQ işaretlemem geçerli ama aramada soru-cevap çıkmıyor, neden?

Çünkü Google 2023’ten beri FAQ zengin sonuçlarını yalnızca sınırlı sayıda yetkili devlet ve sağlık sitesiyle sınırladı. İşaretlemeniz hatalı değil; sıradan siteler için bu zengin sonuç türü artık gösterilmiyor. İşaretlemeyi anlamsal netlik için tutabilirsiniz ama yıldız/açılır sonuç beklemeyin.

Zengin sonuç için hangi araca güvenmeliyim?

Google’ın desteğini test etmek için Rich Results Test, saf sözdizimi ve schema.org geçerliliği için Schema Markup Validator, sitenizin canlı ve toplu durumu için Search Console. Üçü farklı soruya cevap verir; biri diğerinin yerini tutmaz.

Düzelttim ama Search Console hâlâ hata gösteriyor?

Rapor, Google’ın son taradığı hali yansıtır; anlık değildir. Düzeltmeyi yayınladıktan sonra ilgili raporda “Düzeltmeyi doğrula” deyin ve Google’ın yeniden taramasını bekleyin. Bu süreç birkaç günden iki haftaya kadar sürebilir.

Eklenti ile eklediğim schema neden hata veriyor?

Genellikle iki eklentinin ya da tema ile eklentinin aynı türü ikişer kez üretmesinden veya eklentinin boş alanları eksik bırakmasından kaynaklanır. Sayfanın kaynağında aynı türden çift işaretleme olup olmadığını kontrol edin ve tek bir kaynağın sorumlu olmasını sağlayın.

İlgili Rehberler

Yapısal verinin temellerini ve nasıl ekleneceğini baştan görmek için schema markup nedir yazısına, işaretlemenin oturduğu teknik zemin için teknik SEO nedir rehberine ve genel görünürlük stratejisi için Google’da üst sıralara çıkmak yazısına göz atabilirsiniz.