JSON-LD Schema Rehberi: Yeni Başlayanlar İçin

JSON-LD (JavaScript Object Notation for Linked Data), web sayfanıza yapılandırılmış veri (structured data) eklemenin en kolay ve en yaygın yoludur. Schema.org tarafından standartlaştırılmış bu format sayesinde, arama motorlarına sayfanızın içeriğini makine-okunur bir dille anlatırsınız. Bir blog yazısının başlığını, yazarını, yayın tarihini, bir ürünün fiyatını ve stok durumunu, bir işletmenin adresini ve çalışma saatlerini — hepsini JSON-LD ile tanımlayabilirsiniz. Bu rehberde, JSON-LD schema'yı sıfırdan başlayarak adım adım nasıl ekleyeceğinizi öğreneceksiniz.

Web'deki tüm sitelerin yalnızca %30'u yapılandırılmış veri kullanıyor (W3Techs, 2026). Bu, JSON-LD'yi doğru uygulayan her sitenin büyük bir rekabet avantajı yakaladığı anlamına gelir. Üstelik Generative Engine Optimization (GEO) çağında, JSON-LD artık sadece "iyi bir SEO pratiği" değil — AI arama motorlarında görünürlük için bir zorunluluktur.

JSON-LD Nedir?

JSON-LD, Schema.org tarafından 2011'de tanıtılan ve 2015'te Google'ın resmi olarak önerdiği yapılandırılmış veri formatıdır. Çalışma prensibi basittir: sayfanızın HTML'ine, <script type="application/ld+json"> etiketi içinde bir JSON objesi gömülür. Bu obje, sayfanızdaki içeriğin ne olduğunu arama motorlarına bildirir.

İşte bir blog yazısı için en basit JSON-LD örneği:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD Schema Rehberi: Yeni Başlayanlar İçin",
  "author": {
    "@type": "Person",
    "name": "GeoDigitalist"
  },
  "datePublished": "2026-08-03",
  "description": "JSON-LD ile web sayfanıza yapılandırılmış veri ekleyin."
}

Bu kod, Google'a sayfanın bir makale (Article) olduğunu, başlığını, yazarını, tarihini ve açıklamasını bildirir. Kullanıcı bu kodu sayfada görmez — sadece arama motorları okur.

JSON-LD, Google, Bing, Yahoo ve Yandex tarafından ortaklaşa desteklenen tek yapılandırılmış veri formatıdır. Google, 2015'ten beri JSON-LD'yi birincil format olarak önermektedir.

JSON-LD Neden GEO İçin Kritik?

Geleneksel SEO'da JSON-LD "zengin sonuçlar için güzel bir ek" olarak görülürdü. GEO çağında ise JSON-LD, AI'ın sizi anlamasının temelidir.

Yapay zeka arama motorları (ChatGPT, Gemini, Google AI Overviews, Perplexity) içeriğinizi şu süreçle işler:

Web sayfası → HTML parse → Metin + JSON-LD çıkarma → Embedding → Anlamsal eşleşme → Kaynak gösterme

JSON-LD, bu sürecin ikinci adımında devreye girer. Sayfanızı tarayan AI, sadece görünür metni değil, JSON-LD içindeki yapılandırılmış veriyi de okur. Bu, AI'ın içeriğinizi daha hızlı ve daha doğru anlamasını sağlar.

Google AI Overviews, özellikle FAQPage, HowTo ve Article schema'larını aktif olarak kullanır. Bu schema'ları doğru uygulayan sayfaların AI Overviews'ta kaynak gösterilme olasılığı, uygulamayanlara göre 4 kata kadar daha fazladır (Search Engine Journal, 2025).

Ayrıca, schema markup kullanan sayfaların Google arama sonuçlarında zengin sonuç (rich result) olarak görünme şansı, kullanmayanlara göre belirgin şekilde yüksektir. Zengin sonuçlar — yıldız derecelendirmeleri, fiyat bilgileri, SSS akordiyonları, breadcrumb zincirleri — organik tıklanma oranını (CTR) %5 ila %30 arasında artırabilir (Google Search Central, 2025).

JSON-LD vs Microdata vs RDFa: Hangisini Kullanmalısınız?

Schema.org verilerini sayfaya eklemenin üç yolu vardır. JSON-LD, Google'ın resmi olarak önerdiği ve en yaygın kullanılan formattır.

Sonuç: Yeni başlıyorsanız JSON-LD kullanın. Microdata ve RDFa, JSON-LD'nin çıkmadığı eski projelerde veya çok özel durumlarda kullanılır.

Adım Adım JSON-LD Ekleme Rehberi

JSON-LD'yi web sayfanıza eklemek için dört adım yeterlidir. Bu adımları sırayla takip edin.

Adım 1: Doğru Schema Türünü Seçin

