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.
İçindekiler
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.
Ş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.
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.
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.
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.
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.
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.
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.
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.
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.
<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>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>");
}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çYayınladıktan sonra
Search Console
Google sayfayı işledikten sonra tarama, dizine ekleme ve yapılandırılmış veri sorunlarını tespit etmek için URL Denetimi ve Geliştirme raporlarını kullanın.
Google yapılandırılmış veri dokümanlarını okuyunGü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
Bu rehber için araştırma kaynakları
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.
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.