JSON-LD Kodu Nasıl Çalışır? Teknik SEO İçin Uygulamalı Yapısal Veri Rehberi

Yapısal veri, arama motorlarının bir web sayfasını daha iyi anlamasını sağlayan temel SEO bileşenlerinden biridir. JSON-LD ise bu yapısal veriyi sunmanın en modern ve önerilen yöntemidir. Bu yazıda JSON-LD’nin ne olduğunu, neden kullanıldığını ve nasıl eklendiğini sade ve uygulamaya dönük bir şekilde ele alıyoruz.

JSON-LD Nedir?

JSON-LD (JavaScript Object Notation for Linked Data), web sayfalarındaki bilgileri semantik olarak tanımlamak için kullanılan bir veri biçimidir. Schema.org sözlüğünü temel alır ve arama motorlarına sayfa içeriği hakkında bağlamsal bilgi sağlar. HTML’den bağımsız olarak etiketiyle sayfa başlığına veya gövdesine eklenir.
JSON formatına dayalı olduğu için hem insanlar hem makineler tarafından kolayca okunabilir. Google, Bing ve diğer arama motorları bu kodu kullanarak sayfa içeriğini daha doğru yorumlar ve zengin sonuçlar üretir.

JSON-LD Ne İçin Kullanılır?

JSON-LD kodu, aşağıdaki amaçlarla kullanılır:

Arama motorlarına içerik hakkında net bilgi vermek
Zengin sonuçlar elde etmek (örneğin yıldızlı yorumlar, ürün fiyatları, etkinlik tarihleri)
SEO (Bkz: SEO Nasıl Yapılır? Arama Motorlarında Zirveye Ulaşmanın Kapsamlı Rehberi) performansını artırmak
Sayfa içeriğini semantik olarak tanımlamak
Yapısal veri hatalarını azaltmak
Kullanım alanları arasında makale, ürün, etkinlik, kişi, organizasyon, video, SSS gibi birçok içerik türü bulunur.

İçindekiler

JSON-LD Kodunun Temel Yapısı

Aşağıda bir kişi bilgisi için örnek JSON-LD kodu yer alıyor:

{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "Çağrı Özkaya",
  "jobTitle": "Dijital Pazarlama Uzmanı",
  "url": "https://www.orneksite.com",
  "sameAs": [
    "https://www.linkedin.com/in/cagriozkaya",
    "https://twitter.com/cagriozkaya"
  ]
}

Bu yapı sayesinde arama motorları, sayfadaki kişinin kim olduğunu ve hangi sosyal profillere sahip olduğunu anlayabilir.

WebP Görsel Formatı: Hızlı ve Verimli Web Deneyimi

JSON-LD Nasıl Eklenir?

HTML Sayfasına Manuel Ekleme

Sayfanızın bölümüne aşağıdaki gibi ekleyebilirsiniz:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD Nedir?",
  "author": {
    "@type": "Person",
    "name": "Çağrı Özkaya"
  },
  "datePublished": "2025-09-17",
  "publisher": {
    "@type": "Organization",
    "name": "OrnekSite"
  }
}
</script>

2-WordPress Kullanıyorsanız

WordLift, Rank Math veya Yoast gibi eklentilerle JSON-LD kodları otomatik olarak eklenebilir. Özellikle WordLift, içerik analizi yaparak uygun schema türünü önerir ve kodu sayfaya enjekte eder.

3-Google Tag Manager ile Ekleme

Google Tag Manager üzerinden yeni bir etiket oluşturup “HTML” türünü seçerek JSON-LD kodunu buraya yapıştırabilirsiniz. Sayfa yüklenme tetikleyicisiyle çalıştırabilirsiniz.

Kodun JSON formatına uygun olması gerekir. Küme parantezleri, virgüller ve tırnak işaretleri doğru kullanılmalıdır
Schema.org sözlüğüne uygun türler seçilmelidir
Kodun doğruluğu Google’ın Rich Results Test aracıyla test edilmelidir
HTML içeriğiyle uyumlu olmalıdır. Örneğin bir ürün sayfasında ürün bilgisi varsa, JSON-LD kodu da bu bilgileri içermelidir

JSON-LD Kullanımında Dikkat Edilmesi Gerekenler

Kodun JSON formatına uygun olması gerekir. Küme parantezleri, virgüller ve tırnak işaretleri doğru kullanılmalıdır
Schema.org sözlüğüne uygun türler seçilmelidir
Kodun doğruluğu Google’ın Rich Results Test aracıyla test edilmelidir
HTML içeriğiyle uyumlu olmalıdır. Örneğin bir ürün sayfasında ürün bilgisi varsa, JSON-LD kodu da bu bilgileri içermelidir

Sonuç
JSON-LD, teknik SEO’nun en sade ama en etkili araçlarından biridir. Web sayfalarınızı arama motorları için daha anlaşılır hale getirir, zengin sonuçlarla görünürlüğünüzü artırır ve kullanıcı deneyimini iyileştirir. Özellikle topical authority oluşturmak isteyen içerik üreticileri için vazgeçilmezdir.

About
Latest Posts

Çağrı

Ben Çağrı. Yönetim Bilişim Sistemleri mezunuyum. SEO, içerik stratejisi ve UX alanında sade ve etkili dijital içerikler hazırlıyorum.

JSON-LD Kodu Nasıl Çalışır? Teknik SEO İçin Uygulamalı Yapısal Veri Rehberi4 dk okuma