Schema.org'da 800'den fazla tür bulunur. Ancak günlük kullanımda ihtiyacınız olan türler sınırlıdır. Sayfanızın içeriğine göre doğru türü seçmek, JSON-LD'nin en kritik adımıdır.

Başlangıç ipucu: İlk JSON-LD'niz için bir blog yazısı veya şirket bilgisi schema'sı ile başlayın. Bunlar en basit ve en yaygın kullanılan türlerdir. Daha sonra FAQPage ve HowTo gibi zengin sonuç üreten türlere geçebilirsiniz.

Tüm türlerin tam listesine ve detaylı dokümantasyonuna schema.org adresinden ulaşabilirsiniz.

Adım 2: JSON-LD Kodunu Yazın

Schema türünü seçtikten sonra, JSON-LD objenizi oluşturun. Her JSON-LD objesi üç temel alanla başlar:

• @context: Her zaman "https://schema.org" olmalıdır — bu, kullandığınız sözlüğü belirtir.
• @type: İçeriğinizin türü — Article, Product, FAQPage gibi.
• İçerik alanları: Seçtiğiniz türe özel alanlar — headline, author, price gibi.

İşte GeoDigitalist ana sayfasında kullandığımız ProfessionalService schema'sı:

{
  "@context": "https://schema.org",
  "@type": "ProfessionalService",
  "name": "GeoDigitalist",
  "url": "https://geodigitalist.com",
  "description": "Generative Engine Optimization ajansı. Yapay zeka arama motorlarında marka görünürlüğünüzü artırıyoruz.",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Adana",
    "addressCountry": "TR"
  },
  "knowsAbout": [
    "Generative Engine Optimization",
    "LLM Optimizasyonu",
    "JSON-LD Yapılandırılmış Veri",
    "Entity Optimizasyonu"
  ]
}

Bu schema, arama motorlarına GeoDigitalist'in Adana merkezli bir profesyonel hizmet olduğunu ve hangi konularda uzman olduğunu bildirir. knowsAbout alanı, GEO için özellikle kritiktir — AI'ın markanızı hangi uzmanlık alanlarıyla ilişkilendireceğini doğrudan belirtir.

Adım 3: Web Sayfanıza Ekleyin

JSON-LD'yi sayfanıza eklemenin iki yolu vardır:

Yöntem 1: Doğrudan HTML'e gömme (her platformda çalışır)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD Schema Rehberi: Yeni Başlayanlar İçin",
  "author": {
    "@type": "Person",
    "name": "GeoDigitalist"
  },
  "datePublished": "2026-08-03"
}
</script>

Bu script etiketini sayfanızın <head> veya <body> bölümüne yerleştirin. Google her ikisini de okuyabilir.

Yöntem 2: Next.js'te React bileşeni olarak (GeoDigitalist'in kullandığı yöntem)

// components/seo/ArticleJsonLd.tsx
export default function ArticleJsonLd({ post }: { post: Post }) {
  const schema = {
    "@context": "https://schema.org",
    "@type": "Article",
    headline: post.title,
    author: {
      "@type": "Person",
      name: post.author || "GeoDigitalist"
    },
    datePublished: post.date,
    description: post.excerpt
  };

  return (
    <script
      type="application/ld+json"
      dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }}
    />
  );
}

Bu yaklaşım, schema verilerini dinamik olarak oluşturmanızı sağlar — her blog yazısının kendi başlığı, tarihi ve yazarı JSON-LD'ye otomatik yansır. GeoDigitalist'te tüm JSON-LD bileşenleri components/seo/ klasörü altında bu yöntemle yönetilir.

WordPress kullanıyorsanız, RankMath veya Yoast SEO gibi eklentiler JSON-LD'yi sizin için otomatik olarak ekler. Eklentinin schema ayarlarını kontrol ederek doğru türün seçildiğinden emin olun.

Adım 4: Test Edin ve Doğrulayın

JSON-LD'nizi ekledikten sonra mutlaka test edin. Hatalı bir JSON-LD, hiç eklenmemiş bir JSON-LD'den daha kötüdür — arama motorları hatalı yapılandırılmış veriyi görmezden gelir.

Kullanmanız gereken üç araç:

Test sırası önerisi: Önce Google Rich Results Test'te hata var mı diye bakın, ardından Schema.org Validator'da teknik doğrulama yapın, son olarak GSC'de canlı URL testi ile indekslenmiş halini kontrol edin.

En Sık Kullanılan Schema Türleri ve GEO Değerleri

Aşağıdaki tablo, yeni başlayanların öncelikle öğrenmesi gereken schema türlerini ve her birinin GEO açısından değerini özetler:

GeoDigitalist olarak şu ana kadar ProfessionalService, Article, Service, FAQPage, ContactPage, AboutPage ve Person schema'larını başarıyla uyguladık. Her biri, sitenin GEO skoruna katkıda bulunan bir yapboz parçasıdır.

JSON-LD'de Sık Yapılan 5 Hata

