Pratik yapılandırılmış veri rehberi

Pratik SEO için JSON-LD Şema İşaretlemesi Rehberi

JSON-LD, arama motorlarının bir sayfanın ne olduğunu, kim tarafından yayınlandığını, sitenize nasıl uyduğunu ve hangi bilgilerin desteklenen arama özelliklerinde kullanılmaya değer olduğunu anlamasına yardımcı olur.

Faydalı amaç, bulduğunuz her şema türünü eklemek değil. Faydalı amaç, görünür sayfayla uyumlu, temiz doğrulanan ve içerik değiştikçe senkron kalan doğru yapılandırılmış veridir.

Yararlı kısa versiyon

Sayfayı dürüst, görünür gerçeklerle tanımlayabiliyorsanız JSON-LD kullanın: başlık, açıklama, yazar, yayın tarihi, breadcrumb, ürün detayları, video verisi veya net soru-cevap içeriği. Google'ın artık göstermediği özellikleri vaat etmek veya kullanıcıların göremediği içeriği işaretlemek için şema eklemeyin.

En iyi ilk şema Çoğu rehber sayfası için Article, WebPage ve BreadcrumbList.
En iyi iş akışı Başlık, açıklama, kanonik ve Open Graph'ı sağlayan aynı sayfa meta verisinden şema oluşturun.
En iyi gerçeklik kontrolü FAQPage ve WebSite işaretlemesi içeriği tanımlayabilir, ancak kullanımdan kalkmış Google gösterimleri üzerine strateji kurmayın.

JSON-LD'nin gerçekte yaptığı

JSON-LD, makine tarafından okunabilen yapılandırılmış veri bloğudur. Genellikle sayfanın head veya body kısmındaki script etiketinde bulunur ve schema.org sözlüğü ile varlıkları tanımlar. Arama motorları bunu görünür içeriğin üstünde bir açıklık katmanı olarak kullanır.

Ayrıştırıcı açıklığı

Anlam

Sayfa gerçeklerini Article, author, datePublished, BreadcrumbList veya SoftwareApplication gibi adlandırılmış varlıklar ve özelliklere dönüştürür.

Arama özelliği

Uygunluk

Bir sayfayı desteklenen zengin sonuçlara uygun hale getirebilir, ancak Google ne gösterileceğine kalite, politika, sorgu ve özellik uygunluğuna göre karar verir.

Site grafiği

Tutarlılık

CMS'nize veya Blazor uygulamanıza aynı kanonik URL, dil, başlık, tarihler, görseller ve yayıncı verilerini yeniden kullanmak için tek bir yapılandırılmış alan sağlar.

Kısa yol değil

Sınır

Zayıf içeriği, sahte incelemeleri, gizli SSS cevaplarını, güncel olmayan tarihleri veya yapılandırılmış veriyle uyuşmayan sayfaları düzeltmez.

Önemli: Yapılandırılmış veri sayfayı desteklemeli, faydalı içeriğin yerini almamalıdır. Görünür sayfa zayıf, kafa karıştırıcı, güncel olmayan veya yanıltıcıysa, şema işaretlemesi güçlü bir arama sonucu oluşturmaz.

Şemayı sayfanın işine göre seçin

Spam veya yinelenen yapılandırılmış veriden kaçınmanın en kolay yolu, sayfanın ne yapmaya çalıştığını sormaktır. O işi doğru tanımlayan en küçük şema setini ekleyin.

İçerik

Article / BlogPosting

Şunun için kullanın
Rehberler, eğitimler, incelemeler, haber benzeri yazılar ve uzun açıklamalar.
Ekleme zamanı
Sayfa net bir başlık, yazar veya yayıncı, yayın tarihi, değiştirilme tarihi, kanonik URL ve görsel içerir.
Kaçınılması gereken durumlar
Sayfa çoğunlukla bir araç kullanıcı arayüzü, ürün listesi, kategori sayfası veya ince açılış sayfasıdır.

Gezinme

BreadcrumbList

Şunun için kullanın
Ana sayfanın altındaki hemen hemen her sayfa.
Ekleme zamanı
Kullanıcılar sayfanın site hiyerarşisinde nerede olduğunu anlayabilir.
Kaçınılması gereken durumlar
Breadcrumb yolu dahili bağlantılar, kanonik URL'ler veya görünür navigasyonla uyuşmuyor.

Site kimliği

WebPage / WebSite / Organization

