Yapılandırılmış Veri Nedir? Şema İşaretlemesi Basitçe Anlatıldı

Yapılandırılmış veri, bir web sayfasındaki küçük bir kod bloğudur. Sayfanın neyle ilgili olduğunu arama motorlarının anlayabileceği standart bir biçimde etiketler — örneğin “bu sayfa Lavender Candle adlı bir ürün, fiyatı 24 dolar ve stokta.” Google bunu, sayfa hakkında bilgi vermek ve içeriğini sınıflandırmak için standart bir biçim olarak tanımlar. Doğru yapıldığında arama motorlarının sayfanızı anlamasına yardımcı olur ve fiyat, puan ya da etkinlik tarihi gibi bilgilerin arama sonucunda doğrudan gösterildiği zengin sonuçlara uygun hale gelmesini sağlayabilir.

Yapay zekayla geliştirirken neden önemli

Arama motorları sayfaları okumakta iyidir, ama yine de tahmin yürütmek zorundadır. “24” bir fiyat mı, adet mi, yoksa bir tarih mi? “Riverside Hall” bir mekân mı, yoksa bir kişi mi? Yapılandırılmış veri bu tahmin işini ortadan kaldırır.

Yapay zekayla oluşturulan siteler için iki pratik nokta var:

• Bu bir kod, içerik değil, bu yüzden kolayca unutulabilir. Bir yapay zeka oluşturucu, siz istemedikçe genellikle bunu eklemez; eklediğinde ise gerçekte sayfada olanla eşleşmesi gerekir.
• Doğru görünen ama yanlış olabilecek şekillerde hatalı yapılması kolaydır. Yapay zeka uydurma bir beş yıldızlı puan ekleyebilir, görünmeyen içerik için işaretleme koyabilir ya da Google'ın artık göstermediği bir tür kullanabilir. Google'ın kuralları doğruluk konusunda serttir; yanıltıcı işaretleme yok sayılabilir ya da cezalandırılabilir.

Gerçek içeriğinize uygun, doğru bir miktar yapılandırılmış veri faydalıdır. Çok sayıda uydurma işaretleme ise hiç olmamasından daha kötüdür.

Günlük bir benzetme

Bir süpermarketteki ürünü düşünün. Ambalajın renkli tasarımı ve pazarlama metni vardır — bu, insanların gördüğü web sayfanızdır. Ama arkasında standart bir besin etiketi de bulunur: her üründe aynı sırada, aynı alanlar. Herkes bunu hızlıca okuyup ürünleri karşılaştırabilir.

Yapılandırılmış veri, sayfanızın besin etiketidir. Tasarım istediğiniz gibi olabilir; etiket ise makinelerin güvenilir biçimde okuyabilmesi için standarttır. Ve bir besin etiketi gibi, içindekiler konusunda dürüst olmalıdır.

Yapılandırılmış veri nasıl çalışır

Yapılandırılmış verinin iki parçası vardır:

1. Bir sözlük — şeyleri tanımlamak için kullanılan kelimeler. En yaygını schema.org'dur; Product, LocalBusiness, Event, Article, Recipe ve Organization gibi türleri ile name, price, address ve startDate gibi özellikleri içeren ortak bir sözlüktür.
2. Bir biçim — etiketlerin sayfaya nasıl yazıldığı. Google üç biçimi destekler: JSON-LD, Microdata ve RDFa. Google, JSON-LD'yi önerir: bu, görünen HTML'den ayrı tutulan, bir <script> etiketi içindeki bir JSON bloğudur.

Arama motorları bu bloğu okur, sayfadaki varlıkları anlar ve sayfa uygunsa ve gereksinimleri karşılıyorsa — ek ayrıntı içeren bir arama sonucu olan zengin sonuç — gösterebilir.

Çalışılmış bir örnek: bir mum dükkânının ürün sayfası

Diyelim ki bir çevrimiçi mağaza kurdunuz ve bir sayfada lavanta mumu satıyorsunuz. Görünen sayfada ad, fotoğraf, açıklama, fiyat ($24.00) ve “Stokta” yazıyor.

Bu sayfa için JSON-LD şöyle görünebilir:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Lavender Soy Candle",
  "image": "https://www.examplecandles.com/images/lavender.jpg",
  "description": "Hand-poured soy candle with lavender essential oil. Burns for about 40 hours.",
  "sku": "CAN-LAV-01",
  "brand": { "@type": "Brand", "name": "Example Candles" },
  "offers": {
    "@type": "Offer",
    "url": "https://www.examplecandles.com/candles/lavender",
    "price": "24.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

Bu kod, sayfanın HTML'inde <script type="application/ld+json">…</script> içine yerleştirilir.

Dikkat edin, burada olmayan bir şey var: aggregateRating. Çünkü mağaza sayfada yorum göstermiyor. Ziyaretçilerin göremeyeceği bir puanı eklemek Google'ın kurallarını ihlal eder.

Aynı mağazanın iletişim sayfası ise işletmenin kendisini şöyle tanımlayabilir:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Example Candles",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "12 Market Street",
    "addressLocality": "Bristol",
    "postalCode": "BS1 1AA",
    "addressCountry": "GB"
  },
  "telephone": "+44 117 000 0000",
  "openingHours": "Mo-Sa 10:00-17:00"
}

