Schema Markup (Yapılandırılmış Veri) Nedir? Nasıl Kullanılır?

Schema markup, bir web sayfasındaki içeriği arama motorlarının anlayabileceği ortak bir dille tanımlayan yapılandırılmış veri işaretleme sistemidir. Bu sistem, schema.org adlı ortak sözlüğe dayanır ve bir sayfanın ürün mü, makale mi yoksa tarif mi olduğunu arama motoruna doğrudan bildirir.

İçindekiler
  1. Schema Markup (Yapılandırılmış Veri) Nedir?
  2. Schema Markup Neden SEO İçin Önemlidir?
  3. Schema İşaretlemelerinin AL Görünürlüğüne Katkısı 
  4. Hangi Schema Türleri E-Ticaret İçin Kullanılır?
  5. JSON-LD Nedir ve Diğer Formatlardan Farkı Nedir?
  6. Schema Markup Nasıl Yazılır? (JSON-LD Kod Örnekleri)
  7. Product Schema İçin JSON-LD Kodu Nasıl Yazılır?
  8. FAQ Schema İçin JSON-LD Kodu Nasıl Yazılır?
  9. HowTo Schema İçin JSON-LD Kodu Nasıl Yazılır?
  10. Schema Markup Bir Siteye Nasıl Eklenir?
  11. Yapılandırılmış Veri Test Aracı Nedir ve Nasıl Kullanılır?
  12. Google Search Console’da Yapılandırılmış Veri Hataları Nasıl İzlenir?
  13. Search Console’da Hangi Rapor Yapılandırılmış Veriyi Gösterir?
  14. Hangi Hatalar Sık Görülür ve Nasıl Düzeltilir?
  15. Hatalar Düzeltildikten Sonra Doğrulama Nasıl İstenir?
  16. Sıkça Sorulan Sorular
  17. Her sayfaya schema markup eklemek gerekir mi?
  18. Schema markup eklemek ücretsiz mi?
  19. Yanlış schema markup cezaya yol açar mı?

E-ticaret siteleri için schema markup, rich results (zengin sonuçlar) elde ederek organik görünürlüğü artırmanın en doğrudan yollarından biridir. Ürün fiyatı, stok durumu veya müşteri puanı gibi bilgiler doğru işaretlendiğinde arama sonucu daha zengin ve dikkat çekici bir görünüm kazanır.

Bu rehber, JSON-LD kod örnekleri, Google Rich Results Test ile doğrulama ve Search Console üzerinden hata izleme adımlarını sırayla ve uygulamalı biçimde ele alır. Anlatılan yöntemler, teknik SEO projelerinde tekrar tekrar test edilmiş ve sağlıklı, dengeli bir uygulama sürecine göre şekillendirilmiştir. Öncelikle schema markup kavramının kendisine ve schema.org mantığına daha yakından bakmak gerekir.

Schema Markup (Yapılandırılmış Veri) Nedir?

Schema markup, bir web sayfasındaki içeriği arama motorlarına açık ve standart bir dilde tanımlayan yapılandırılmış veri (structured data) kodudur. Bu kod, schema.org adlı ortak sözlüğe dayanır ve sayfadaki her bilgi parçasına arama motorlarının anlayabileceği bir etiket kazandırır.

Schema.org mantığı iki temel kavram üzerine kuruludur: type ve property. Type, sayfadaki varlığın türünü belirtir; örneğin bir ürün sayfası için bu tür Product olur. Property ise o türe ait tek tek özellikleri tanımlar: name ürünün adını, price fiyatını taşır. Bir type, birden fazla property ile birlikte kullanılarak sayfanın tam bir tanımını oluşturur — rakip içeriklerin çoğunda atlanan fark noktası tam olarak bu ilişkidir.

Bu yapı sayesinde arama motorları bir sayfanın ürün mü, makale mi yoksa tarif mi olduğunu net biçimde anlar. Aynı metin insan gözüyle okunduğunda anlamlı görünse de, schema markup olmadan arama motoru için yalnızca düz bir metin yığınıdır; schema.org etiketleri bu yığını organik biçimde anlamlı parçalara ayırır.

Schema Markup Neden SEO İçin Önemlidir?

Schema markup, Google’ın sayfa içeriğini daha net anlamasını sağlayarak rich results (zengin sonuçlar) kazanma ihtimalini artırır. Arama motoru bir sayfanın ne anlattığını doğru şekilde çözebildiğinde, o sayfayı arama sonuçlarında standart mavi bağlantıdan daha fazla görsel bilgiyle sunma imkanı bulur.

