Yapılandırılmış Veri Doğrulaması: Kapsamlı Rehber

Teknik SEO uygulamalarında, şema işaretlemesi olarak da bilinen yapılandırılmış veri kodlarının doğrulanması kritik bir adımdır. Bu süreç, eklediğiniz yapılandırılmış verilerin arama motoru tarayıcıları tarafından düzgün bir şekilde okunup yorumlanabildiğini kontrol etmeyi içerir.

Kodunuz başarıyla okunabiliyorsa "parse edilebilir", aksi durumda ise "parse edilemez" olarak değerlendirilir. Bu doğrulama işleminin önemi büyüktür; çünkü düzgün çalışan yapılandırılmış veriler sayesinde Google zengin sonuçlarından faydalanabilir ve içeriğinizin semantik olarak daha iyi tanınmasını sağlayabilirsiniz.

Tersine, hatalı veya okunamayan yapılandırılmış veriler Google Search Console'da sorunlara yol açar, zengin sonuçların gösterilmesini engeller ve arama sonuçlarındaki görünürlüğünüzü olumsuz etkileyebilir. Bu nedenle, yeni hazırlanan veya mevcut içerikleriniz için yapılandırılmış veri doğrulaması, SEO süreçlerinizin vazgeçilmez bir parçası olmalıdır.

İçindekiler:

• Yapılandırılmış veri doğrulaması süreci

• Doğrulama araçlarında karşılaşılan hata türleri ve çözümleri

  • Parse ile ilgili problemler

  • Uyarı mesajları

  • Kritik hatalar

• Doğrulama için kullanılabilecek araçlar

  • Toplu doğrulama araçları

Yapılandırılmış Veri Doğrulaması Süreci

Şema işaretlemelerinizi doğrulamak için özel araçlar kullanarak kodun makine tarafından okunabilirliğini test etmeli, olası hataları tespit etmeli ve kodun teknik olarak geçerliliğini onaylamalısınız. En ideal yaklaşım, herhangi bir kodu canlı ortama aktarmadan önce bu kontrolleri gerçekleştirmektir. Ancak bu araçlar, yayında olan sayfalardaki problemleri tespit edip düzeltmek için de oldukça faydalıdır.

Yapılandırılmış Veri Doğrulaması araçlarıyla iki farklı şekilde test yapabilirsiniz:

• Kod parçacığını doğrudan test ederek: Eğer yapılandırılmış veriyi bir oluşturucu araç kullanarak hazırladıysanız veya kodun kendisine erişiminiz varsa bu yöntemi tercih edebilirsiniz. Bu yaklaşımın avantajı, kodu temiz ve net bir şekilde inceleyebilmeniz, hataları kolayca bulup düzeltebilmenizdir.

• Canlı URL'yi kontrol ederek: Bu yöntemde sayfanın indeksli olması gerekmez ancak erişilebilir olmalıdır. Tüm sayfayı doğrularken, HTML'in farklı bölümlerinde (head, body, footer) yapılandırılmış veri varsa, birden fazla işaretleme türünü aynı anda görebilirsiniz. Bu yöntemin faydası, test aracının sayfanızı tarayabilmesidir. URL tabanlı tanımlayıcılar kullandıysanız, araç bu sayfalardaki şemayı da çekip sonuçlarda gösterebilir.

Sayfanızın URL'sini veya kod parçasını kullanarak Zengin Sonuçlar Testini çalıştırabilirsiniz.

Deneyimlerime göre, şemanızın geçerliliğinden emin olmak için birden fazla doğrulayıcı kullanmak her zaman daha güvenlidir. Her aracın farklı yapılandırmaları ve öncelikleri vardır; bazıları sadece zengin sonuç üreten kodlara odaklanır. Bu nedenle birden fazla araçla kontrol yapmak, kodunuzun sorunsuz çalışma olasılığını artırır.

Doğrulama Araçlarında Görülen Hata Mesajları

Kodunuzu doğrularken karşılaşabileceğiniz başlıca sorun türleri:

• Parse edilememe hataları

• Uyarı bildirimleri

• Kritik hatalar

Parse Edilememe Sorunu

Parse hataları, doğrulama araçlarının şema kodunuzu okuyamadığı durumlarda ortaya çıkar. URL'nizi veya kodunuzu bir doğrulayıcıya girdiğinizde parse hatası alırsanız, sistemde herhangi bir şema işaretlemesi görüntülenmeyebilir.

Bu durum kodun sayfada bulunmadığı anlamına gelmez; ancak muhtemelen sözdizimi hatası vardır veya kod yanlış bir şekilde sayfaya eklenmiştir.

