Schema (yapısal veri) nedir ve JSON-LD ile nasıl eklenir?

Bir insan ürün sayfanıza baktığında fiyatın 1.299 TL olduğunu, ürünün stokta bulunduğunu ve 4,6 puan aldığını hemen anlar. Arama motorları ise bu bilgileri sayfa düzeninden tahmin etmek zorundadır. Yapısal veri (structured data), bu bilgileri Schema.org adlı ortak sözlükle makinece okunabilir şekilde yazmaktır. En yaygın ve Google’ın önerdiği format JSON-LD’dir.

Yapısal veri ne işe yarar?

• Zengin sonuçlar (rich results): Ürün fiyatı, stok durumu, değerlendirme yıldızları, etkinlik tarihleri, tarifler gibi görsel zenginleştirmeler.
• Varlık anlayışı: İşletmenizin adını, logosunu, adresini ve sosyal profillerini arama motorlarının doğru eşleştirmesi.
• Diğer sistemler: Bing, Yandex ve web’i tarayan yapay zekâ tabanlı arama araçları da Schema.org işaretlemesini okuyabilir.

Yapısal veri sıralamayı doğrudan yükseltmez; ama arama sonucunuzu daha çekici yaparak tıklama oranını artırabilir.

JSON-LD nasıl eklenir?

JSON-LD, sayfanın <head> veya <body> bölümüne eklenen bir <script> bloğudur ve görünür içeriği değiştirmez:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Örnek Yazılım A.Ş.",
  "url": "https://www.ornek.com",
  "logo": "https://www.ornek.com/img/logo.png",
  "sameAs": [
    "https://www.linkedin.com/company/ornek",
    "https://www.instagram.com/ornek"
  ]
}
</script>

Elle yazmak yerine schema oluşturucumuzla formu doldurup hazır JSON-LD kodu üretebilirsiniz. WordPress’te Yoast ve Rank Math temel türleri otomatik ekler.

En çok kullanılan türler

LocalBusiness (yerel işletme)

Kuaför, diş kliniği, restoran, oto servis gibi fiziksel adresi olan işletmeler için:

{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "name": "Gülüş Diş Kliniği",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Atatürk Cad. No: 12",
    "addressLocality": "Çankaya",
    "addressRegion": "Ankara",
    "postalCode": "06680",
    "addressCountry": "TR"
  },
  "telephone": "+90-312-000-00-00",
  "openingHours": "Mo-Sa 09:00-19:00",
  "url": "https://www.ornek.com"
}

Genel LocalBusiness yerine Dentist, Restaurant, AutoRepair gibi daha spesifik alt türleri kullanmak tercih edilir. Yerel görünürlüğün asıl kaynağı ise Google İşletme Profili’dir; schema onu tamamlar.

Product (ürün)

E-ticaret için en değerli türdür. Fiyat, para birimi, stok ve değerlendirme bilgisi içerir:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Seramik Kahve Kupası 350 ml",
  "image": "https://www.ornek.com/img/kupa.webp",
  "sku": "KP-350",
  "brand": { "@type": "Brand", "name": "Atölye X" },
  "offers": {
    "@type": "Offer",
    "price": "349.90",
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock",
    "url": "https://www.ornek.com/urun/kahve-kupasi"
  },
  "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.6", "reviewCount": "87" }
}

Fiyat, JSON’da nokta ondalık ayırıcıyla yazılır (349.90), Türkçe biçimle (349,90) değil. Değerlendirmeler sayfada gerçekten görünen, kullanıcıların yaptığı yorumlara dayanmalıdır.

Article (makale)

Blog yazıları ve haberler için başlık, yazar, yayın ve güncelleme tarihi bilgisi verir. datePublished ve dateModified değerlerinin sayfada görünen tarihlerle tutarlı olması önemlidir.

Örnek bir blog yazısı işaretlemesi:

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "KDV Nasıl Hesaplanır? 2026 Oranları",
  "image": "https://www.ornek.com/img/kdv-rehberi.jpg",
  "datePublished": "2026-03-10",
  "dateModified": "2026-10-01",
  "author": { "@type": "Person", "name": "Ayşe Yılmaz" },
  "publisher": { "@type": "Organization", "name": "Örnek Muhasebe" }
}

BreadcrumbList (içerik haritası)

Sayfanın site hiyerarşisindeki yerini (Ana Sayfa › Kategori › Ürün) tanımlar. Google’ın sayfanızın yapısını anlamasına yardımcı olur.

Örnek:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Ana Sayfa", "item": "https://www.ornek.com/" },
    { "@type": "ListItem", "position": 2, "name": "Mutfak", "item": "https://www.ornek.com/mutfak" },
    { "@type": "ListItem", "position": 3, "name": "Kahve Kupaları" }
  ]
}

Son öğe bulunduğunuz sayfadır ve item adresi verilmeyebilir. İçerik haritası işaretlemesinin, sayfada kullanıcıya görünen gezinme yoluyla aynı olması gerekir.

Hangi türü nereye eklemeli?

Her sayfaya mümkün olan her türü eklemek yerine, sayfanın asıl içeriğini doğru anlatan birkaç türle yetinin. Fazla ve alakasız işaretleme fayda sağlamaz, bakımını zorlaştırır.

2026 itibarıyla Google’da güncel durum

Google son yıllarda arama sonuçlarını sadeleştirirken bazı zengin sonuç türlerini kaldırdı. Önemli değişiklikler:

Google’ın desteklediği türler zamanla değişebileceği için güncel listeyi Google Search Central belgelerinden kontrol edin. Desteği kaldırılan işaretlemeleri silmek zorunda değilsiniz; geçerli Schema.org kodu zarar vermez, yalnızca Google aramada görsel bir etki yaratmaz.

Test etme ve hata ayıklama

1. Google Rich Results Test: Sayfanın hangi zengin sonuçlara uygun olduğunu ve hataları gösterir.
2. Schema Markup Validator (validator.schema.org): Google’a özel olmayan, genel Schema.org söz dizimi kontrolü yapar.
3. Search Console → Geliştirmeler: Sitenizdeki yapısal veri hatalarını ve uyarılarını toplu olarak listeler.
4. Sayfa analizi: SEO analiz aracımız sayfada JSON-LD bulunup bulunmadığını ve temel meta etiketleri birlikte gösterir.

Sık yapılan hatalar

• Sayfada olmayan bilgiyi işaretlemek: Görünmeyen yorumlar veya sahte puanlar Google yönergelerine aykırıdır ve manuel işleme yol açabilir.
• Tüm sayfalara aynı Product veya Review kodunu eklemek.
• Eksik zorunlu alanlar: Product için offers, review veya aggregateRating’den en az biri gerekir.
• Yanlış fiyat biçimi veya para birimi: "price": "1.299,00" yerine "price": "1299.00" ve "priceCurrency": "TRY".
• Bozuk JSON: Eksik virgül veya tırnak tüm bloğu geçersiz kılar.

Kontrol listesi

• Ana sayfada Organization (veya LocalBusiness) işaretlemesi var
• Ürün sayfalarında fiyat, para birimi ve stok bilgisi doğru
• Blog yazılarında Article ve tarih bilgisi tutarlı
• İşaretlenen her bilgi sayfada görünür
• Rich Results Test’te hata yok
• Search Console geliştirme raporları düzenli izleniyor

Arama sonucundaki başlık ve açıklamanızı da iyileştirmek için title ve meta description rehberimize göz atın.