İçeriğe geç
TR · ₺
Panele Giriş Paket Al
Teknik SEO

Yapısal Veri (Schema.org, JSON-LD) Rehberi: Nasıl Eklenir?

6 dakika okuma

Yapısal veri (schema.org işaretlemesi), bir sayfanın içeriğini arama motorlarına standart bir sözlükle açıkça anlatma yöntemidir: bu bir makale, şu bir ürün, bu da bir işletmenin adres bilgisi. Google yapısal veriyi sayfanızı daha doğru anlamak ve uygun olduğunda arama sonuçlarında zengin biçimde (breadcrumb, ürün fiyatı, değerlendirme yıldızı gibi) göstermek için kullanır. Bu rehberde schema.org ve JSON-LD'nin ne olduğunu, hangi türlerin gerçekten işe yaradığını, nasıl ekleneceğini ve nasıl test edileceğini adım adım anlatıyoruz.

Yapısal veri nedir?

Bir insan "199,90 TL" yazısını görünce bunun fiyat olduğunu anlar; bir bot ise bunu ancak bağlamdan tahmin eder. Yapısal veri bu tahmini ortadan kaldırır. schema.org, Google, Microsoft ve diğer arama motorlarının birlikte geliştirdiği ortak sözlüktür; yüzlerce tür (Article, Product, Organization, Event, Recipe...) ve her türün özellikleri (name, price, author...) tanımlar.

Önemli bir gerçek: yapısal veri doğrudan bir sıralama faktörü değildir. Sayfanızı yukarı taşımaz. Katkısı iki yoldan gelir: içeriğin daha iyi anlaşılması ve zengin sonuç görünümü kazanma ihtimali. Daha dikkat çekici görünen bir sonuç tıklanma oranını artırabilir; bu da dolaylı bir kazançtır (tıklanma oranı üzerine CTR artırma rehberimizi inceleyebilirsiniz).

Neden JSON-LD?

Yapısal veri üç biçimde yazılabilir: JSON-LD, Microdata ve RDFa. Google JSON-LD'yi önerir. Sebebi basit: JSON-LD, sayfa içeriğinin arasına serpiştirilmez; ayrı bir <script type="application/ld+json"> bloğunda durur. Bu sayede tasarımdan bağımsız yönetilir, bakımı kolaydır ve hata riski daha düşüktür. Blok, sayfanın <head> ya da <body> bölümüne konabilir.

Hangi türler işe yarar?

Her sayfa için her türü eklemeye gerek yok. Önemli olan, sayfanın gerçekten ne olduğuna uyan türü seçmektir. Aşağıdaki tablo yaygın durumları özetler:

TürHangi sayfada?Ne sağlar?
OrganizationAna sayfa / hakkımızdaMarka adı, logo, resmî profiller; kuruluşun net tanımlanması
Article / BlogPostingBlog ve haber yazılarıBaşlık, yazar, tarih bilgisinin netleşmesi
BreadcrumbListİç sayfalarSonuçta adres yerine yol izi (kategori > alt kategori) gösterimi
Product + OfferÜrün sayfalarıFiyat, stok, değerlendirme gibi ürün zengin sonuçları
LocalBusinessYerel işletme sayfasıAdres, çalışma saatleri, telefon; yerel görünürlüğe destek
Event, Recipe, JobPostingİlgili içerik sayfalarıEtkinlik, tarif, iş ilanı gibi özel zengin sonuçlar

Zengin sonuç desteği zamanla değişir. Google, 2023'te SSS (FAQ) zengin sonucunu yalnız tanınmış devlet ve sağlık sitelerine bıraktı; HowTo zengin sonucunu ise tamamen kaldırdı. Bu işaretlemeleri eklemek zarar vermez ama çoğu sitede sonuçta görünüm değişmez. Güncel desteklenen türlerin listesini her zaman Google Search Central galerisinden kontrol edin.

Yerel işletmeyseniz LocalBusiness işaretlemesi, Google İşletme Profili ve haritalardaki görünürlükle birlikte düşünülmelidir; konunun tamamı için yerel SEO rehberimize bakın.

Örnek: Article ve Organization işaretlemesi