Kodunuzun parse edilebilir olduğundan emin olmak hayati önem taşır; çünkü okunamayan yapılandırılmış veriler makineler tarafından anlaşılamaz ve zengin sonuçlar için de uygun değildir. Bir sayfada birden fazla yapılandırılmış veri bulunduğunda, arama motorları bazı kodları okuyabilirken diğerlerini okuyamayabilir. Bu durumda, sorunlu bölümü güncelleyip yeniden doğrulamanız gerekir; ancak diğer kodları bozmamaya dikkat etmelisiniz.

SEO Pro Extension'daki doğrulayıcı, kod okunamadığında "Yapılandırılmış Veri bulunamadı" şeklinde bir mesaj gösterir.

Alternatif olarak Schema.org'dan "Kategorize Edilmemiş Hata" bildirimi alabilirsiniz. Böyle durumlarda, doğrulayıcı hatalı kod satırını X işaretiyle belirtir.

Şemanızın okunamamasına neden olabilecek yaygın sözdizimi hataları:

• Virgül, köşeli parantez [], süslü parantez {} veya normal parantez () eksikliği ya da dengesizliği

• Düz tırnak işaretleri ("") yerine kıvrık tırnak işaretlerinin ("") kullanılması

• Şema içeriğinde düz tırnak kullanarak metni bölmek

JSON-LD Şema İşaretlemesindeki Parse Hatalarını Düzeltme

Hata kodun içindeyse, yanlış yazılmış kısmı bulup doğru sözdizimi ile güncellemeniz gerekir.

Uyarı Bildirimleri

Rich Results Testing tool veya Google Search Console'da "Kritik olmayan sorunlar tespit edildi" şeklinde sarı renkli bir uyarı görmeniz, şemanızın okunamaz olduğu anlamına gelmez.

Bu uyarılar genellikle, zorunlu bir özellik yerine önerilen bir şema özelliğini veya türünü atladığınızda ortaya çıkar. Ancak bu "eklenirse iyi olur" öneriler genel tavsiyelerdir ve içeriğinize tam olarak uymayabilir. Google'ın resmi açıklamasına göre doğruluk en önemli unsurdur:

"Genel olarak, daha fazla önerilen özellik eklemek bilgilerinizin gelişmiş görünümle arama sonuçlarında yer alma şansını artırabilir. Ancak, her olası önerilen özelliği eksik, hatalı veya yanlış verilerle doldurmaya çalışmak yerine, daha az ama eksiksiz ve doğru önerilen özellikler sağlamak daha önemlidir." — Google

Bu nedenle, bu uyarıları mutlaka gözden geçirmelisiniz; ancak bunların mevcut içeriğinizle alakalı olup olmadığını değerlendirmelisiniz. Öneriler içeriğinize uygun değilse, bunları görmezden gelebilir ve yine de zengin sonuçlar için uygunluğunuzu koruyabilirsiniz.

Yapılandırılmış Veri Uyarılarına Yaklaşım Stratejileri

Yapılandırılmış veri uyarılarıyla başa çıkmanın farklı yolları:

• Sayfanızda uyarıyı karşılayacak içerik varsa şemanızı güncelleyin veya kodu daha doğru hale getirin

• İlgili içeriği gelecekte ekleyebilecekseniz, sayfanızı geliştirme planı yapın

• Uygun içeriğiniz yoksa ve oluşturmayı düşünmüyorsanız uyarıyı görmezden gelin

• Ürün sayfalarınız için uyarı alıyorsanız, Google Merchant listeleme gerekliliklerini inceleyin; bazı ürün kategorilerinin özel gereksinimleri vardır

Ne demek istediğimi örneklerle açıklayayım:

Video İçeriği İçin "contentURL" veya "embedURL" Eksikliği Uyarısı

Bu durumda, uyarı "VideoObject" şemasında "contentURL" veya "embedURL" bildirilmediğini belirtir. Videonuzun sitede barındırılan bir URL'si veya gömme bağlantısı varsa, şemayı güncelleyip sayfayı yeniden kontrol ederek bu uyarıyı giderebilirsiniz.

Şema Türüyle İlgisiz Özellik Eklenmesi

Şema türüne uygun olmayan bir özellik eklerseniz benzer bir uyarı alırsınız.

Örneğin restoran şemasına "author" özelliği eklenmiş olabilir. Bu durumda en basit çözüm, mantıklı olmadığı için author özelliğini silmektir.

