Yapısal Veri (Schema Markup) Rehberi: JSON-LD ile SEO ve GEO İçin Doğru Kurulum

Yapısal veri nedir?

Yapısal veri, bir web sayfasındaki bilginin ne olduğunu standart bir sözlükle açıkça bildiren işaretlemedir. İnsan bir sayfaya baktığında "bu bir şirket, bu adresi, bu bir makale, bu yazarı" der; arama motoru ve yapay zekâ sistemleri ise bunu metinden tahmin etmek zorundadır. Yapısal veri bu tahmini ortadan kaldırır: "Bu sayfa, adı laciweb olan, şu adreste bulunan bir kuruluşu anlatıyor" ifadesini doğrudan makineye verir.

Kullanılan standart sözlük schema.org'dur. Google'ın belgelerine göre yapısal veri, sayfanın anlamına dair açık ipuçları verir ve uygun olduğunda arama sonuçlarında zengin görünümlere (rich results) olanak tanıyabilir; ancak bunu garanti etmez. Yani yapısal veri bir "sıralama hilesi" değil, içeriğin doğru anlaşılmasını sağlayan bir dilbilgisidir.

JSON-LD, Microdata ve RDFa

Yapısal veri üç biçimde yazılabilir:

• JSON-LD: Sayfanın <head> veya <body> bölümüne konan ayrı bir <script type="application/ld+json"> bloğu. HTML içeriğinden bağımsız olduğu için bakımı kolaydır.
• Microdata: HTML etiketlerinin içine itemprop gibi özniteliklerle eklenir.
• RDFa: HTML'e özniteliklerle eklenen bir diğer biçim.

Google, siteniz uygunsa JSON-LD kullanmanızı önerir. Bu rehberdeki tüm örnekler JSON-LD'dir. Sitenizde zaten bir biçim kullanılıyorsa aynı bilgiyi birden fazla biçimde çelişkili şekilde yazmaktan kaçının.

SEO ve GEO açısından neden önemli?

SEO tarafı

• Doğru yorumlama: Sayfanın türünü (makale, hizmet, ürün, yerel işletme) ve temel özelliklerini net anlatır.
• Zengin sonuç potansiyeli: Bazı türler (ör. Breadcrumb, Article, Product, Organization bilgisi) uygun koşullarda daha zengin görünümlere olanak tanır. Hangi türün hangi görünümü desteklediği zamanla değişir; güncel liste için Google'ın yapısal veri galerisine bakın.
• Tutarlı kurum kimliği: Aynı kuruluşun tüm sayfalarda aynı bilgilerle tanımlanması, marka ve varlık sinyalini güçlendirir.

GEO tarafı

Yapay zekâ destekli arama ve asistanlar bilgiyi web sayfalarından okur. Yapısal veri, kurumun adı, adresi, hizmeti, yazarı ve tarihleri gibi olguları metin içinde aramak yerine doğrudan okunabilir hale getirir. Ancak şunu açıkça belirtmek gerekir: Google'ın yapısal veri belgeleri, işaretlemenin yapay zekâ cevaplarına dahil edilmeyi sağladığına dair bir taahhüt içermez ve diğer yapay zekâ sistemlerinin işaretlemeyi nasıl kullandığı genel olarak yayımlanmamıştır. Bu yüzden yapısal veriyi "cevaplarda görünme anahtarı" değil, içeriğinizin ve kurum kimliğinizin makineler için net olmasını sağlayan düşük maliyetli bir temel olarak görün. GEO çalışmasının geri kalanı için GEO rehberimize bakabilirsiniz.

Temel kurallar

Google'ın genel yapısal veri yönergelerinden öne çıkanlar:

1. İşaretleme, sayfada görünen içeriği tarif etmelidir. Kullanıcının göremediği bilgiyi, doğru olsa bile işaretlemeyin.
2. Yalnızca işaretleme barındırmak için sayfa üretmeyin.
3. Türe özgü yönergelere uyun. Her türün zorunlu ve önerilen alanları vardır; eksik veya yanlış alan, zengin sonuç uygunluğunu bozabilir.
4. Yanıltıcı işaretleme kullanmayın. Var olmayan yorum, puan veya fiyat bilgisi eklemek manuel işlem riski taşır.
5. Bilgileri güncel tutun. Adres, telefon, tarih ve fiyat değiştiğinde işaretlemeyi de güncelleyin.

