Structured Data (Yapılandırılmış Veri) Rehberi

Yapılandırılmış veri (structured data), web sayfanızın içeriğini arama motorlarının daha iyi anlamasını sağlayan standart bir formattır. Google, Bing ve diğer arama motorları bu veriyi kullanarak zengin sonuçlar (rich snippets) — yıldızlı puanlar, SSS kutuları, tarif kartları, ürün bilgileri gibi — oluşturur. Bu rehberde Schema.org sözlüğünü ve JSON-LD formatını detaylıca inceliyoruz.

Schema.org ve JSON-LD Nedir?

Schema.org, Google, Microsoft, Yahoo ve Yandex tarafından ortaklaşa oluşturulan bir yapılandırılmış veri sözlüğüdür. Yüzlerce veri türü ve özellik tanımlar.

JSON-LD (JavaScript Object Notation for Linked Data), Google'ın önerdiği yapılandırılmış veri formatıdır. HTML'den bağımsız olarak <script> etiketine yerleştirilir:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Sayfa Başlığı",
  "description": "Sayfa açıklaması"
}
</script>

Microdata ve RDFa gibi alternatifler de var, ancak JSON-LD en kolay uygulanabilir ve bakımı yapılabilir format olduğu için tercih edilir.

Yaygın Schema Türleri

1. Article (Makale)

Blog yazıları ve haber makaleleri için kullanılır:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "CSS Flexbox Rehberi",
  "author": {
    "@type": "Person",
    "name": "Yazar Adı"
  },
  "datePublished": "2026-03-01",
  "dateModified": "2026-03-15",
  "image": "https://example.com/flexbox.jpg",
  "publisher": {
    "@type": "Organization",
    "name": "SiteScripti"
  }
}

2. FAQ (Sıkça Sorulan Sorular)

SSS sayfaları için kullanılır. Google, bu yapıyı arama sonuçlarında genişletilebilir SSS kutusu olarak gösterebilir:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Flexbox nedir?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Flexbox, CSS'te tek boyutlu düzenler oluşturmak için kullanılan bir layout modülüdür."
      }
    }
  ]
}

3. Product (Ürün)

E-ticaret sayfaları için fiyat, stok durumu ve değerlendirme bilgileri içerir:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Ürün Adı",
  "image": "https://example.com/urun.jpg",
  "offers": {
    "@type": "Offer",
    "price": "199.99",
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "127"
  }
}

4. BreadcrumbList (Ekmek Kırıntısı)

Sayfa hiyerarşisini gösterir. Google bunu arama sonuçlarında URL yerine gösterebilir:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Ana Sayfa",
      "item": "https://sitescripti.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://sitescripti.com/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Structured Data Rehberi"
    }
  ]
}

5. HowTo (Nasıl Yapılır)

Adım adım rehberler için kullanılır. Google arama sonuçlarında adımları sıralı olarak gösterebilir:

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Web Sitesine Schema.org Nasıl Eklenir",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Schema türünü seçin",
      "text": "Sayfanızın içeriğine uygun Schema.org türünü belirleyin."
    },
    {
      "@type": "HowToStep",
      "name": "JSON-LD kodunu oluşturun",
      "text": "Schema.org sözlüğüne uygun JSON-LD formatında veri oluşturun."
    },
    {
      "@type": "HowToStep",
      "name": "HTML'e ekleyin",
      "text": "Oluşturduğunuz kodu sayfanızın head veya body bölümüne ekleyin."
    }
  ]
}

Rich Snippets (Zengin Sonuçlar)

Yapılandırılmış veri eklediğinizde, Google arama sonuçlarında ek bilgiler gösterebilir:

• Yıldızlı puan ve değerlendirme sayısı (Product, Recipe, Review)
• Fiyat ve stok bilgisi (Product)
• SSS genişletme kutuları (FAQPage)
• Adım adım rehber (HowTo)
• Ekmek kırıntısı navigasyonu (BreadcrumbList)
• Etkinlik tarihi ve yeri (Event)

Önemli: Yapılandırılmış veri eklemek, zengin sonuçların garanti gösterileceği anlamına gelmez. Google kendi algoritmasına göre karar verir. Ancak doğru yapılandırılmış veri olmadan zengin sonuçlarda yer almanız mümkün değildir.

Sık Yapılan Hatalar

• Sayfada olmayan bilgiyi yapılandırılmış veride göstermek (spam olarak değerlendirilir)
• JSON-LD söz dizimi hataları (eksik virgül, tırnak)
• Yanlış Schema türü seçmek
• Zorunlu alanları atlamak
• Google'ın Rich Results Test aracı ile doğrulamamak