Yeni başlayanların en sık düştüğü hataları bilmek, zaman kazandırır:

1. @context ve @type alanlarını atlamak — Bu iki alan JSON-LD'nin zorunlu kimlik bilgileridir. Onlarsız schema geçersiz sayılır.

2. Yanlış schema türü seçmek — Bir hizmet sayfasına Product schema'sı, bir blog yazısına Organization schema'sı eklemek. Her sayfa kendi içeriğine uygun schema'yı almalıdır.

3. Zorunlu alanları boş bırakmak — Örneğin Article schema'sında headline ve datePublished zorunludur. Eksik bırakılırsa Google schema'yı görmezden gelir. Hangi alanların zorunlu olduğunu schema.org'dan kontrol edin.

4. JSON-LD'yi HTML yorumu içine yazmak — <!-- --> içindeki JSON-LD, arama motorları tarafından okunmaz. JSON-LD her zaman <script type="application/ld+json"> etiketi içinde olmalıdır.

5. Aynı sayfaya birden fazla çakışan schema eklemek — Aynı içerik için hem Article hem BlogPosting eklemek gibi. Bir sayfada birden fazla schema olabilir (örneğin Article + FAQPage + BreadcrumbList), ama bunlar aynı entity'yi çakışmadan tanımlamalıdır.

Bu hataları yapmamak için her JSON-LD eklemesinden sonra mutlaka Google Rich Results Test ile doğrulama yapın. Araç, tüm bu hataları net mesajlarla size bildirecektir.

JSON-LD ve GEO: Büyük Resim

JSON-LD, GEO stratejisinin tek başına yeterli olmayan ama onsuz da olmayan bir bileşenidir. Doğru uygulandığında:

• AI arama motorlarına içeriğinizin kesin bir tanımını verir
• Entity optimizasyonunun teknik altyapısını oluşturur (Entity Optimizasyonu rehberimize göz atın)
• Zengin sonuçlarla organik CTR'ı artırır
• Sesli asistanlar ve AI chatbot'lar tarafından daha kolay okunur

Ancak JSON-LD tek başına GEO başarısı getirmez. Kaliteli içerik, otorite backlink'ler, entity tutarlılığı ve düzenli içerik üretimi ile birleştiğinde anlam kazanır. GEO, teknik + içerik + otorite üçgeninde çalışır ve JSON-LD bu üçgenin teknik ayağını oluşturur.

GeoDigitalist olarak Adana'dan Türkiye geneline sunduğumuz GEO danışmanlığı kapsamında, JSON-LD kurulumu her müşteri projesinin ilk adımıdır. Çünkü AI'a kendinizi tanıtmanın yolu, onun dilini konuşmaktan geçer — ve AI'ın dili JSON-LD'dir.

Daha fazlası için hizmetler sayfamızı ziyaret edebilir veya GEO Nedir? yazımızdan temel kavramları öğrenebilirsiniz.

Sıkça Sorulan Sorular

JSON-LD nedir, basitçe nasıl anlatılır?

JSON-LD, web sayfanıza eklediğiniz ve sadece arama motorlarının okuduğu bir içerik tanımlama kodudur. Google'a "bu sayfa bir makaledir, başlığı budur, yazarı budur" demenin standart yoludur. Kullanıcı tarafından görünmez, sayfanın görünümünü etkilemez — sadece makineler içindir.

JSON-LD eklemek için yazılım bilgisi şart mı?

Temel seviyede JSON-LD eklemek için yazılım bilgisi şart değildir. Bir JSON objesini kopyalayıp HTML'inize yapıştırabilirsiniz. WordPress kullanıcıları RankMath veya Yoast SEO ile otomatik ekleme yapabilir. Ancak dinamik schema'lar (her sayfada değişen veriler) için temel JavaScript bilgisi gerekir.

Hangi schema türünü kullanmalıyım?

Sayfanızın içeriğine göre: Blog yazısı → Article, Şirket tanıtımı → Organization/ProfessionalService, SSS sayfası → FAQPage, Ürün sayfası → Product, Nasıl yapılır → HowTo. Tam liste için schema.org adresini ziyaret edin.

JSON-LD'nin SEO ve GEO farkı nedir?

SEO için JSON-LD, zengin sonuçlarda görünme şansını artıran bir optimizasyondur — doğrudan sıralama faktörü değildir. GEO için ise JSON-LD, AI'ın içeriğinizi doğru anlaması ve entity olarak tanıması için bir zorunluluktur. SEO'da "iyi olur", GEO'da "şart" seviyesindedir.

JSON-LD'yi ne sıklıkla güncellemeliyim?

JSON-LD'nizi içerik her değiştiğinde güncelleyin. Özellikle tarih (datePublished, dateModified), fiyat (price), stok (availability) gibi dinamik alanların güncel olması kritiktir. Güncel olmayan bir JSON-LD, AI tarafından güvenilmez olarak işaretlenebilir.