Kurumsal sitede kullanılacak temel türler

Her işletme her türü kullanmak zorunda değildir. Sitenizdeki gerçek içeriğe karşılık gelen türleri seçin; olmayan bir içeriği işaretlemek yönergelere aykırıdır.

Örnek: Organization ve WebSite

Aşağıdaki örnek, ana sayfada kullanılabilecek temel bir kurum tanımıdır. Değerleri kendi işletmenizin gerçek bilgileriyle değiştirin:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://ornek-site.com/#organization",
      "name": "Örnek Ajans",
      "url": "https://ornek-site.com/",
      "logo": "https://ornek-site.com/logo.png",
      "email": "info@ornek-site.com",
      "telephone": "+90 000 000 00 00",
      "address": {
        "@type": "PostalAddress",
        "addressLocality": "İstanbul",
        "addressCountry": "TR"
      },
      "sameAs": [
        "https://www.linkedin.com/company/ornek",
        "https://www.instagram.com/ornek"
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://ornek-site.com/#website",
      "url": "https://ornek-site.com/",
      "name": "Örnek Ajans",
      "inLanguage": "tr",
      "publisher": { "@id": "https://ornek-site.com/#organization" }
    }
  ]
}
</script>

Dikkat edin: sameAs yalnızca gerçekten size ait ve aktif profilleri içermelidir. Var olmayan veya başkasına ait bir profili listelemek hem yanıltıcıdır hem güven sinyalini bozar.

@id ve @graph ile varlıkları bağlamak

Birden fazla işaretleme bloğu yazarken her varlığa benzersiz bir @id (genellikle URL + #parça) vermek, başka bloklardan o varlığa referans vermenizi sağlar. Örneğin makalenin yayıncısı olarak yukarıdaki Organization'ı {"@id": "https://ornek-site.com/#organization"} ile göstermek, kurumu her makalede baştan yazmaktan kurtarır ve tutarlılığı garanti eder. @graph ise aynı bloğun içinde birden fazla varlığı birlikte tanımlamak için kullanılır.

Bu yapı, özellikle kurumun adı, adresi veya telefonu değiştiğinde faydalıdır: tek yerde güncelleyip her yerde doğru bilgiye sahip olursunuz. Aynı kurumsal bilgilerin Google İşletme Profili, Yandex İşletme ve sitenizdeki metinlerle birebir tutarlı olması gerektiğini Yerel SEO rehberimizde ayrıca anlattık.

Örnek: Article ve BreadcrumbList

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Makale başlığı",
  "description": "Makalenin kısa özeti.",
  "datePublished": "2026-10-09T09:00:00+03:00",
  "dateModified": "2026-10-09T09:00:00+03:00",
  "inLanguage": "tr",
  "author": { "@type": "Organization", "name": "Örnek Ajans" },
  "publisher": { "@id": "https://ornek-site.com/#organization" },
  "mainEntityOfPage": "https://ornek-site.com/makale-adresi"
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Anasayfa", "item": "https://ornek-site.com/" },
    { "@type": "ListItem", "position": 2, "name": "Makaleler", "item": "https://ornek-site.com/makaleler" },
    { "@type": "ListItem", "position": 3, "name": "Makale başlığı", "item": "https://ornek-site.com/makale-adresi" }
  ]
}
</script>

Makalelerde yazarın bir kişi olması ve gerçek bir profil sayfasına bağlanması, güven sinyali açısından değerlidir. Sahte veya uydurma yazar adı kullanmayın. dateModified alanını yalnızca içerik gerçekten güncellendiğinde değiştirin; tarihi sürekli ileri alarak "taze" göstermeye çalışmak yanıltıcıdır.

FAQPage için güncel durum

Birçok sitede (bu site dahil) sıkça sorulan sorular bölümleri FAQPage işaretlemesiyle sunulur. Bu işaretlemenin durumu zaman içinde değişti ve bilmeniz gerekir:

• Google, Eylül 2023'te FAQ zengin sonucunun yalnızca tanınmış devlet ve sağlık sitelerinde gösterileceğini belgelerine yazdı.
• Google'ın belgelerindeki güncelleme kayıtlarına göre bu özellik 7 Mayıs 2026'dan itibaren Google Arama'da gösterilmiyor ve belge sayfası sonradan kaldırıldı.

