Yapısal veri nasıl test edilir? Zengin Sonuçlar Testi ve Schema Markup Validator

Yapısal veriyi test etmek için dört araç kullanılır. Yayından önce tek bir sayfayı ya da kod parçasını Google’ın Zengin Sonuçlar Testi ile kontrol edersiniz. Google’ın desteklemediği türleri ve genel schema.org kurallarını Schema Markup Validator ile denetlersiniz. Yayındaki bir sayfanın Google’ın gördüğü halini URL Denetleme aracında görürsünüz. Bütün sitedeki hataları ise Search Console’daki zengin sonuç raporlarından takip edersiniz.

Yapısal veri eklemek işin yarısıdır. Diğer yarısı, eklediğiniz işaretlemenin doğru okunduğundan emin olmaktır. Bir tema güncellemesi, bir eklenti ya da fiyat alanındaki küçük bir format değişikliği, binlerce ürün sayfasındaki işaretlemeyi bir gecede bozabilir. Bu yazıda her aracın ne zaman kullanılacağını, sonuç ekranının nasıl okunacağını ve en sık karşılaşılan hataları anlatıyorum.

Hangi aracı ne zaman kullanmalı?

Araç	Ne zaman?	Ne gösterir?
Zengin Sonuçlar Testi	Yayından önce ya da tek bir sayfayı kontrol ederken	Sayfanın hangi Google zengin sonuç türlerine uygun olduğu, hatalar ve uyarılar
Schema Markup Validator	Google’ın desteklemediği türleri ya da genel söz dizimini kontrol ederken	schema.org kurallarına uygunluk, sayfadaki bütün işaretleme
URL Denetleme aracı	Yayındaki bir sayfanın Google’daki durumuna bakarken	Google’ın dizindeki sürümde ve canlı testte gördüğü yapısal veri
Search Console zengin sonuç raporları	Yayından sonra, sürekli takipte	Bütün sitedeki geçerli ve hatalı öğeler, zaman içindeki değişim

Zengin Sonuçlar Testi

Google’ın Zengin Sonuçlar Testi (Rich Results Test), bir sayfanın hangi zengin sonuç türlerine uygun olduğunu gösterir. Araca bir adres girebilir ya da “URL yerine kod” seçeneğiyle doğrudan HTML ya da JSON-LD kodu yapıştırabilirsiniz. Kod seçeneği, işaretlemeyi yayına almadan önce denemek için çok kullanışlıdır.

Google’ın yardım sayfasına göre araç JSON-LD, RDFa ve Microdata biçimlerini destekler. Varsayılan olarak sayfayı akıllı telefon tarayıcısıyla test eder, isterseniz masaüstüne çevirebilirsiniz. Google mobil öncelikli dizine ekleme kullandığı için varsayılan ayarda kalmak çoğu zaman doğru seçimdir. Mobil ve masaüstü sürümlerde farklı işaretleme varsa bunu ancak iki testi karşılaştırarak fark edersiniz.

Sonuç ekranını okumak

Test bittiğinde araç bulduğu her zengin sonuç türünü ayrı bir satırda gösterir: “Ürün snippet’leri”, “Satıcı listelemeleri”, “İçerik haritası” gibi. Her satırın yanında geçerli öğe sayısı ve varsa uyarılar yazar.

Bir satıra tıkladığınızda o türün alanlarını görürsünüz. Kırmızı işaretli satırlar hatadır: Zorunlu bir alan eksik ya da hatalı biçimde girilmiş. Hata içeren öğe o zengin sonuç türü için uygun olmaz. Sarı işaretli satırlar uyarıdır: Önerilen bir alan eksiktir. Öğe uygun kalır, ama eksik bilgi yüzünden daha sade gösterilebilir.

Uyarıların hepsini kapatmak zorunda değilsiniz. Bir ürünün markası yoksa brand alanı için uydurma bir değer girmeyin. Ama aggregateRating gibi gerçekten elinizde olan bir veri eksikse eklemeye değer.