Şunun için kullanın
Ana sayfa, merkezler, hakkında sayfaları ve yayıncı kimliğinin önemli olduğu sayfalar.
Ekleme zamanı
Sayfa, site, yayıncı ve dili bağlayan sabit bir varlık grafiği istersiniz.
Kaçınılması gereken durumlar
Eski site bağlantıları arama kutusu gösterimini yakalamak için sadece WebSite işaretlemesi ekliyorsunuz.

Ürün veya uygulama

Product / SoftwareApplication

Şunun için kullanın
Araçlar, uygulamalar, SaaS sayfaları, eklentiler, indirilebilir yazılımlar veya gerçek ürün sayfaları.
Ekleme zamanı
İşaretlediğinizde görünür sayfa içeriği ad, açıklama, işletim sistemi veya kategori, fiyat, teklifler ve puanlamaları içerir.
Kaçınılması gereken durumlar
Puanlar, fiyat, stok durumu veya incelemeler sayfada kullanıcılar tarafından görünür değil.

Sorular

FAQPage

Şunun için kullanın
Kullanıcıların konuyu gerçekten anlamasına yardımcı olan görünür soru-cevap bölümleri.
Ekleme zamanı
Google SSS zengin sonuçlarını göstermese bile Soru-Cevap içeriği sayfada faydalıdır.
Kaçınılması gereken durumlar
Genel Soru-Cevap'ı sadece arama alanı kaplamak veya aynı cevabı birçok sayfada tekrarlamak için eklersiniz.

Medya

VideoObject / ImageObject

Şunun için kullanın
Önemli gömülü video, eğitim videosu veya taranabilir görsel varlığı olan sayfalar.
Ekleme zamanı
Medya sayfanın merkezindedir ve başlık, açıklama, küçük resim, yükleme tarihi ve sabit URL içerir.
Kaçınılması gereken durumlar
Medya dekoratif, gizli, engellenmiş veya ana sayfa amacına uygun değildir.

Çoğu hatayı önleyen uygulama kontrol listesi

İyi JSON-LD en iyi anlamda sıkıcıdır: tutarlı, güvenilir alanlardan oluşturulmuş, doğrulaması kolay ve sayfa değiştiğinde unutulması zordur.

01

Bir ana sayfa varlığı seçin

Sayfanın esas olarak makale, ürün, uygulama, video, SSS, koleksiyon veya genel web sayfası olup olmadığına karar verin. İkincil şema, ana varlığı desteklemelidir.

02

Görünür içerikle eşleştir

İşaretlenen her iddia sayfada görünür veya açıkça çıkarılabilir olmalıdır: başlık, yazar, tarihler, fiyat, puanlama, Soru-Cevap, breadcrumb ve görseller.

03

Sabit @id değerleri kullanın

Önemli varlıklara kanonik URL artı #article, #webpage, #organization veya #faq gibi sabit kimlikler verin. Bu, ayrıştırıcıların grafik parçalarını bağlamasına yardımcı olur.

04

Paylaşılan meta veriden oluştur

Başlık etiketleri, meta açıklamalar, kanonik URL'ler, Open Graph görselleri, dil etiketleri ve son değiştirilme tarihlerini oluşturan aynı kaynak alanlarını yeniden kullanın.

05

Tarihleri doğru tutun

dateModified sadece anlamlı sayfa içeriği değiştiğinde değiştirin. Sadece arama sonuçlarında daha yeni görünmek için tarihleri otomatik yenilemeyin.

06

Görselleri taranabilir yapın

Mutlak görsel URL'leri, uygun boyutları ve robotlar, kimlik doğrulama veya sadece tembel yükleme ile engellenmeyen dosyaları kullanın.

07

Erken render et

Blazor ve diğer JavaScript uygulamalarında, tarayıcıların ilk HTML yanıtında görebilmesi için önceden render edilmiş veya sunucu tarafı render edilmiş JSON-LD tercih edin.

08

Doğrula ve izle

Yayınlamadan önce Zengin Sonuçlar Testini çalıştırın, sözdizimi için Şema İşaretleme Doğrulayıcısını kontrol edin ve dizine eklemeden sonra Search Console'u izleyin.

Blazor sayfaları için temiz bir JSON-LD şablonu

Blazor için en güvenli yöntem, şemayı sayfa meta verilerinden başlatma veya önceden render sırasında oluşturmak, bir kez serileştirmek ve application/ld+json scriptini tarayıcıların ilk HTML'de görebileceği şekilde render etmektir.

