Yapılandırılmış Veri (Schema) Kodlama Hataları

Written by: admin
Nisan 22, 2026
Comments: (0)

Arama motoru sonuç sayfalarında (SERP) yıldızlı değerlendirmeler, ürün fiyatları veya SSS (Sıkça Sorulan Sorular) bölümlerini görmüşsünüzdür. Bunlar tesadüf değil, Yapılandırılmış Veri (Schema Markup) kullanımının bir sonucudur. Ancak bir SEO uzmanı için Schema, sadece zengin sonuçlar (rich snippets) elde etmek değil, Googlebot’a sayfanın ne hakkında olduğunu matematiksel bir netlikte anlatmaktır.

Kodlamadaki en ufak bir hata, sadece zengin sonuçların kaybolmasına değil, Google’ın sitenize olan güveninin sarsılmasına da neden olabilir. Bu rehberde, indeksleme ve görünürlüğü baltalayan kritik Schema hatalarını ve doğru yapılandırma stratejilerini inceleyeceğiz.

1. Yapılandırılmış Veri Nedir? Neden JSON-LD?

Yapılandırılmış veri, bir sayfanın içeriğini standardize edilmiş bir formatta (Schema.org) etiketleme yöntemidir. Google, geçmişte kullanılan Microdata veya RDFa yerine, yönetimi ve hata tespiti çok daha kolay olan JSON-LD formatını şiddetle tavsiye eder.

Doğru JSON-LD Örneği:

JSON

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Profesyonel SEO Danışmanlığı",
  "provider": {
    "@type": "LocalBusiness",
    "name": "Selinöz Yapı"
  }
}

2. En Sık Yapılan Kritik Schema Hataları

Yapılandırılmış veri uygularken yapılan hatalar genellikle “teknik yazım yanlışları” ve “politik ihlaller” olarak ikiye ayrılır.

A. Sözdizimi (Syntax) Hataları: Bir Virgülün Bedeli

JSON-LD kodunda yapılan en küçük noktalama hatası, tüm kodun geçersiz sayılmasına neden olur.

Eksik Virgüller: Özellikler arasına virgül koymamak.
Tırnak İşaretleri: Akıllı tırnak (“ ”) kullanmak yerine standart düz tırnak (” “) kullanmamak.
Parantez Uyumsuzluğu: Açılan süslü parantezlerin { } kapatılmaması.

B. Görünmez İçerik Hatası (Spammy Schema)

Google’ın en katı kuralı şudur: Schema kodunda belirttiğiniz bilgi, kullanıcı tarafından sayfa üzerinde fiziksel olarak görülebilir olmalıdır.

Hata: Sayfada SSS bölümü olmamasına rağmen arka planda FAQPage schema kodu eklemek.
Sonuç: Google tarafından “Yapılandırılmış veri politikası ihlali” uyarısı ve manuel işlem (ceza) riski.

C. Yanlış Şema Türü Seçimi

İçeriğinizle örtüşmeyen bir şema türü kullanmak botların kafasını karıştırır.

Örnek: Bir blog yazısı için Product (Ürün) şeması kullanmak veya genel bir hizmet sayfası için Article şeması tanımlamak.
Düzeltme: İçeriğiniz bir hizmet ise Service, bir inşaat projesi ise CreativeWork veya LocalBusiness alt türlerini seçmelisiniz.

D. Zorunlu Alanların (Required Properties) Eksikliği

Her şema türünün Google tarafından “zorunlu” kıldığı alanlar vardır. Örneğin bir Product şemasında name veya offers (fiyat bilgisi) eksikse, o sayfa zengin sonuçlarda asla görünmez.

Uyarı: Google Search Console’da “Kritik hata” olarak görünen bu eksiklikler öncelikli olarak düzeltilmelidir.

3. E-A-T ve Schema İlişkisi

Google’ın E-A-T (Uzmanlık, Yetkinlik, Güvenilirlik) kriterlerini desteklemek için Schema harika bir araçtır. Özellikle Person ve Organization şemalarıyla; yazarın kim olduğunu, ödüllerini ve sosyal medya profillerini sameAs özelliğiyle Google’a bağlayabilirsiniz. Bu, botların “bu içeriği yazan kişi gerçekten bir uzman” demesini sağlar.

4. Çoklu Şema Çakışmaları ve Hiyerarşi

Bir sayfada birden fazla şema türü kullanabilirsiniz, ancak bunları bir hiyerarşi içinde (Nested Schema) sunmak en doğrusudur.

Hatalı Yaklaşım: Sayfada birbirinden bağımsız 5 farklı JSON-LD bloğu açmak.
Doğru Yaklaşım: Bir WebPage şeması içinde mainEntity olarak asıl konuyu (örneğin bir ArchitectureProject) tanımlamak.

5. Schema Kodlama Hataları Nasıl Denetlenir?

Kodunuzu yayına almadan önce şu üç aşamalı kontrolü mutlaka yapmalısınız:

Zengin Sonuçlar Testi (Rich Results Test): Google’ın resmi aracıdır. Kodun zengin sonuçlara uygun olup olmadığını söyler.
Schema Markup Validator: Schema.org’un kendi aracıdır. Kodun teknik doğruluğunu denetler.
Search Console “Sorgu” Raporları: Sitenizdeki tüm sayfaların şema sağlığını toplu olarak buradan izleyebilirsiniz.

6. Stratejik Tavsiyeler

Dinamik Veri Kullanın: Fiyatlar veya stok durumları değiştikçe Schema kodunuzun da otomatik güncellendiğinden emin olun (WordPress kullanıyorsanız RankMath veya Yoast bu konuda iyidir).
Local SEO’yu Unutmayın: Eğer fiziksel bir ofisiniz varsa, LocalBusiness şemasına geo (koordinat) ve openingHours bilgilerini mutlaka ekleyin.

Sonuç: Yapılandırılmış veri, arama motorlarına sağlanan bir “kılavuzdur.” Bu kılavuzdaki hatalar, botların sitenizi yanlış kategorize etmesine neden olur. Kodunuzu temiz, hiyerarşik ve dürüst tutmak, SEO’daki rekabet gücünüzü artıracaktır.

Mimarlık ve inşaat gibi görsel ve proje tabanlı bir sektörde, projeleriniz için ImageObject ve VideoObject şemalarını kullanarak Google Görseller’de “Ürün/Proje” etiketiyle çıkmayı denediniz mi? Bu, sektörel otoriteyi artırmak için oldukça etkili bir yöntemdir.

admin

İletişim Bilgilerimiz