
Bu kapsamlı rehberde structured data kavramı, Schema.org sözlüğü ve JSON-LD biçimi arasındaki ilişki detaylı şekilde açıklanır. Ayrıca Article, Organization, BreadcrumbList, WebSite, FAQPage ve Product gibi uygun şemaların HTML içinde nasıl konumlandırıldığı, hangi alanların neden önemli olduğu ve rich result ile structured data kavramlarının neden aynı şey olmadığı örneklerle ele alınır. İçerik, SEO uzmanları ve geliştiricilerin teknik uygulama ile arama motoru beklentilerini birlikte değerlendirebilmesi için hazırlanmıştır.
Arama motorları bir sayfayı sadece görünen metin üzerinden değerlendirmez. Sayfanın ne anlattığını, hangi varlıklarla ilişkili olduğunu, kimin yayınladığını ve içerik tipinin ne olduğunu daha net anlayabilmek için makine tarafından okunabilir ek sinyallere ihtiyaç duyar. Structured data tam olarak bu noktada devreye girer.
Ancak uygulamada sık yapılan bir hata vardır: structured data, Schema.org, JSON-LD ve rich result kavramlarının birbirine karıştırılması. Oysa bunlar aynı şey değildir; biri kavramsal çerçeve, biri sözlük, biri uygulama formatı, diğeri ise arama motorunun uygun görürse sunduğu bir çıktı biçimidir. Bu rehberde bu ilişkiyi teknik ve SEO açısından netleştirip, yaygın şemaların HTML'e nasıl eklendiğini örneklerle açıklayacağız.
Structured data, bir sayfadaki içeriğin anlamını açık şekilde tanımlamak için kullanılan yapılandırılmış veri katmanıdır. Normal bir paragraf içinde yer alan başlık, yazar, yayın tarihi veya ürün fiyatı insanlar için anlaşılır olabilir; fakat arama motorları için bu bilgiler her zaman yeterince kesin değildir. Structured data sayesinde bu alanlar açık etiketlerle işaretlenir ve yorumlama belirsizliği azaltılır.
SEO açısından structured data'nın temel amacı sıralama algoritmasını doğrudan manipüle etmek değil, içeriğin bağlamını daha anlaşılır hale getirmektir. Bu durum dizine ekleme, içerik sınıflandırma, varlık eşleştirme ve bazı arama özelliklerine uygunluk gibi alanlarda katkı sağlayabilir. Özellikle büyük içerik siteleri, e-ticaret projeleri, kurumsal siteler ve yayın platformları için bu işaretleme katmanı önemli bir teknik kalite unsurudur.
Structured data'nın bir diğer avantajı, aynı sitenin farklı sayfa tiplerini sistematik biçimde ayırt etmeyi kolaylaştırmasıdır. Bir sayfanın blog yazısı mı, ürün mü, kategori mi, kurum bilgisi mi yoksa soru-cevap içeriği mi olduğunu açık şekilde belirtmek, arama motorlarının site mimarisini daha iyi anlamasına yardımcı olur. Bu da özellikle teknik SEO, içerik modelleme ve ölçeklenebilir yayın yapıları açısından değer taşır.
Structured data bir üst kavramdır. Yani arama motorlarına makine tarafından anlaşılabilir veri sunma yaklaşımının genel adıdır. Schema.org ise bu veriyi ifade ederken kullanılabilecek türleri ve özellikleri tanımlayan ortak bir sözlüktür. Örneğin Article, Organization, Person, BreadcrumbList veya Product gibi tipler Schema.org sözlüğünün parçalarıdır.
JSON-LD ise bu sözlüğü kullanarak veriyi sayfaya eklemenin bir biçimidir. Başka bir ifadeyle Schema.org ne söyleyeceğinizi belirler, JSON-LD bunu nasıl yazacağınızı belirleyen formatlardan biridir. Aynı sözlük microdata veya RDFa ile de uygulanabilir; ancak günümüzde bakım kolaylığı, bileşen bazlı mimarilere uygunluğu ve ayrık veri katmanı yaklaşımı nedeniyle en yaygın tercih JSON-LD'dir.
Bu ilişkiyi basit bir çerçeveyle özetlemek mümkündür:
| Kavram | Rolü | Örnek |
|---|---|---|
| Structured data | Genel yaklaşım | Sayfanın içeriğini makineye açık anlatmak |
| Schema.org | Sözlük / şema tanımı | Article, Organization, BreadcrumbList |
| JSON-LD | Uygulama formatı | script içinde yapılandırılmış veri |
| Rich result | Olası arama sonucu görünümü | SSS kutuları, yıldız, ürün bilgisi |
Buradaki en kritik nokta şudur: JSON-LD kullanmak otomatik olarak rich result alacağınız anlamına gelmez. Arama motoru işaretlemeyi okuyabilir, anlayabilir, dizine işleyebilir; fakat bunu sonuç sayfasında özel görünüm olarak göstermeyebilir. Bu nedenle structured data'nın varlığı ile rich result görünürlüğünü aynı kavram gibi değerlendirmek teknik olarak yanlıştır.
Structured data, arama motoruna sunulan veridir; rich result ise arama motorunun bu veriyi ve sayfanın genel kalitesini uygun bulduğunda arama sonuçlarında oluşturabileceği geliştirilmiş sunum biçimidir. Yani structured data bir girdi, rich result ise potansiyel bir çıktıdır. Bu ayrımı net kurmak, özellikle raporlama ve beklenti yönetimi açısından çok önemlidir.
Bir sayfada geçerli Article veya Product işaretlemesi bulunabilir; ancak arama motoru bunu zengin sonuç olarak göstermeyebilir. Bunun nedeni sorgu niyeti, cihaz tipi, ülke, kalite sinyalleri, içerik yeterliliği, rekabet ortamı veya ilgili özelliğin o bölgede kullanılmaması olabilir. Dolayısıyla işaretleme uygulanmış olması, görünürlük biçiminin garanti edildiği anlamına gelmez.
Aynı şekilde rich result görünen her sonuç da yalnızca işaretleme sayesinde oluşmaz. Arama motorları bazen sayfa içeriğinden, başlıklardan, liste yapısından veya başka sinyallerden yararlanarak geliştirilmiş sonuçlar üretebilir. Ancak structured data, bu yorumlama işini daha güvenilir hale getiren net bir veri kaynağı sağladığı için yine de son derece değerlidir.
JSON-LD, yapılandırılmış veriyi HTML içeriğinden ayrıştırarak yönetmeyi kolaylaştırır. Özellikle modern framework'lerde, head yönetimi yapılan yapılarda ve CMS tabanlı sistemlerde veri katmanını merkezi biçimde üretmek büyük avantaj sağlar. Geliştirici, DOM içindeki her öğeye microdata etiketi dağıtmak yerine tek bir script bloğunda ilgili varlıkları tanımlayabilir.
Bakım kolaylığı da önemli bir avantajdır. Örneğin Article şemasındaki başlık, yayın tarihi, yazar ve görsel gibi alanlar doğrudan veri modelinden çekilerek oluşturulabilir. İçerik şablonu değişse bile structured data mantığı korunur; bu da özellikle çok sayıda sayfa üreten sistemlerde hata riskini azaltır.
JSON-LD genellikle HTML içinde head bölümüne veya body içinde uygun bir noktaya script etiketi ile eklenir. Arama motorları için önemli olan görünürlük değil, parse edilebilirliktir. Yine de pratikte merkezi yönetim ve tutarlılık için çoğu projede head içinde konumlandırmak daha düzenli bir yaklaşım sağlar.
Aşağıdaki örnek en temel yapıyı gösterir:
JSON{ "@context": "https://schema.org", "@type": "Organization", "name": "Örnek Şirket", "url": "https://www.ornekdomain.com/" }
Bu veri genellikle HTML içinde şu şekilde yer alır:
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Organization", "name": "Örnek Şirket", "url": "https://www.ornekdomain.com/" } </script>
Article, blog yazıları, haber içerikleri, rehberler ve editorial sayfalar için en yaygın şema tiplerinden biridir. Bu şema, arama motoruna sayfanın bir makale olduğunu, kimin yazdığını, ne zaman yayınlandığını, hangi başlığa sahip olduğunu ve hangi görselin temsil edici olduğunu açıkça anlatır. İçerik siteleri için bu yapı, bilgi mimarisi açısından temel seviyede önemlidir.
Article içinde kullanılabilecek alanlar çok geniştir; ancak her projede gerçekten mevcut ve sayfada doğrulanabilir alanlar kullanılmalıdır. headline, datepUblished, datemOdified, author, publisher, image ve maineNtityoFpAge en yaygın öğelerdendir. Bu verilerin sayfa içeriğiyle tutarlı olması gerekir; aksi halde güven problemi doğabilir.
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Structured Data, Schema.org ve JSON-LD İlişkisi", "description": "Structured data ve JSON-LD ilişkisini SEO ve geliştirme açısından açıklayan kapsamlı rehber.", "image": [ "https://www.ornekdomain.com/images/structured-data-rehberi.jpg" ], "author": { "@type": "Person", "name": "Ahmet Yılmaz" }, "publisher": { "@type": "Organization", "name": "Pratikweb", "logo": { "@type": "ImageObject", "url": "https://www.ornekdomain.com/images/logo.png" } }, "datePublished": "2026-11-06", "dateModified": "2026-11-06", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.ornekdomain.com/blog/structured-data-schema-org-json-ld-iliskisi" } } </script>
Burada dikkat edilmesi gereken nokta, işaretlenen içeriğin gerçekten bir makale olmasıdır. Salt hizmet sayfalarını, kategori sayfalarını veya ince içerikleri yalnızca daha güçlü görünsün diye Article olarak işaretlemek doğru yaklaşım değildir. Şema tipi, sayfa tipine hizmet etmelidir; sayfa tipi şemaya uydurulmamalıdır.
Eğer içerik açık biçimde bir blog yazısıysa aRticle yerine bLogpOsting kullanmak daha spesifik olabilir. bLogpOsting, Article'ın daha özelleşmiş bir alt türüdür. Ancak pratikte ikisi arasında tercih yapılırken asıl önemli olan, veri doğruluğu ve içerik tipiyle uyumdur.
Birçok sitede yalnızca içerik şeması eklenir, ancak marka ve site düzeyindeki varlık tanımları ihmal edilir. Oysa Organization, WebSite ve gerektiğinde WebPage işaretlemeleri arama motoruna sadece bir sayfanın değil, onu yayınlayan yapının da ne olduğunu anlatır. Bu yaklaşım özellikle kurumsal SEO, marka görünürlüğü ve varlık temelli arama anlayışı açısından değerlidir.
Organization şeması şirket, kurum veya marka bilgisini tanımlar. Ad, URL, logo, iletişim noktaları ve sosyal profil bağlantıları gibi alanlar burada yer alabilir. WebSite ise bütün siteyi bir varlık olarak tanımlar ve bazen site içi arama gibi özelliklerle ilişkilendirilebilir. WebPage ise tekil sayfanın varlık düzeyinde tanımlanmasını sağlar ve diğer şemalarla bağ kurulmasına yardımcı olur.
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Organization", "name": "Pratikweb", "url": "https://www.pratikweb.net/", "logo": "https://www.pratikweb.net/logo.png", "sameAs": [ "https://www.linkedin.com/company/ornek", "https://x.com/ornekmarka" ] } </script>
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebSite", "name": "Pratikweb", "url": "https://www.pratikweb.net/" } </script>
Organization ve WebSite verilerini genellikle site genelinde, özellikle ana sayfa ve temel şablonlarda üretmek mantıklıdır. Bununla birlikte gereksiz tekrar, çelişkili alanlar veya farklı sayfalarda farklı logo ve URL kullanımı gibi tutarsızlıklardan kaçınılmalıdır. Şemalar arası ilişki, teknik bütünlük açısından kritik öneme sahiptir.
BreadcrumbList, sayfanın site hiyerarşisindeki yerini arama motoruna anlatır. Kullanıcı arayüzünde görülen breadcrumb yapısı zaten iç bağlantı ve kullanılabilirlik açısından faydalıdır; structured data ile desteklendiğinde bu hiyerarşi makine tarafından daha net anlaşılır. Özellikle derin kategori yapısına sahip sitelerde, bloglarda ve e-ticaret projelerinde güçlü bir destekleyici şemadır.
Bu şemada her adım lIstiTem olarak tanımlanır ve position, name, item alanlarıyla belirtilir. Sıralamanın doğru olması önemlidir; çünkü breadcrumb mantığı hiyerarşik bir ilerleme anlatır. URL'lerin gerçekten kullanıcıyı ilgili üst seviyelere götürmesi gerekir.
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Ana Sayfa", "item": "https://www.ornekdomain.com/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.ornekdomain.com/blog" }, { "@type": "ListItem", "position": 3, "name": "Structured Data Rehberi", "item": "https://www.ornekdomain.com/blog/structured-data-schema-org-json-ld-iliskisi" } ] } </script>
Burada görünen breadcrumb ile işaretlemenin birebir uyumlu olması tavsiye edilir. Kullanıcıya farklı, arama motoruna farklı hiyerarşi göstermek güven ve bakım açısından sorun üretir. Eğer sayfada breadcrumb arayüzü yoksa yine de kullanılabilir, fakat özellikle büyük yapılarda görünür hiyerarşi ile birlikte uygulanması daha sağlıklıdır.
Article, Organization ve BreadcrumbList çok yaygın olsa da birçok projede başka şemalar da uygundur. Önemli olan, sadece gerçekten sayfada bulunan ve kullanıcıya sunulan içeriği işaretlemektir. Şema seçimi bir SEO süsü değil, içerik modelleme kararı olarak ele alınmalıdır.
FAQPage, sayfada gerçekten soru-cevap formatında hazırlanmış bir bölüm varsa değerlidir. Product, ürün detay sayfaları için uygundur ve fiyat, stok, marka, değerlendirme gibi alanları içerebilir. LocalBusiness ise fiziksel lokasyonu olan işletmeler için anlamlıdır; Person ise yazar, uzman veya ekip üyesi sayfalarında kullanılabilir.
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Structured data ile rich result aynı şey midir?", "acceptedAnswer": { "@type": "Answer", "text": "Hayır. Structured data, makine tarafından okunabilir veri katmanıdır. Rich result ise arama motorunun uygun görürse sunduğu zengin sonuç görünümüdür." } }, { "@type": "Question", "name": "Schema.org ne işe yarar?", "acceptedAnswer": { "@type": "Answer", "text": "Schema.org, yapılandırılmış veride kullanılacak tür ve özellikleri tanımlayan ortak sözlüktür." } } ] } </script>
HTML<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Product", "name": "Kurumsal Web Sitesi Paketi", "image": "https://www.ornekdomain.com/images/kurumsal-paket.jpg", "description": "Küçük ve orta ölçekli işletmeler için hazır kurumsal web sitesi paketi.", "brand": { "@type": "Brand", "name": "Pratikweb" }, "offers": { "@type": "Offer", "priceCurrency": "TRY", "price": "14999", "availability": "https://schema.org/InStock", "url": "https://www.ornekdomain.com/paketler/kurumsal-web-sitesi" } } </script>
Bu tür şemalarda en sık hata, sayfada görünmeyen veriyi eklemek veya dinamik alanları güncel tutmamaktır. Özellikle fiyat, stok ve değerlendirme gibi alanlar senkronize değilse yapılandırılmış veri kalite sorunu oluşturabilir. Teknik ekip ile içerik ekibi arasındaki veri akışı bu yüzden son derece önemlidir.
Uygulama tarafında en iyi yaklaşım, structured data üretimini şablon veya bileşen mantığına bağlamaktır. Örneğin blog detay sayfası açıldığında Article ve BreadcrumbList; ana sayfa yüklendiğinde Organization ve WebSite; ürün sayfasında Product ve BreadcrumbList otomatik olarak üretilmelidir. Böylece manuel hata oranı düşer ve içerik ölçeklendikçe yapı korunur.
JSON-LD script blokları tek bir büyük nesne ya da birden fazla ayrı blok halinde kullanılabilir. Her iki yöntem de geçerlidir; önemli olan tutarlılık ve parse edilebilirliktir. Büyük yapılarda sayfa tipi başına modüler script üretmek bakım açısından daha okunabilir olabilir.
HTML<!doctype html> <html lang="tr"> <head> <meta charset="utf-8" /> <title>Structured Data Rehberi</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Organization", "name": "Pratikweb", "url": "https://www.pratikweb.net/", "logo": "https://www.pratikweb.net/logo.png" } </script> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Ana Sayfa", "item": "https://www.ornekdomain.com/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.ornekdomain.com/blog" }, { "@type": "ListItem", "position": 3, "name": "Structured Data Rehberi", "item": "https://www.ornekdomain.com/blog/structured-data-schema-org-json-ld-iliskisi" } ] } </script> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Structured Data, Schema.org ve JSON-LD İlişkisi", "author": { "@type": "Person", "name": "Ahmet Yılmaz" }, "publisher": { "@type": "Organization", "name": "Pratikweb", "logo": { "@type": "ImageObject", "url": "https://www.pratikweb.net/logo.png" } }, "datePublished": "2026-11-06", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.ornekdomain.com/blog/structured-data-schema-org-json-ld-iliskisi" } } </script> </head> <body> <article> <h1>Structured Data, Schema.org ve JSON-LD İlişkisi</h1> <p>...</p> </article> </body> </html>
Bu örnekte farklı seviyelerdeki varlıklar ayrı ayrı tanımlanmıştır. Marka düzeyi için Organization, sayfa hiyerarşisi için BreadcrumbList ve içerik düzeyi için Article kullanılmıştır. Bu yaklaşım, özellikle semantik netlik ve bakım yönetimi açısından oldukça etkilidir.
Structured data uygulamalarında en yaygın problem, geçersiz JSON sözdiziminden çok anlamsal uyumsuzluktur. Yani veri teknik olarak parse edilebilir olsa bile, sayfada görünmeyen alanlar, yanlış şema tipi, boş bırakılmış kritik özellikler veya birbiriyle çelişen varlık tanımları sorun yaratır. Bu nedenle sadece kodun hata vermemesi yeterli değildir; işaretlemenin bağlama uygun olması gerekir.
Özellikle şu hatalar sık görülür: her sayfaya aynı Article verisinin basılması, ürün olmayan sayfaların Product diye işaretlenmesi, breadcrumb URL'lerinin bozuk olması, Organization ile publisher adlarının farklılaşması ve tarih alanlarının otomatik güncellenmeden kalması. Büyük sitelerde bu tür sorunlar şablon hatası nedeniyle binlerce sayfaya yayılabilir.
Doğrulama sürecinde yalnızca biçimsel kontrol yapmak yeterli değildir. Ekipler hem kod doğrulaması hem de örnek sayfa incelemesi yapmalıdır. Özellikle template tabanlı projelerde kategori, içerik, ürün ve kurumsal sayfa örnekleri ayrı ayrı test edilmelidir. Böylece tek bir yapısal hata tüm siteye yayılmadan yakalanabilir.
SEO ekibi structured data'yı yalnızca ek bir görev gibi değil, içerik modeli ve arama motoru iletişim katmanı olarak değerlendirmelidir. Geliştirici ekip ise bunu sadece script eklemekten ibaret görmemeli; veri kaynağı, şablon mantığı, güncellik ve ölçeklenebilirlik boyutlarıyla ele almalıdır. Başarılı uygulamalar genellikle bu iki disiplinin birlikte çalıştığı projelerde ortaya çıkar.
Örneğin hazır web sitesi ve geliştirilebilir platform mantığıyla çalışan yapılarda, sayfa tipine göre otomatik şema üretimi büyük avantaj sağlar. Blog modülü için Article, kurum sayfaları için Organization, ürün detayları için Product, kategori hiyerarşisi için BreadcrumbList gibi modeller baştan tasarlanırsa hem teknik kalite artar hem de büyüyen içerik yapısında sürdürülebilirlik sağlanır. Bu yaklaşım, özellikle hizmetlerini modüler ve yönetilebilir altyapılar üzerinden sunan platformlar için son derece uygundur.
Yol haritası oluştururken önce mevcut sayfa tiplerini envanterleyin. Ardından her tip için en uygun Schema.org türlerini seçin, zorunlu ve önerilen alanları belirleyin, veri kaynaklarını tanımlayın ve bunu şablon düzeyinde kodlayın. Son aşamada düzenli test, izleme ve içerik ekibi eğitimi ile sistemin tutarlı çalışmasını sağlayın.
Structured data'nın amacı arama motorunu kandırmak değil, içeriği açık ve makine tarafından anlaşılır hale getirmektir. Schema.org bu anlatımın sözlüğünü sunar, JSON-LD ise en pratik uygulama formatlarından biridir. Rich result ise bunun garantili sonucu değil, olası bir arama motoru sunumudur.
Bu nedenle en doğru yaklaşım, sayfanın gerçek yapısına uygun şemayı seçmek, veriyi HTML içinde temiz ve tutarlı biçimde sunmak ve görünür içerikle birebir eşleşen bir işaretleme sistemi kurmaktır. Eğer siz de içerik, hizmet veya platform sayfalarınızı teknik olarak daha anlaşılır hale getirmek istiyorsanız, structured data'yı bir eklenti değil, kalıcı bilgi mimarisi katmanı olarak konumlandırın.