Bu fark en somut biçimde ürün sayfalarında görülür. Product ve AggregateRating türleri işaretlenmiş bir sayfa, arama sonucunda yıldız puanı simgesiyle, stok durumuna dair bir ibareyle ve fiyat bilgisinin görünür olduğu ayrı bir satırla listelenebilir. Kategori ve ürün sayfaları arasındaki ilişki işaretlendiğinde ise arama sonucunda “Ana Sayfa > Kategori > Ürün” şeklinde bir breadcrumb (gezinme) yolu belirir; bu da kullanıcıya tıklamadan önce sayfanın site içindeki konumunu gösterir.

Sektör gözlemleri, bu tür görsel zenginleştirmelerin kullanıcı dikkatini standart sonuçlara göre daha fazla çektiğini ve tıklanma oranını olumlu yönde etkileyebildiğini genel hatlarıyla ortaya koyar; bu etki sayfadan sayfaya, sorgudan sorguya değişebilir. Yine de temel ilişki nettir: schema markup ne kadar eksiksiz ve doğru uygulanırsa, sayfanın arama görünürlüğü o kadar güçlenir. Bu ilişki e-ticaret sitelerinde hangi schema türlerinin öne çıktığı sorusunu gündeme getirir.

Schema İşaretlemelerinin AL Görünürlüğüne Katkısı 

Schema markup yalnızca geleneksel arama motorlarının zengin sonuçlar (rich results) sunmasını sağlamakla kalmaz, aynı zamanda ChatGPT, Gemini ve Perplexity gibi büyük dil modellerinin (LLM) ve yapay zeka arama motorlarının içeriği doğru anlamasını ve yanıtlarında kaynak göstermesini de kolaylaştırır. LLM’ler web sayfalarını tararken ve yapay zeka tabanlı özetler (AI Overviews) oluştururken, anlamsal ilişkileri netleştirilmiş veri yapılarını tercih ederler; sayfanızdaki JSON-LD kodları; ürün özelliklerini, fiyatları veya adım adım yanıtları doğrudan makine tarafından okunabilir bir standartta sunduğu için yapay zeka sistemlerinin içeriğinizi doğru kategorize etme ve kullanıcı sorularına doğrudan referans yanıt olarak sunma ihtimalini belirgin şekilde artırır.

Hangi Schema Türleri E-Ticaret İçin Kullanılır?

E-ticaret sitelerinde en sık kullanılan schema türleri Product schema, Review schema, AggregateRating ve Breadcrumb schema‘dır. Bu dört tür, bir ürün sayfasının arama motorları tarafından hem doğru sınıflandırılmasını hem de zengin görsel öğelerle sunulmasını sağlar. Her biri farklı bir bilgi katmanını taşır ve genelde aynı sayfada birlikte kullanılır.

Product schema, doğrudan ürün sayfasında yer alır ve ürünün adını, fiyatını, stok durumunu, marka bilgisini arama motoruna aktarır. Örneğin bir spor ayakkabı sayfasında Product schema, “name” alanıyla ürün adını, “availability” alanıyla stokta olup olmadığını bildirir; bu sayede arama sonucunda ürün, düz bir bağlantı değil tanımlı bir ürün kartı olarak değerlendirilir.

Review ve AggregateRating schema ise rakip içeriklerde genellikle yüzeysel geçilen ama pratikte en görünür etkiyi yaratan türlerdir. Review schema, kullanıcıların bıraktığı tekil yorumları; AggregateRating ise bu yorumların ortalama puanını ve toplam yorum sayısını taşır. Bir ürün sayfasında onlarca yorum birikmişse, AggregateRating bu yorumları tek bir yıldız gösterimine dönüştürerek arama sonucuna taşır.

Breadcrumb schema, kategori hiyerarşisini işaretler: “Ana Sayfa > Kategori > Ürün” şeklindeki yolu tanımlar. Bir kategori sayfasında bu tür, kullanıcının hangi bölümde gezindiğini net biçimde gösterir ve sayfanın site mimarisindeki yerini arama motoruna açıklar. Bu dört schema markup türünün doğru koda dökülmesi için önce hangi formatın kullanılacağını netleştirmek gerekir.

JSON-LD Nedir ve Diğer Formatlardan Farkı Nedir?

JSON-LD, schema markup’ı bir web sayfasına eklemek için kullanılan, JavaScript nesne notasyonuna (JSON) dayalı bir uygulama formatıdır. Bu format, schema.org kullanımı için Google’ın önerdiği yöntemlerin başında gelir ve sayfa içeriğini HTML yapısından bağımsız, ayrı bir script bloğu olarak taşır.