HTMLArticle JSON-LD örneği
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "@id": "https://example.com/en/json-ld-schema-guide/#article",
  "headline": "JSON-LD Schema Markup Guide for Practical SEO",
  "description": "A practical guide to choosing, generating, and validating structured data.",
  "image": "https://example.com/images/json-ld-guide.png",
  "datePublished": "2026-03-28T10:00:00+00:00",
  "dateModified": "2026-05-31T10:00:00+00:00",
  "author": {
    "@type": "Organization",
    "name": "Example Publisher"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Example Publisher",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/en/json-ld-schema-guide/"
  }
}
</script>
C#C# yardımcı şablonu
private MarkupString BuildJsonLd(PageMetaData meta)
{
    var pageUrl = BuildPageUrl(meta);

    var schema = new Dictionary<string, object?>
    {
        ["@context"] = "https://schema.org",
        ["@type"] = "Article",
        ["@id"] = $"{pageUrl}#article",
        ["headline"] = meta.Title,
        ["description"] = meta.Description,
        ["url"] = pageUrl,
        ["datePublished"] = meta.Published?.ToString("O"),
        ["dateModified"] = meta.Modified?.ToString("O"),
        ["inLanguage"] = CS.Culture
    };

    var json = JsonSerializer.Serialize(schema, new JsonSerializerOptions
    {
        DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
    });

    return new MarkupString($"<script type=\"application/ld+json\">{json}</script>");
}
Pratik kural: url ve @id için sabit URL'ler kullanın. Her yerde aynı kanonik URL'yi kullanın. Aynı sayfa birden fazla dil URL'sinde görünüyorsa, dil bazlı meta veriler oluşturun ve her hreflang/kanonik ayarını tutarlı tutun.

JSON-LD'ye güvenmeden önce doğrulayın

Doğrulamanın iki farklı görevi vardır. Şema İşaretleme Doğrulayıcısı, sözcük dağarcığı ve JSON-LD sözdiziminin anlaşılır olup olmadığını kontrol eder. Google'ın Zengin Sonuçlar Testi ise Google'ın sayfayı desteklenen zengin sonuç türlerine uygun olarak tanıyıp tanımadığını kontrol eder.

Google uygunluğu

Zengin Sonuçlar Testi

Google'ın sayfayı okuyup okuyamadığını ve tespit edilen yapılandırılmış verinin desteklenen zengin sonuç türlerine uygun olup olmadığını kontrol eder.

Zengin Sonuçlar Testini Aç

Sözlük

Şema İşaretleme Doğrulayıcısı

Genel schema.org yapısı ve JSON-LD sözdizimini, türler, özellikler, iç içe varlıklar ve hatalı JSON dahil olmak üzere kontrol eder.

Şema İşaretleme Doğrulayıcısını Aç

Güveni zedeleyen yaygın JSON-LD hataları

Çoğu şema sorunu karmaşık teknik hatalar değildir. Bunlar, işaretlemenin söylediği ile kullanıcı veya tarayıcının sayfada doğrulayabildiği şeyler arasındaki uyumsuzluklardır.

Gizli veya eksik içeriği işaretlemek

Kullanıcılar cevabı, incelemeyi, teklifi, görseli veya yazar iddiasını göremiyorsa, bunları yapılandırılmış veriye eklemeyin. Bu, güven kaybetmenin en hızlı yoludur.

Her şeye FAQPage eklemek

SSS şeması görünür Soru-Cevap'ı tanımlayabilir, ancak her makalede kopyala-yapıştır bloğu olmamalıdır. Sadece Soru-Cevap sayfayı iyileştiriyorsa kullanın.

Çakışan yinelenen scriptler

Farklı başlıklar, tarihler veya URL'lere sahip birden fazla Article bloğu sayfanın yorumlanmasını zorlaştırır. Bir net grafik, üç parçalı olandan iyidir.

Yanlış kanonik veya @id

Şema URL'leri kanonik sayfa, kültür URL'si ve hreflang ayarlarıyla eşleşmelidir. Karışık dil URL'leri çoğaltılmış içerik ve varlık karışıklığı yaratır.

Sahte güncellik

dateModified değerini şablon düzenlemeleri, izleme değişiklikleri veya sadece şema güncellemeleri için değiştirmeyin. Tarihi gerçek içerik değişiklikleri için kullanın.

Sadece istemci tarafı geç render

JSON-LD sadece gecikmeli istemci renderından sonra görünüyorsa, tarayıcılar bunu kaçırabilir. Önemli sayfalar için sunucu tarafı render veya önceden render tercih edin.

Sayfa türüne göre pratik şema tarifleri

Nadiren devasa bir grafik gerekir. Bu kombinasyonlar çoğu küçük site, blog, araç ve inceleme projesinin yayınladığı sayfaları kapsar.