Bir blog yazısı için temel bir JSON-LD bloğu şöyle yazılabilir. Alan adlarını ve değerleri kendi sayfanıza göre değiştirin:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Canonical etiketi nedir?",
  "datePublished": "2026-11-06",
  "dateModified": "2026-11-06",
  "author": {
    "@type": "Person",
    "name": "Ayşe Yılmaz"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Örnek A.Ş.",
    "logo": {
      "@type": "ImageObject",
      "url": "https://www.ornek.com/logo.png"
    }
  },
  "mainEntityOfPage": "https://www.ornek.com/blog/canonical-etiketi-nedir"
}
</script>

Buradaki @context sözlüğün schema.org olduğunu, @type ise nesnenin türünü belirtir. Alanların hepsi sayfada görünen bilgiyle uyumlu olmalıdır: sayfada yazar adı yoksa bloğa uydurma bir yazar koymayın. Kurumsal sitenin ana sayfasında benzer şekilde Organization türüyle ad, logo ve resmî sosyal medya adresleri (sameAs) verilebilir. Yazar ve kurum güvenilirliğini sayfada da görünür kılmak için E-E-A-T rehberimize göz atın.

Yol izi (breadcrumb) için kullanılan BreadcrumbList işaretlemesi ise sıralı öğeler listesidir:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Blog",
      "item": "https://www.ornek.com/blog"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Teknik SEO"
    }
  ]
}
</script>

Son öğe (içinde bulunulan sayfa) için item adresi isteğe bağlıdır. Her öğe, sayfadaki görünür yol izi ile aynı sırada ve aynı adlarla olmalıdır.

Ürün sayfalarında Product türünün içine offers (fiyat, para birimi, stok durumu) ve gerçek kullanıcı değerlendirmeleri varsa aggregateRating eklenir. Burada kural çok nettir: fiyat ve stok bilgisi sayfada görünenle aynı olmalı, puan ise gerçek ve doğrulanabilir müşteri yorumlarından gelmelidir. Eski fiyatı gösteren bir işaretleme, kullanıcıyı yanıltır ve Search Console'da uyarıya dönüşür.

Adım adım uygulama planı

  1. Sayfa türlerini çıkarın. Sitenizde kaç farklı şablon var? Ana sayfa, kategori, ürün, yazı, iletişim gibi. Her şablon için tek bir işaretleme planı yeterlidir.
  2. Her şablona uygun türü eşleyin. Yukarıdaki tablodan yararlanın; emin olmadığınız türü eklemeyin.
  3. Şablon kodunda dinamik üretin. Başlık, tarih, fiyat gibi alanları veritabanından doldurun; elle yazılan sabit değerler zamanla eskir.
  4. Üç-beş örnek sayfayı test edin. Hata yoksa yaygınlaştırın.
  5. Search Console'da izleyin. Yayınlandıktan sonra geçerli ve hatalı sayfa sayılarına bakın, uyarıları öncelik sırasına koyun.

Google'ın temel kuralları

  1. İşaretleme görünür içerikle uyumlu olmalı. Sayfada olmayan fiyat, puan veya yorum eklemek Google'ın spam politikalarını ihlal eder ve manuel işlem riski taşır.
  2. Doğru türü kullanın. Ürünü olmayan bir sayfaya Product, gerçek bir değerlendirme olmadan AggregateRating eklemeyin.
  3. Gerekli özellikleri doldurun. Her zengin sonuç türünün zorunlu ve önerilen alanları vardır; zorunlu alan eksikse sonuç gösterilmez.
  4. Sayfa taranabilir olmalı. robots.txt ile engellenen ya da noindex olan sayfadaki işaretleme kullanılmaz.
  5. Yapısal veri garanti vermez. Geçerli olması zengin sonucun görüneceği anlamına gelmez; Google gösterip göstermeyeceğine kendisi karar verir.

Bir işaretlemenin ne kadar ayrıntılı olacağı sizin kararınızdır, ancak gereksiz derinliğe inmeye gerek yoktur. Bir makale için başlık, yazar, yayın ve güncelleme tarihi, görsel ve yayıncı bilgisi çoğu zaman yeterlidir. Yeni özellik eklemeden önce o özelliğin Google belgelerinde bir karşılığı olup olmadığına bakın; karşılığı yoksa eklemek sonuca etki etmez.