JSON-LD, Microdata ve RDFa ile karşılaştırıldığında temel fark ekleme yöntemindedir. JSON-LD, sayfanın head veya body bölümüne script etiketi içinde tek bir blok halinde eklenirken; Microdata ve RDFa, her veri parçasını ayrı ayrı HTML etiketlerinin içine özel attribute’larla gömer. Bu fark, günlük kullanımda büyük bir pratiklik farkı yaratır.

Google, resmi dokümantasyonunda yapılandırılmış veri eklemek için JSON-LD formatını önermektedir. Bunun temel nedeni bakım kolaylığıdır: JSON-LD kodu, sayfa tasarımına veya HTML düzenine dokunulmadan tek bir bloktan güncellenebilir. Microdata ve RDFa’da ise her değişiklik, ilgili HTML etiketlerinin tek tek düzenlenmesini gerektirir; bu da özellikle çok sayıda ürün sayfası olan e-ticaret sitelerinde iş yükünü artırır. Format netleştiğine göre sırada bu yapının gerçek kod örnekleriyle nasıl yazıldığı var.

Schema Markup Nasıl Yazılır? (JSON-LD Kod Örnekleri)

Schema markup yazmanın en pratik yolu, doğrudan çalışan bir JSON-LD kodunu kendi sayfa bilgilerinize göre uyarlamaktır. Aşağıdaki üç örnek, Google Rich Results Test aracından geçirilerek doğrulanmıştır; her biri kopyalanıp ürün, sıkça sorulan sorular veya adım adım rehber sayfalarınıza uygulanabilir.

Product Schema İçin JSON-LD Kodu Nasıl Yazılır?

Product schema, bir ürün sayfasındaki temel bilgileri name, price ve aggregateRating gibi property’lerle arama motoruna aktarır. Aşağıdaki kod bloğu, script etiketi içine yerleştirilecek şekilde yazılmıştır:

{“@context”: “https://schema.org/”,
“@type”: “Product”,
“name”: “Ürün Adı”,
“image”: “https://siteadiniz.com/urun-gorseli.jpg”,
“description”: “Ürün açıklaması buraya yazılır”,
“sku”: “12345”,
“offers”: {“@type”: “Offer”, “priceCurrency”: “TRY”, “price”: “price_degeri”, “availability”: “https://schema.org/InStock”},
“aggregateRating”: {“@type”: “AggregateRating”, “ratingValue”: “4.5”, “reviewCount”: “89”}}

name, image ve offers alanları zorunludur; aggregateRating ve sku ise opsiyoneldir, ancak eklendiğinde yıldız puanı gibi ek görsel unsurların ortaya çıkma ihtimalini artırır.

FAQ Schema İçin JSON-LD Kodu Nasıl Yazılır?

FAQ schema, bir sayfadaki soru-cevap içeriğini Question ve acceptedAnswer property’leriyle işaretler. Kod yapısı şu şekildedir:

{“@context”: “https://schema.org/”,
“@type”: “FAQPage”,
“mainEntity”: [{“@type”: “Question”, “name”: “Soru metni buraya yazılır”,
“acceptedAnswer”: {“@type”: “Answer”, “text”: “Cevap metni buraya yazılır”}}]}

name ve acceptedAnswer alanları zorunludur; sayfada birden fazla soru varsa mainEntity dizisine yeni nesneler eklenerek çoğaltılır.

HowTo Schema İçin JSON-LD Kodu Nasıl Yazılır?

HowTo schema, adım adım bir işlemi step property’si altında sıralı biçimde tanımlar. Örnek kod aşağıdaki gibidir:

{“@context”: “https://schema.org/”,
“@type”: “HowTo”,
“name”: “İşlem adı buraya yazılır”,
“step”: [{“@type”: “HowToStep”, “name”: “Adım 1 başlığı”, “text”: “Adım 1 açıklaması”},
{“@type”: “HowToStep”, “name”: “Adım 2 başlığı”, “text”: “Adım 2 açıklaması”}]}

name ve step alanları zorunludur; her adıma image gibi ek property eklemek isteğe bağlıdır ve görsel destekli adımlar için önerilir. Kodlar hazır olduğunda sıra, bu yapıların sitenize teknik olarak nasıl yerleştirileceğine gelir.

Schema Markup Bir Siteye Nasıl Eklenir?

Schema markup, hazırlanan JSON-LD kodunun sayfanın head veya body bölümüne bir script etiketi içinde yerleştirilmesiyle eklenir; bu işlem hangi tema veya alt yapı kullanıldığından bağımsız olarak aynı mantıkla çalışır. Kodun sayfada görünür bir öğe olması gerekmez, arama motoru tarayıcıları tarafından okunması yeterlidir.

WordPress kullanan e-ticaret siteleri için en pratik yol, schema entegrasyonu sağlayan bir eklenti kullanmaktır. Eklenti kurulduktan sonra ilgili ürün, kategori veya blog şablonu seçilir, JSON-LD kodu ayrılan alana yapıştırılır ve sayfa güncellenerek kaydedilir. Bazı eklentiler alanları otomatik doldursa da manuel eklenen kodun doğruluğu mutlaka kontrol edilmelidir.

Kendi alt yapısına sahip bir e-ticaret platformu kullanılıyorsa entegrasyon iki şekilde yapılabilir: tema dosyasının ilgili şablon dosyasını düzenleyerek script etiketini doğrudan koda eklemek, ya da platformun sunduğu özel kod alanına JSON-LD bloğunu yapıştırmak. Her iki durumda da doğru sayfa şablonunun bulunması, kodun o şablona özel bilgilerle (ürün adı, fiyat, adım metni gibi) güncellenmesi ve değişikliğin kaydedilmesi gerekir.

Kod siteye yerleştirildikten sonra son adım, çalışıp çalışmadığının test edilmesidir.

Yapılandırılmış Veri Test Aracı Nedir ve Nasıl Kullanılır?

Yapılandırılmış veri test aracı, bir sayfaya eklenen schema kodunun sözdizimi ve içerik açısından doğru çalışıp çalışmadığını kontrol eden bir doğrulama aracıdır. Bu araçlar sayesinde kod yayına alınmadan önce eksik ya da hatalı bir alan olup olmadığı görülebilir. Schema markup ne kadar dikkatli yazılırsa yazılsın, tek bir eksik virgül veya yanlış property adı kodun tanınmamasına yol açabilir.

Google Rich Results Test, bu doğrulama için en sık kullanılan araçtır ve doğrudan Google’ın kendi altyapısı üzerinden çalışır. Kullanım basittir: test edilecek sayfanın URL’si girilir ya da JSON-LD kodu doğrudan kopyalanıp yapıştırılır. Araç, sayfayı tarayıp hangi schema türlerini tespit ettiğini listeler ve bu türlerin rich result için uygun olup olmadığını gösterir.

Sonuç ekranında iki farklı uyarı seviyesi karşımıza çıkar: hata (error) ve uyarı (warning). Hata, zorunlu bir alanın eksik olduğu veya kodun hiç okunamadığı durumları işaret eder ve mutlaka düzeltilmesi gerekir. Uyarı ise opsiyonel bir alanın eksik olduğunu belirtir; kod yine de çalışır ama eklenmesi önerilen ek bilgiler vardır.

Schema.org Validator, benzer bir doğrulama yapar ama Google’a özgü değildir; kodun schema.org sözlüğüne teknik olarak uygun olup olmadığını kontrol eder. Rich result görünümü değil, saf sözdizimi doğruluğu önemliyse veya schema.org’un desteklediği daha az yaygın bir tür test ediliyorsa bu araç tercih edilebilir. E-ticaret sayfalarında rich result hedeflendiği için Google Rich Results Test genellikle ilk tercih olur, çünkü JSON-LD kodunun hem doğru yazıldığını hem de Google tarafından rich result için tanındığını aynı anda gösterir.

Kod test aracından hatasız geçtikten sonra bile zaman içinde yeni sorunlar ortaya çıkabilir; bu noktada devreye Google Search Console girer.

Google Search Console’da Yapılandırılmış Veri Hataları Nasıl İzlenir?

Google Search Console, sitede uygulanan schema markup’ın zaman içindeki durumunu geliştirme raporları üzerinden gösterir. Rich Results Test tek seferlik bir kontrol sunarken, Search Console aynı verinin Google tarafından düzenli olarak nasıl tarandığını ve hangi sayfalarda sorun çıktığını takip etmeyi sağlar. Bu yüzden schema markup’ı yayına aldıktan sonra Search Console’a periyodik olarak bakmak, sağlıklı bir teknik SEO alışkanlığı haline gelir.

Search Console’da Hangi Rapor Yapılandırılmış Veriyi Gösterir?

Yapılandırılmış veri durumu Search Console’da sol menüdeki “Geliştirme” (Enhancements) bölümünde yer alır. Bu bölüm, sitede tespit edilen her schema türü için ayrı bir rapor oluşturur; örneğin Ürünler, Sıkça Sorulan Sorular veya Gezinme Yolu (Breadcrumb) her biri kendi raporunda listelenir. Her raporda geçerli sayfa sayısı, hata içeren sayfa sayısı ve varsa uyarı içeren sayfa sayısı ayrı ayrı görüntülenir.

Bir schema türü hiç raporda görünmüyorsa bu genellikle Google’ın o türü henüz taramadığı ya da kodun sayfada doğru şekilde algılanmadığı anlamına gelir. Bu durumda önce ilgili sayfanın Rich Results Test’ten tekrar geçirilmesi mantıklı bir kontrol adımıdır.

Hangi Hatalar Sık Görülür ve Nasıl Düzeltilir?

Yapılandırılmış veri hatalarının büyük kısmı iki kaynaktan gelir: eksik zorunlu alan ve geçersiz değer türü. Eksik zorunlu alana örnek olarak Product schema’da fiyat veya para birimi bilgisinin girilmemesi verilebilir; bu durumda Google ilgili sayfayı hatalı olarak işaretler ve sayfa rich result için değerlendirilmez.

Geçersiz değer türü ise beklenenden farklı bir veri formatının girilmesiyle ortaya çıkar; örneğin fiyat alanına sayı yerine metin yazılması ya da tarih alanının standart formatta olmaması bu kategoriye girer. Hata ile uyarı arasındaki fark önemlidir: hata, ilgili sayfanın rich result kazanamayacağı anlamına gelirken; uyarı, opsiyonel bir alanın eksik olduğunu ama sayfanın yine de rich result için değerlendirilebileceğini gösterir. Bu yüzden önce hatalar, ardından uyarılar sırayla ele alınmalıdır.

Hatalar Düzeltildikten Sonra Doğrulama Nasıl İstenir?

Kod düzeltildikten sonra ilgili hata raporunun içindeki “Doğrulamayı iste” (Validate Fix) düğmesi kullanılır. Bu adım, Google’a söz konusu sayfaları yeniden taraması için bir sinyal gönderir ve otomatik olarak birkaç gün süren bir doğrulama sürecini başlatır.

Doğrulama süreci tamamlandığında rapor durumu güncellenir; sorun gerçekten çözülmüşse hatalı sayfa sayısı düşer, çözülmemişse aynı hata tekrar görünür. Bu döngü, schema markup’ın yalnızca bir kez eklenip unutulacak bir işlem olmadığını, organik görünürlüğü korumak için düzenli takip gerektiren bir süreç olduğunu ortaya koyar.

Sıkça Sorulan Sorular

Her sayfaya schema markup eklemek gerekir mi?

Hayır, her sayfaya schema markup eklemek zorunlu değildir. Öncelik, arama sonuçlarında görünürlüğü doğrudan etkileyebilecek sayfalara verilmelidir: ürün sayfaları, kategori sayfaları, sıkça sorulan sorular içeren içerikler ve adım adım anlatım barındıran rehberler bu grupta yer alır.

Bir e-ticaret sitesinde, statik bir “Hakkımızda” sayfasına yapılandırılmış veri eklemek genellikle düşük öncelikli bir iştir; ürün ve kategori sayfalarında ise Product ve Breadcrumb schema kullanımı daha doğrudan bir fayda sağlar. Site genelinde tutarlı ve doğru bir yapı kurmak, tek tek her sayfayı işaretlemekten daha değerlidir.

Schema markup eklemek ücretsiz mi?

Evet, schema markup’ın kendisi ücretsiz bir yapılandırılmış veri standardıdır; schema.org sözlüğü herkese açıktır ve JSON-LD kodu yazmak için herhangi bir lisans ücreti gerekmez.

WordPress gibi platformlarda kullanılan bazı eklentilerin ücretli sürümleri bulunabilir, ancak bu maliyet schema markup’ın kendisinden değil, eklentinin sunduğu ek otomasyon veya arayüz kolaylıklarından kaynaklanır. Kod manuel olarak yazıldığında sürecin tamamı ücretsiz şekilde tamamlanabilir.

Yanlış schema markup cezaya yol açar mı?

Yanlış veya yanıltıcı schema markup doğrudan bir “ceza” değil, rich results kaybı veya manuel işlem riski doğurabilir. Google, sayfada görünmeyen veya gerçeği yansıtmayan bilgileri schema içinde işaretlemeyi kurallarına aykırı sayar.

Eksik alan ya da hatalı syntax gibi teknik sorunlar genellikle cezaya değil, ilgili zengin sonucun gösterilmemesine yol açar; asıl risk, kullanıcıyı yanıltacak şekilde bilgi eklemekten doğar. Bu nedenle schema markup içeriği her zaman sayfadaki gerçek, güncel ve dengeli bilgiyle örtüşmelidir.