Sayfanın oluşturulmuş halini görmek

Aracın “Test edilen sayfayı görüntüle” bölümü, Google’ın sayfayı JavaScript çalıştırdıktan sonra nasıl gördüğünü gösterir. Yapısal veriniz sayfaya JavaScript ile ekleniyorsa bu bölüm çok işe yarar. Kaynak kodda olmayan ama oluşturulmuş HTML’de görünen işaretleme Google tarafından okunabilir. JavaScript SEO yazısında bu konuyu ayrıntılı anlattım.

Aracın göstermedikleri

Zengin Sonuçlar Testi yalnızca Google’ın zengin sonuç olarak desteklediği türleri değerlendirir. Sayfanızda Organization, WebSite ya da Google’ın zengin sonuç listesinde olmayan başka bir tür varsa, araç bu işaretlemedeki hataları ayrıntılı göstermeyebilir. Bu türler için ikinci araca geçin.

Schema Markup Validator

Google eski Yapısal Veri Test Aracı’nı kaldırdığında, genel amaçlı doğrulama işi schema.org’un kendi sitesine taşındı. Schema Markup Validator (validator.schema.org) bugün bu boşluğu doldurur. Araç sayfadaki bütün schema.org işaretlemesini listeler ve schema.org sözlüğüne uymayan alanları gösterir. Google’ın zengin sonuç desteğine bakmaz.

Şu durumlarda bu aracı kullanın:

• Organization yapısal verisi gibi Google’ın zengin sonuç listesinde olmayan türleri kontrol ederken.
• Bir alan adının yanlış yazılıp yazılmadığını görmek istediğinizde. Örneğin priceCurrency alanı pricecurrency olarak küçük harfle yazılmışsa.
• Sayfada birden fazla işaretleme bloğu varsa ve bunların birbirine nasıl bağlandığını görmek istediğinizde.

Bir uyarı: Schema Markup Validator’ın “hata yok” demesi, Google’da zengin sonuç alacağınız anlamına gelmez. Google, schema.org’un tanımladığı her alanı kullanmaz ve bazı alanlar için kendi kurallarını koyar. Google’ın belgesi de Google Arama’daki davranış için asıl kaynağın Search Central belgeleri olduğunu söylüyor.

URL Denetleme aracı

Search Console’daki URL Denetleme aracı, yayındaki bir sayfanın Google’daki durumunu gösterir. Aracın iki görünümü vardır. İlki, Google’ın dizindeki sürümde gördüğü yapısal veridir: Sayfa en son tarandığında hangi işaretleme okunduysa onu gösterir. İkincisi “Canlı URL’yi test et” seçeneğidir: Sayfayı o anda yeniden çeker ve güncel işaretlemeyi gösterir.

Bu iki görünümü karşılaştırmak, düzelttiğiniz bir hatanın Google’a henüz ulaşıp ulaşmadığını anlamanın en hızlı yoludur. Canlı testte hata yoksa ama dizindeki sürümde varsa, Google sayfayı henüz yeniden taramamıştır. Bu durumda dizine ekleme isteği gönderebilirsiniz.

Search Console zengin sonuç raporları

Tek tek sayfa test etmek, binlerce ürünü olan bir sitede yeterli değildir. Search Console’un sol menüsündeki “Alışveriş” ve “Geliştirmeler” bölümlerinde, sitede bulunan her zengin sonuç türü için ayrı bir rapor görünür: Ürün snippet’leri, satıcı listelemeleri, içerik haritaları, videolar gibi.

Bu raporlar geçerli ve geçersiz öğe sayısını zaman içinde gösterir. Bir tarihte geçersiz öğe sayısında ani bir artış görüyorsanız, o tarihte sitede bir şey değişmiştir: tema güncellemesi, yeni bir eklenti, altyapıda bir sürüm değişikliği. Raporda hatanın türüne tıkladığınızda örnek adresleri görürsünüz. Hatayı düzelttikten sonra “Düzeltmeyi doğrula” düğmesiyle Google’dan bu adresleri yeniden kontrol etmesini isteyebilirsiniz.