Ancak bazen alakalı bilgiler için bu uyarıyı görebilirsiniz. Böyle durumlarda Schema.org türü sayfasını ziyaret edip daha uygun bir özellik bulabilir ve kodunuzu güncelleyebilirsiniz. Örneğin, bir kişinin restoranın yazarı değil kurucusu olduğunu belirtmek için kodu değiştirebilirsiniz.

İnceleme Bulunmayan Ürün Sayfalarında "review" Uyarısı

Ürün şemaları sıklıkla "review" ve "aggregateRatings" bilgilerinin eklenmesini önerir. Bu öneri, incelemelerin kullanıcılar ve arama motorları için büyük değer sunma potansiyelinden kaynaklanır.

Ancak belirli bir ürün için incelemeniz veya puanınız yoksa, bunları şemanıza ekleme zorunluluğu yoktur. Bu alanlar olmadan da zengin sonuçlar için uygun kalırsınız; fakat gelecekteki güncellemeler için bu öneriyi takip etmelisiniz.

SEO danışmanı Jeannie Hill'e göre, "Uyarılar çoğunlukla gelecek gereksinimlerin işaretidir. Bu şema uyarıları, işletmelere rekabette öne geçme fırsatı sunar."

Yazar Sayfası Olmayan Blog Yazılarında "url" Eksikliği

Bir blog makalesinin BlogPosting işaretlemesinde Eksik alan "url" (isteğe bağlı) uyarısı görebilirsiniz. Bu uyarıyı değerlendirirken önce web sitesinin gerçekten bir yazar sayfası olup olmadığını kontrol edin. Yazar sayfası varsa, URL eklemek sayfanın ve sitenin genel EEAT değerini artırabilir.

Ancak blog sitesinin yazar sayfası yoksa, başlangıçta bu uyarıyı görmezden gelebilir ve ileride yazar sayfaları oluşturmayı SEO stratejinize dahil edebilirsiniz. Yazar sayfası URL'leri yayına alındığında BlogPosting şemasını güncelleyebilirsiniz.

Kritik Hatalar

Genel hatalar yapılandırılmış veri doğrulaması sırasında tespit edilir ve acilen müdahale gerektirir.

Google harici doğrulayıcılarda, içeriğinizin makineler tarafından düzgün okunamayacağını gösteren hatalar görebilirsiniz. Google'ın doğrulayıcılarında (GSC ve RRTT) hatalar, Google'ın zengin sonuç kriterleriyle doğrudan bağlantılı olabilir.

Validator.schema.org gibi bir araçta hatasız görünmeniz, Google Search Console'da uyarılar almanıza engel olmaz. Bu nedenle kodunuzun birden fazla doğrulayıcıda geçerli olduğundan emin olmanız son derece önemlidir.

İşte yapılandırılmış veri doğrulamasında hata oluşturabilecek durumlar:

Tanımsız Şema Türü veya Özelliği Kullanımı

Schema.org sözlüğünde 1.000'in üzerinde şema türü ve özelliği bulunur. Şema yazarken sadece bu dokümantasyonda tanımlı türleri ve özellikleri kullanabilirsiniz. Bir özellik veya tür adını yanlış yazarsanız hata alırsınız.

Google Zengin Sonuçları İçin Zorunlu Özellik Eksikliği

Google'ın dokümantasyonu, zengin sonuçlara uygun olabilmek için yapılandırılmış verinin belirli unsurlarının zorunlu olduğunu belirtir.