Bu nedenle FAQPage işaretlemesini zengin sonuç elde etmek amacıyla eklemek artık anlamlı değil. Bunun anlamı soru-cevap içeriğinin değersiz olduğu değildir: sayfada görünen kısa, doğrudan cevaplar kullanıcıya yardım eder ve yapay zekâ sistemlerinin alıntılayabileceği net pasajlar sağlar. İşaretlemenin kendisi geçerli schema.org söz dizimi olarak zararsızdır, ancak bundan SERP'te görsel bir kazanç beklemeyin. Yeni bir site kuruyorsanız önceliği Organization, Service/Product, Article ve BreadcrumbList gibi hâlâ işlevsel türlere verin; mevcut FAQPage bloklarını silmeniz de zorunlu değildir, yalnızca sayfadaki görünür metinle birebir uyumlu tuttuğunuzdan emin olun.

Genel olarak: bir türün zengin sonuç desteği değişebilir. Karar vermeden önce Google'ın yapısal veri galerisindeki güncel listeyi kontrol edin.

Hangi sayfaya hangi tür?

Doğrulama ve izleme

İşaretleme yazdıktan sonra mutlaka test edin:

• Rich Results Test: Google'ın zengin sonuç için uygunluğu kontrol eden aracı. URL veya kod yapıştırarak test edebilirsiniz.
• Schema Markup Validator: Zengin sonuç iddiasından bağımsız olarak schema.org söz dizimini doğrular.
• Google Search Console: Yayından sonra ilgili iyileştirme (enhancement) raporlarında hata ve uyarıları izleyin; URL Denetimi aracı Google'ın işaretlemeyi bulup bulmadığını gösterir.
• JSON söz dizimi kontrolü: Eksik virgül veya tırnak, tüm bloğu geçersiz kılar. Yayından önce bir JSON doğrulayıcıdan geçirin.

Hata yoksa bile işaretleme, sayfadaki bilgiyle birebir örtüşmelidir. Bu bir araç testi değil, sizin sorumluluğunuzdur.

Statik sitede ve CMS'te uygulama

• Statik / elle yazılmış siteler: JSON-LD bloğunu şablonun <head> bölümüne ekleyin. Ortak bilgileri (Organization) tek bir şablon parçasında tutun ki değişiklik her sayfaya yansısın.
• WordPress ve benzeri CMS'ler: SEO eklentileri temel işaretlemeyi otomatik üretir. Üretilen çıktıyı mutlaka test edin ve eklenti ile tema aynı işaretlemeyi iki kez eklemiyor mu kontrol edin.
• E-ticaret platformları: Ürün, fiyat ve stok bilgisi çoğunlukla otomatik üretilir; fiyat ve stok değerlerinin sayfadakiyle uyumlu olduğundan emin olun.
• Dinamik oluşturma: İşaretlemeyi JavaScript ile sonradan üretiyorsanız, yapay zekâ botları dahil bazı tarayıcıların bunu görmeyebileceğini unutmayın; mümkünse işaretlemeyi ilk HTML yanıtında sunun.

Web sitenizin teknik kalitesi ve bu tür işaretlemelerin kurulum kapsamı için web sitesi maliyeti rehberimizdeki kontrol listesine, hız tarafı için Core Web Vitals rehberimize bakabilirsiniz.

Sık yapılan hatalar

• Sayfada olmayan veya görünmeyen bilgiyi işaretlemek.
• Sahte yorum, puan veya fiyat verisi eklemek.
• Çelişkili bilgi: sayfada bir adres, işaretlemede başka bir adres.
• Tema ve eklentinin aynı işaretlemeyi iki kez üretmesi.
• Var olmayan veya başkasına ait sosyal profilleri sameAs'e eklemek.
• Zengin sonuç desteği kalkmış türleri hâlâ "SERP kazancı" beklentisiyle eklemek.
• Geçersiz JSON (eksik virgül, tırnak) nedeniyle tüm bloğun okunmaması.
• Kurumsal bilgi değiştiğinde işaretlemeyi güncellemeyi unutmak.

Yapısal veri kontrol listesi

Yapısal verinin web sitesi, SEO, GEO ve yerel görünürlükle birlikte bütün strateji içindeki yerini görmek için Kurumsal Web Sitesi ve Dijital Pazarlama Rehberi sayfamıza, temel SEO ilkeleri için SEO rehberimize bakabilirsiniz.

Sık sorulan sorular