Schema Markup Nedir? Structured Data İçin Uygulama Rehberi

Structured data, sayfadaki varlık ve ilişkileri makinelerin okuyabileceği biçimde belirtir. Görünmeyen hizmet, sahte puan veya olmayan yorum eklemek doğru kullanım değildir; zengin sonuç garantisi vermez.

1. Sayfa türüne göre seçin

Teknik yazıda Article/BlogPosting, üründe Product, gezinme yolunda BreadcrumbList kullanılabilir. Google'ın o özellik için desteklediği alanları kontrol edin. Sadece schema.org'da bir türün bulunması Google'da özel görünüm sağlayacağı anlamına gelmez.

2. Yazı için JSON-LD örneği

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Linux disk kullanımını inceleme",
  "mainEntityOfPage": "https://example.com/bilgi-merkezi/linux-disk/",
  "author": {"@type": "Organization", "name": "Örnek Bilişim"},
  "datePublished": "2026-09-22T10:00:00+03:00"
}
</script>

Değerleri sayfanızın gerçek bilgileriyle değiştirin. Yeni bir dosya yüklemek eski yazının ilk yayın tarihini değiştirmemelidir. Görsel ekliyorsanız gerçekten erişilebilir temsilî görsel URL'si kullanın.

3. Güvenli üretin

PHP'de veritabanından gelen değerleri string birleştirmeyle JSON'a gömmeyin; json_encode kullanın. Script bağlamında JSON_HEX_TAG gibi bayraklarla kapanış etiketi enjeksiyonunu önleyin. Kullanıcı içeriğini ham script'e yazmayın.

4. Test

Rich Results Test ile desteklenen özellikleri, Schema Markup Validator ile genel yapıyı inceleyin. Kaynak HTML'de birden fazla eklentinin çelişen veri üretmediğini kontrol edin. Ürün fiyatı ve stok değiştiğinde schema aynı kaynaktan güncellenmelidir.

PHP şablonunda diziden JSON-LD üretme

PHP 7.3+ şablonunuzda, yalnız gerçek yazı bilgileriyle aşağıdaki örneği head bölümünde kullanabilirsiniz. Statik örnekle birlikte ikinci kez eklemeyin.

<?php
$articleSchema = [
    '@context' => 'https://schema.org',
    '@type' => 'BlogPosting',
    'headline' => 'Linux disk kullanımını inceleme',
    'mainEntityOfPage' => 'https://example.com/bilgi-merkezi/linux-disk/',
    'author' => ['@type' => 'Organization', 'name' => 'Örnek Bilişim'],
];
?>
<script type="application/ld+json"><?=
    json_encode($articleSchema, JSON_UNESCAPED_UNICODE | JSON_HEX_TAG |
        JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_THROW_ON_ERROR)
?></script>

CMS'deki başlık/URL alanlarını bu diziye sunucu tarafında bağlayın. Gerçek yayın tarihi ve görselleriniz varsa ilgili alanları ekleyin. Kod örneğini makalede göstermek için HTML kaçışlı pre/code gerekir; etkin şema üretmek için PHP şablonunda çalışması gerekir. Sayfa kaynağında PHP değil tamamlanmış JSON görünmeli.