Test ve doğrulama

Yayına almadan önce ve sonra iki aşamalı kontrol yapın:

  • Google Zengin Sonuç Testi: Adres ya da kod yapıştırarak sayfanın hangi zengin sonuçlara uygun olduğunu, hata ve uyarıları görürsünüz.
  • Schema Markup Validator (validator.schema.org): Google'a özgü olmayan, genel schema.org sözdizimini doğrular.
  • Search Console → Geliştirmeler: Siteniz için bulunan türlerin geçerli, uyarılı ve hatalı sayfa sayılarını izler. Yeni bir tür eklediyseniz birkaç gün sonra raporun görünmesini bekleyin.
  • URL Denetimi: Canlı sayfanın Google tarafından işlenmiş sürümünde işaretlemenin bulunduğunu doğrular; özellikle JavaScript ile eklenen bloklarda faydalıdır.

Search Console'u henüz kurmadıysanız başlangıç rehberimizi izleyin. Yapısal veri, teknik sağlık kontrolünün parçasıdır; diğer kalemler için teknik SEO kontrol listemizi kullanın.

Sık yapılan hatalar

  • Görünmeyen içeriği işaretlemek. Kullanıcının göremediği bilgi, işaretlemede de yer almamalıdır.
  • Sahte yorum veya puan eklemek. Gerçek kullanıcıdan gelmeyen, sizin yazdığınız değerlendirmeleri işaretlemek politika ihlalidir.
  • Eklentiyle gelen kopya bloklar. Tema ve SEO eklentisi aynı Article işaretlemesini iki kez üretiyorsa çakışma olur; yalnız birini bırakın.
  • Hatalı JSON. Eksik virgül, tırnak ya da süslü parantez tüm bloğu geçersiz kılar. Doğrulayıcıdan geçirmeden yayınlamayın.
  • Eskimiş bilgi. Fiyat, stok veya etkinlik tarihi değiştiği halde işaretleme güncellenmezse Search Console uyarı verir ve kullanıcı güveni zedelenir.
  • Gereksiz abartı. Zengin sonucu olmayan türlerle sayfayı doldurmak vakit kaybıdır; önce sitenizin gerçekten ihtiyaç duyduğu üç-beş türe odaklanın.

Sık sorulan sorular

Yapısal veri sıralamamı yükseltir mi?

Doğrudan hayır. İçeriğin anlaşılmasına ve zengin sonuç alma ihtimaline yardım eder; bu da dolaylı olarak tıklanma oranını etkileyebilir.

Hangi eklentiyi veya aracı kullanmalıyım?

CMS'nizin SEO eklentisi temel türleri otomatik üretir; çoğu site için yeterlidir. Özel türler için JSON-LD'yi elle veya şablon koduyla ekleyin ve her zaman doğrulayıcıdan geçirin.

JSON-LD'yi JavaScript ile eklemek sorun olur mu?

Google JavaScript ile eklenen JSON-LD'yi işleyebilir, ancak mümkünse sunucu tarafında ilk HTML yanıtına koymak daha güvenilirdir.

Hata aldım, zengin sonuç hemen kaybolur mu?

Geçerli olmayan ya da politikaya aykırı işaretleme zengin sonuç görünümünü kaybettirebilir. Hatayı düzeltip Search Console'dan doğrulamayı başlatın; yeniden değerlendirme zaman alır.

Sonuç

Yapısal veri hızlı kazanç vaat eden bir hile değil, içeriğinizi doğru tanıtmanın düzenli bir yoludur. JSON-LD kullanın, yalnız sayfada gerçekten bulunan bilgiyi işaretleyin, doğrulayıcılarla test edin ve Search Console'da düzenli izleyin. Başlangıç için ana sayfaya Organization, yazılara Article, iç sayfalara BreadcrumbList, ürünlere Product eklemek çoğu site için yeterlidir. Kalan zamanınızı içerik kalitesine ve hıza ayırın.

Anahtar kelimenizde tıklama mı eksik?

HitBot, hedeflediğiniz kelimede arama yapıp sitenizi bulan ve tıklayan gerçek oturumlar üretir. Sonuç Search Console'da gösterim ve tıklama olarak birikir.

Diğer yazılar