Örnek vermek gerekirse, bir web sayfası ürün için fiyat bilgisini yapılandırılmış veride göstermiyor olabilir. İşaretleme teknik olarak geçerli olsa bile (validator.schema.org'da geçerli görünse bile) Google'ın gereksinimlerini karşılamıyorsa Google Search Console'da hata oluşturur. Bu hataları düzeltmek SEO'nuzu hızla iyileştirebilir, bu yüzden burada zaman harcamaya değer.

Yapılandırılmış Veri Doğrulaması Araçları

Teknik SEO denetimi yapıyor veya tek bir sayfayı inceliyor olun, yapılandırılmış verilerinizin makine tarafından okunabilir olduğunu test etmek için araçlara ihtiyacınız var. Aşağıdaki araçlar, yapılandırılmış verileri tek bir sayfada veya tüm sitenizde doğrulamanıza, sorun gidermenize ve optimize etmenize yardımcı olur.

Validator.schema.org

Şema sözlüğünü yöneten Schema.org tarafından geliştirilen bu araç, 2020'de Google'ın yapılandırılmış veri test aracının yerini almıştır. Sözdizimi problemlerini ve parse sorunlarını çözmenize yardımcı olur.

Validator.schema.org, şema işaretlemenizi hem URL hem de kod parçacığı üzerinden test etmenize imkan tanır.

ChatGPT

ChatGPT, yapılandırılmış verilerinizdeki hataları gidermek için güvenilir bir yardımcıdır. Bir hata fark ettiğinizde ve sözdiziminin hangi bölümünün probleme neden olduğunu belirleyemediğinizde, sorunu bulmak için ChatGPT'den faydalanabilirsiniz.

Kod oluşturma ve doğrulama için ChatGPT kullanmamayı tercih ediyorum; çünkü istemlerinizde dikkatli olmazsanız geçersiz kod üretebilir ve alanlarınıza gereksiz bilgiler ekleyebilir. Şema incelemesi için yapay zeka aracı kullanıyorsanız mutlaka ikinci bir kontrolden geçirin.

Test.schema.dev

Test.schema.dev, ücretsiz bir şema doğrulama platformudur ve şemanızı düzenli bir formata sokma özelliğine sahiptir. Bu sayede koddaki sorunlu satırları görmek kolaylaşır.

Ayrıca bu doğrulayıcı, neyin kabul edilip edilmediği konusunda oldukça titizdir. Test sırasında bazen validator.schema.org'da geçerli görünen ancak burada geçersiz olan işaretlemelerle karşılaştım. Bu araç, kodunuzun sağlam ve farklı cihazlarda okunabilir olmasını garanti etmek için değerlidir.

Rich Results Testing Tool

Rich Results Testing tool (RRTT), Google tarafından sağlanan ve sayfanızdaki şemanın geçerli olup olmadığını, zengin sonuçlar için uygun olup olmadığını gösteren bir doğrulayıcıdır.

Bu araçla test ettiğinizde, tüm şema öğelerinin çıktıda yansıtılmadığını fark edebilirsiniz. Bunun sebebi, aracın özellikle Google'da zengin sonuç üreten şemalara odaklanmasıdır.

Zengin sonuç tetiklemeyen şema içeren sayfanız varsa, bu şemayı RRTT'de göremeyebilirsiniz. Sayfa zengin sonuca uygun ve genel şema işaretlemesinin karışımını içeriyorsa, RRTT sadece zengin sonuçlara uygun şemayı doğrulayabilir.

Örnek vermek gerekirse, bir URL AboutPage yapılandırılmış verisi içerse de RRTT'nin tanıdığı tek şey zengin sonuçlara uygun FAQ olabilir.

SEO Pro Extension

SEO Pro Extension'ın Şema bölümü, sayfanız yüklendiğinde mevcut olan geçerli şemanın anlık bir görüntüsünü sunar. Tarayıcı uzantısı olduğu için sayfadan ayrılmanıza gerek kalmaz ve içeriğinizi hızlıca değerlendirmek için son derece kullanışlıdır.

Kodu düzenleyemezsiniz ancak şema türlerinizin sayfada yüklenme sırasını görebilirsiniz. Sayfanıza şema eklediyseniz ve Şema panelinde görünmüyorsa kodunuzda hata var demektir.

Wix Advanced SEO Paneli

Wix site sahipleri, kodunuz hatasız olmadan şema işaretlemesi göndermenize izin vermeyen yerleşik bir doğrulayıcıya sahiptir. Wix sayfalarındaki Advanced SEO paneli üzerinden erişebileceğiniz bu araç, hataları oluşmadan önlemenize yardımcı olur.

Wix'te SEO ürün lideri Einat Hoobian-Seybold bu konuda şunları söylüyor: "Yapılandırılmış veri kodu yazmanın karmaşık olabileceğinin farkındayız. Kullanıcıların sitelerine hatalı kod eklemediğinden emin olmak için doğrulamalar ekledik. Wix kullanıcısının sözdiziminde hata varsa yayına almadan önce bilgilendirilir."

Wix Velo

Wix'in JavaScript çerçevesi olan Velo'da, Wix SEO API'sini kullanarak şema işaretlemesi oluşturabilirsiniz.

Bu platformda, sayfadaki görsel öğelere dayalı değişkenler yaratabilir ve sayfalarınıza dinamik işaretleme ekleyebilirsiniz. Bu çerçevede, kodunuz yanlış parse edilirse hata mesajı alırsınız ve kodunuzu nasıl iyileştirebileceğinize dair öneriler sunulur.

Tek Sayfa Doğrulayıcı	URL Kontrolü	Kod Parçası Kontrolü	Tüm Şema	Zengin Sonuç Kontrolü	Kod Düzenleyici
Validator.schema.org	✓	✓	✓	✗	Evet
ChatGPT	-	✓	-	-	Hayır
Test.schema.dev	✓	✓ (freemium)	✓	✗	Evet
Rich Results Testing tool	✓	✓	✗	✓	Evet
SEO Pro Extension	✓	✗	✓	✗	Hayır
Wix SEO Araçları	-	✓	-	-	Evet
Wix Velo	-	✓	-	-	Evet
GSC URL Inspection	✓	✓	✗	Kısmi	Hayır

Toplu Doğrulama Araçları

Tek sayfa değerlendirmeleri önemli olsa da, web sitelerinin veya site klasörlerinin toplu doğrulaması şema işaretlemenizdeki sistemik problemleri tespit etmenize yardımcı olur.

Aynı şema şablonunu kullanan içerikleriniz olduğunda (örneğin yemek tarifleri koleksiyonu) aynı hatanın birçok sayfada tekrarlanması olasıdır.

Google Search Console

Google Search Console Enhancements raporları, hangi sayfaların geçerli şema işaretlemesine sahip olduğunu ve hangi sayfaların geçersiz olduğunu ortaya koyar. Bu raporlarda zengin sonuçlar için uygun yapılandırılmış verilere ilişkin uyarılar veya hatalar da yer alır.

SEO ve arama görünürlüğü açısından bu rapor son derece kritiktir ve buradaki hatalar en kısa sürede giderilmelidir.

NP Digital'de SEO teknik stratejisti olan Brenda Malone, düzenli GSC denetimleri yaptığını ve yapılandırılmış verinin sürecin temel bir parçası olduğunu vurgular: "Hatalı şemayı düzeltmek müşterinin web sitesini zengin snippet'ler için yeniden uygun hale getirdi. Bu görevler iyi uygulanmış şemanın avantajlarını sürdürmek için hayati önem taşır."

Google'ın zengin sonuç raporlarının zengin sonuçlara uygun tüm yapılandırılmış verileri kapsamadığını unutmamak gerekir. Örneğin BlogPosting ve LocalBusiness yapılandırılmış veri işaretlemeleri zengin sonuçlara uygundur ve zengin sonuçlar galerisinde yer alır; ancak Google Search Console'da bu veri türleri için özel rapor bulunmaz.

Screaming Frog

Screaming Frog ile web taramanızı, sayfalarınızın her birinde hangi şema işaretlemesinin geçerli olduğunu gösterecek şekilde yapılandırabilirsiniz.

Bu platform yapılandırılmış veri işaretlemenizdeki eksiklikleri belirlemenize ve içeriğinizi büyük ölçekte denetlemenize olanak sağlar. Örneğin çıktılarda bazı sayfalar için uyarılar görebilirsiniz.

Screaming Frog'u kullanarak rapor oluşturabilir ve sorunları nasıl çözeceğinize dair öneriler alabilirsiniz.

Semrush Markup Raporu

Semrush Markup raporu, hangi sayfalarda ne tür yapılandırılmış verilerin bulunduğuna dair bilgi sunar:

• Google zengin sonuçları için geçerli yapılandırılmış veriler

• Geçerli Schema.org yapılandırılmış verileri

Wix GSC Site Inspection

Google Search Console API'sinden veri çekerek Wix Site Inspection aracıyla Wix web sitenizin toplu kontrolünü gerçekleştirebilirsiniz. Tam raporda sonuçlarınızı geçerli zengin sonuçlar, sorunlar, isteğe bağlı düzeltmeler, belirsiz sorunlar veya veri bulunmaması durumlarına göre filtreleyebilirsiniz.

Geçerli zengin sonuçları olan sayfaları göstermek için filtreler mevcuttur.

Toplu rapordan herhangi bir sayfaya tıklayarak hangi zengin sonuç türünün geçerli olduğunu görebilir veya diğer sorunları inceleyebilirsiniz.

Yapılandırılmış Veri Denetimi: Sadece Doğrulama Değil

Yapılandırılmış veriler, işletmenizin yapısına ve çevrimiçi varlığına bağlı olarak artan arama görünürlüğü de dahil olmak üzere çeşitli faydalar sunabilir. Ancak bu avantajlardan yararlanmak için öncelikle zengin sonuçlarınızın geçerli olması şarttır.

İster birkaç sayfa ister binlerce sayfa ile çalışıyor olun, hataları parse edilebilir ve içeriğinizi güçlendiren yapılandırılmış verilere dönüştürmenize yardımcı olacak araçlar mevcuttur.

Öncelikle yüksek değerli sayfalarınızdaki şemaları doğrulayarak başlayın, ardından müşteri yolculuğunuzun her aşaması markanızla ilgili deneyimi geliştiren uygun şemalarla zenginleştirilene kadar bu süreci devam ettirin.