Yine, her değer sayfada görünen bilgiyle eşleşir.

Kontrol etmek. Canlı URL'yi Google'ın Zengin Sonuç Testi'ne yapıştırarak sayfanın Google'ın zengin sonuçlarına uygun olup olmadığını ve eksik bir şey bulunup bulunmadığını görebilirsiniz. Genel bir schema.org kontrolü için Schema Markup Validator kullanın. Yayından sonra Search Console, site genelindeki hataları gösterir.

Bilmeye değer kurallar

Google'ın yapılandırılmış veri dokümantasyonundan:

• Yalnızca kullanıcıların görebildiği şeyleri işaretleyin. Sayfada görünmeyen bilgiyi, doğru olsa bile, işaretlemeyin.
• Gerekli özellikleri ekleyin. Her zengin sonuç türü gerekli alanları listeler; eksik olanlar sayfayı uygunsuz hale getirir.
• Uygunluk garanti değildir. Doğru işaretleme, bir sayfayı zengin sonuca uygun kılar; ama bunu mutlaka alacağı anlamına gelmez.
• Zengin sonuç türleri değişir. Google bazı özellikleri zaman içinde kaldırır. Örneğin SSS zengin sonuçları yalnızca tanınmış devlet ve sağlık sitelerine sınırlandırılmıştı ve Google, bunların Mayıs 2026'dan itibaren Aramada görünmeyeceğini duyurdu. Belirli bir zengin sonuç için geliştirme yapmadan önce Google'ın güncel arama galerisine bakın.
• Yalnızca işaretleme tutmak için sayfa oluşturmayın.

Sık kullanılan terimler

Sık yapılan hatalar ve yanlış anlamalar

• “Yapılandırılmış veri sıralamayı yükseltir.” Asıl değeri anlaşılmasını sağlaması ve zengin sonuç uygunluğudur; bir sıralama kısayolu değildir.
• Yorum veya puan uydurmak. Sahte ya da desteklenmeyen puanlar Google'ın kurallarını ihlal eder ve insanları yanıltır.
• Sayfayla eşleşmeyen işaretleme. JSON-LD'de $24, sayfada $29 ise bu bir sorundur.
• Gizli içerik. Ziyaretçilerin göremediği metni işaretlemek yönergelere aykırıdır.
• İşaretlemeyi her sayfaya kopyalamak. Product bloğu ürün sayfalarına aittir; ana sayfaya ya da bloga değil.
• Kaldırılmış özellikler için geliştirmek. İstediğiniz zengin sonucun hâlâ var olup olmadığını kontrol edin.
• İşaretlemeyi yalnızca tarayıcıda eklemek. Siteniz her şeyi JavaScript ile oluşturuyorsa Google yine de bulabilir; ama JSON-LD'yi sunucunun gönderdiği HTML'e koymak daha güvenilirdir.
• Hiç test etmemek. Eksik bir virgül tüm bloğu okunamaz hale getirir.

Yapay zeka oluşturucunuzdan ne istemelisiniz

• “Her sayfaya uygun schema.org türlerini kullanarak JSON-LD yapılandırılmış veri ekle: ürün sayfalarında Product, iletişim sayfasında LocalBusiness, blog yazılarında Article.”
• “Değerleri, sayfada gösterilen aynı veriden üret; böylece her zaman eşleşsin.”
• “Puan, yorum ya da sayfada görünmeyen hiçbir özellik ekleme.”
• “JSON-LD'yi sunucuda oluşturulan ya da önceden oluşturulmuş HTML'e koy.”
• “O zengin sonuç türü için Google'ın gerektirdiği tüm özellikleri ekle ve hangilerini kullandığını söyle.”
• “Zengin Sonuç Testi'nde kontrol edilecek URL'lerin listesini ver.”

Bunun daha büyük resimdeki yeri için SEO nedir, site haritası nedir ve teknik anlatım için yapay zekayla oluşturulan web siteleri için SEO rehberlerine bakın.

Mythex'te yapılandırılmış veri

Mythex, yapılandırılmış veriyi sizin için otomatik olarak eklemez; bunu sohbette istersiniz ve agent bunu uygulamanızın koduna yazar. Hangi sayfaların ürünleri, etkinlikleri ya da işletmenizi temsil ettiğini söyleyin ve JSON-LD'yi sayfanın gösterdiği aynı veriden üretmesini isteyin. Yayınlanmış uygulamanız için SEO dokümantasyon tarifi, “Sahte yorum şeması ekleme” satırını içerir; bu, her isteme eklenmesi gereken iyi bir öğüttür. Varsayılan kurulum istemci tarafında oluşturulan tek sayfalık bir uygulama olduğundan, aramanın önemli olduğu durumlarda önceden oluşturulmuş ya da statik yapıya dostu bir yapı isteyin; ardından yayınlayın ve canlı URL'leri test edin.

Sorular