Raporların gecikmeli güncellendiğini unutmayın. Düzeltme sonrası sayıların düşmesi günler, büyük sitelerde haftalar sürebilir.

En sık karşılaşılan hatalar

Ayrıştırılamayan yapısal veri

Bu hata, JSON-LD kodunun söz diziminde bir sorun olduğunu gösterir: eksik bir virgül, kapanmamış bir süslü parantez, metnin içinde kaçış karakteri kullanılmamış bir tırnak işareti. Ürün açıklamasında geçen " işareti, açıklamayı JSON-LD’ye otomatik basan şablonlarda bu hatanın en sık sebebidir. Hata satırına tıkladığınızda araç sorunlu satırı işaretler.

Eksik zorunlu alan

Ürün için name, teklif için price ya da priceCurrency gibi zorunlu bir alan eksiktir. E-ticarette bu hata genellikle fiyatı olmayan ürünlerde ya da “fiyat sorunuz” yazan sayfalarda görülür. Ürün işaretlemesinde hangi alanların zorunlu olduğunu ürün yapısal verisi yazısında anlattım.

Geçersiz değer biçimi

Fiyat alanına 1.299,90 TL yazılması, tarih alanına 09.11.2026 yazılması bu hataya yol açar. Fiyat yalnızca sayı ve nokta ile (1299.90), para birimi ayrı alanda (TRY), tarih ise ISO 8601 biçiminde (2026-11-09) yazılmalıdır.

Sayfada görünmeyen işaretleme

Bu hata test araçlarında görünmez ama en ciddi olanıdır. Yapısal verideki fiyat, puan ya da stok bilgisi sayfada kullanıcıya gösterilen bilgiyle aynı olmalıdır. Sayfada hiç yorum yokken yapısal veride yıldız puanı bulunması Google’ın kurallarına aykırıdır. Google’a göre bu tür işaretleme elle işlem alabilir. Bu işlem sayfanın zengin sonuç uygunluğunu kaldırır ama web aramasındaki sıralamasını etkilemez. Durumu Search Console’daki Elle uygulanan işlemler raporundan kontrol edebilirsiniz.

Test sonucu geçerli ama zengin sonuç yok

Google’ın yapısal veri kurallarına göre, işaretleme Zengin Sonuçlar Testi’ne göre doğru olsa bile Google zengin sonuç göstermeyi garanti etmez. Test teknik uygunluğu kontrol eder, gösterim kararı ise sayfanın kalitesine, sorguya ve kullanıcının cihazına göre verilir.

Bu durumda sırayla şunlara bakın: Sayfa dizinde mi? İşaretleme sayfadaki içerikle uyumlu mu? İşaretlediğiniz tür Google’ın hâlâ desteklediği bir tür mü? Google zaman içinde bazı türleri kaldırıyor ya da kısıtlıyor. Örneğin 2023’te SSS zengin sonuçlarını resmi devlet ve sağlık sitelerine sınırladı, NasılYapılır (HowTo) zengin sonuçlarını ise kaldırdı. Bu türleri işaretlemek hata vermez, ama zengin sonuç da getirmez.

Bir kontrol düzeni

Yapısal veri ilk kurulduğunda iyi test edilir, sonra unutulur. Şu üç adımı alışkanlık haline getirin. Her şablon değişikliğinden sonra her sayfa türünden (ana sayfa, kategori, ürün, blog) birer örneği Zengin Sonuçlar Testi’nden geçirin. Ayda bir Search Console’daki zengin sonuç raporlarında geçersiz öğe sayısına bakın. Altyapı ya da tema güncellemesinden sonraki ilk hafta bu raporları daha sık açın.

Yapısal verinin teknik tarafıyla birlikte sitenin genel teknik durumunu gözden geçirmek isterseniz teknik SEO danışmanlığı sayfasına göz atabilirsiniz.