Rehber makale

Article + BreadcrumbList + WebPage

  • Başlık, yazar, yayıncı, görsel, tarihler ve bölüm isimleri için Article kullanın.
  • Görünür site yolu için BreadcrumbList kullanın.
  • Sayfa ve makale varlığını bağlamak için WebPage veya @id referansları kullanın.

Araç sayfası

SoftwareApplication + WebPage + BreadcrumbList

  • Sayfa gerçek bir uygulama veya araç hakkındaysa SoftwareApplication kullanın.
  • İşletim sistemi, kategori, fiyat veya teklif detaylarını sadece görünür olduğunda dahil edin.
  • Sayfa gerçek inceleme verisi göstermiyorsa inceleme veya puanlama işaretlemesinden kaçının.

İnceleme sayfası

İnceleme / Ürün sadece sayfa destekliyorsa

  • İncelenen öğe, yazar, tarih ve puanlamayı sadece sayfa açıkça gösterdiğinde işaretleyin.
  • Ortaklık bağlantıları ve ticari bağlamı şeffaf tutun.
  • Şema ve görünür içerikte aynı puanı kullanın.

Soru sayfası

Sadece faydalı ve görünür Soru-Cevap için FAQPage

  • Her cevabı sadece anahtar kelime varyantı değil, kendi başına faydalı yapın.
  • Crawlerin erişemediği engellenmiş kullanıcı arayüzü arkasında cevapları gizlemeyin.
  • Ana SEO faydası olarak SSS zengin sonuçlarını beklemeyin.

Kaynaklar kontrol edildi

Yukarıdaki rehber, resmi Google Search Central ve schema.org dokümantasyonuna dayanır ve pratik bir JSON-LD kontrol listesine dönüştürülmüştür.

01 Google yapılandırılmış veri tanıtımı developers.google.com 02 Google yapılandırılmış veri politikaları developers.google.com 03 Google Article yapılandırılmış verisi developers.google.com 04 Google Breadcrumb yapılandırılmış verisi developers.google.com 05 Google SSS yapılandırılmış verisi developers.google.com 06 Google site bağlantıları arama kutusu güncellemesi developers.google.com 07 Schema.org başlangıç schema.org 08 Google Zengin Sonuçlar Testi search.google.com 09 Şema İşaretleme Doğrulayıcısı validator.schema.org

Sık sorulan sorular

JSON-LD şema işaretlemesi bir sıralama faktörü müdür?

JSON-LD tek başına sihirli bir sıralama anahtarı değildir. Arama motorlarının uygun içeriği anlamasına ve zengin sonuç uygunluğunu desteklemesine yardımcı olur, ancak sıralamalar hâlâ içerik kalitesi, alaka, taranabilirlik, bağlantılar ve diğer birçok sinyale bağlıdır.

JSON-LD sayfada nereye konmalı?

Genellikle head içindeki script etiketi yönetimi kolaydır, ancak Google JSON-LD'yi body içinde de okuyabilir. Önemli olan işaretlemenin render edilmiş sayfada bulunması ve görünür içerikle uyumlu olmasıdır.

Hâlâ FAQPage şeması kullanmalı mıyım?

Sayfa gerçekten faydalı görünür Soru-Cevap içeriyorsa FAQPage kullanın. Ek Google sonuç alanı için buna güvenmeyin, çünkü SSS zengin sonuç gösterimi çoğu site için büyük ölçüde azaltılmış ve kullanımdan kaldırılmıştır.

Bir sayfada birden fazla JSON-LD bloğu olabilir mi?

Evet. Normal bir makale sayfası Article, BreadcrumbList ve WebPage verilerine sahip olabilir. Blokları tutarlı tutun, çakışan yinelenen varlıklardan kaçının ve ilgili parçaları bağlamak için sabit @id değerleri kullanın.

JSON-LD, Microdata'dan daha mı iyidir?

Çoğu modern site için evet. Google JSON-LD, Microdata ve RDFa'yı destekler, ancak JSON-LD genellikle görsel HTML şablonlarında şema öznitelikleri gerektirmediği için daha kolay yönetilir.

Yapılandırılmış veriyi ne sıklıkla doğrulamalıyım?

Şablonları, meta veri alanlarını, şema yardımcılarını, URL'leri, dil yönlendirmesini, görsel oluşturmayı, inceleme verilerini veya SSS bölümlerini değiştirdiğinizde doğrulayın. Önemli sayfalar dizine eklendikten sonra Search Console'u da kontrol edin.