Yapılandırılmış veri doğrulayıcısı, web sitenizin işaretlemesinin zengin snippet’ler için gerekli kurallara uyup uymadığını kontrol eden Yandex Webmaster içindeki teknik bir araçtır. Arama motorlarının verilerinizi doğru bir şekilde okuyabilmesini sağlamak için Microdata, Schema.org ve Open Graph gibi formatlardaki belirli sözdizimi (syntax) hatalarını belirler. Web yöneticileri bu aracıyı kullanarak kodlarını canlı ortama almadan önce hatalardan arındırılmış olduğunu doğrulayabilir; bu da adalar (islands) olarak bilinen geliştirilmiş arama görünümlerini güvence altına almaya yardımcı olur.
Yandex için hangi işaretleme formatlarını doğrulayabilirsiniz?
Yandex birkaç tür yapılandırılmış veriyi tanır. Microdata, HTML gövdesi içinde kullanılan en yaygın fomattır. Veri türlerini tanımlamak için itemprop ve itemscope gibi basit öznitelikler kullanır. Schema.org ise ürünleri, incelemeleri veya etkinlikleri açıklamak için bu formatlarla birlikte çalışan kelime dağarcığıdır. Bu kelime dağarcığını kullanırsanız, doğrulayıcı bir ürün sayfası için fiyat veya para birimi gibi zorunlu alanları ekleyip eklemediğinizi kontrol edecektir.
Diğer bir format ise Open Graph’tir. Bu temel olarak sayfalarınızın sosyal medyada veya belirli Yandex servislerinde paylaşıldığında nasıl görüneceğini kontrol etmek için kullanılır. Doğrulayıcı, og:title, og:type ve og:image gibi temel etiketleri kontrol eder. Bunlar standart arama sonuçlarında her zaman zengin snippet’ler oluşturmasa da, sitenizin web genelindeki genel görünürlüğü için hayati önem taşır. Yandex geçmişte özel arama özelliklerinin birçoğu için Microdata’yı tercih etmiş olsa da, JSON-LD de belirli veri türleri için desteklenmektedir.
- Microdata: Varlıkları tanımlamak için kullanılan satır içi (inline) HTML öznitelikleri.
- Schema.org: Yapılandırılmış veriler için standart kelime dağarcığı.
- Open Graph: Sosyal medya ve bağlantı önizlemeleri için kullanılan meta veriler.
- JSON-LD: Veri gösterimi için komut dosyası (script) tabanlı bir format.
Kodunuz olmasına rağmen zengin snippet’ler neden görünmüyor?
Kodunuz doğru görünse bile, eksik tek bir karakter Yandex’in onu ayrıştırmasını engelleyebilir. Bu yüzden doğrulayıcı çok önemlidir. Hataların sık görülen bir nedeni standart olmayan etiketlerin kullanılmasıdır. Resmi Schema.org belgelerinin bir parçası olmayan bir özellik kullanırsanız, Yandex bunu dikkate almayacaktır. Doğrulayıcı bunları tanınmayan özellikler olarak işaretleyecektir.
Başka bir sorun ise zorunlu alanları içerir. Örneğin, bir tarifi işaretliyorsanız, Yandex bir fotoğraf ve malzeme listesi isteyebilir. Pişirme süresini sağlayıp resmi unutursanız, zengin snippet hiç görünmeyebilir. Araç, hangi alanların eksik olduğunu ve hangilerinin isteğe bağlı olduğunu gösteren net bir rapor sunar. Arama motoruna içeriğiniz hakkında daha fazla bağlam vermek için mümkün olduğunca çok alanı doldurmak iyi bir uygulamadır.
Geliştiricilerin, şema kodu oluşturan otomatik eklentilere çok fazla güvenliğini sıklıkla görüyoruz. Bu eklentiler genellikle Yandex’in yerel arama özellikleri için gereksinim duyduğu belirli alanlardan yoksun genel veriler üretir. Manuel doğrulama, %100 doğruluk sağlamanın tek yoludur.
Alien Road SEO ekibi
Yandex Webmaster doğrulayıcı aracı nasıl kullanılır?
Araca erişim basittir. Doğrulayıcının halka açık sürümünü kullanmak için sitenizin Webmaster’da doğrulanmış olmasına gerek yoktur, ancak oturum açmış olmak daha fazla özellik sunar. Kodunuzu iki şekilde kontrol edebilirsiniz: canlı bir URL girerek veya doğrudan metin kutusuna bir HTML kod parçacığı yapıştırarak. İkincisi, bir sayfa canlıya alınmadan önce geliştirme aşamasında yararlıdır.
Verileri gönderdikten sonra araç, Yandex botunu taklit eden bir ayrıştırıcı (parser) çalıştırır. Kodu bir ağaç yapısına böler. Ağaçtaki her düğüm, Ürün (Product) veya Kuruluş (Organization) gibi bir varlığı temsil eder. Kapatılmamış bir etiket veya eksik tırnak işareti gibi bir sözdizimi hatası varsa, doğrulayıcı koddaki tam satırı vurgulayacaktır. Bu, saatlerce süren manuel hata ayıklamadan (debugging) tasarruf sağlar.
- Adım 1: Yandex Webmaster araçlarında Yapılandırılmış Veri Doğrulayıcısı’nı açın.
- Adım 2: ‘URL’ veya ‘Kod parçacığı’ (Code snippet) giriş yönteminden birini seçin.
- Adım 3: Kodunuzu veya yayınlanan sayfanızın bağlantısını yapıştırın.
- Adım 4: Analizi başlatmak için ‘Kontrol Et’ (Check) düğmesine basın.
- Adım 5: Kırmızı hata işaretleri için ‘Durum’ (Status) sütununu inceleyin.
Microdata ve JSON-LD uygulamalarındaki yaygın hatalar
Sözdizimi hataları, yapılandırılmış verilerin baş düşmanıdır. Microdata’daki en yaygın hata, yanlış iç içe yerleştirmedir (nesting). Örneğin, bir ‘Ürün’ (Product) kapsamı başlatır ancak ‘Teklif’ (Offer) kapsamını dahil etmeden önce div etiketini kapatırsanız, ayrıştırıcı fiyatın o ürüne ait olmadığını düşünecektir. Bu, öğeler arasındaki mantıksal bağlantıyı koparır.
JSON-LD’de sorunlar genellikle biçimlendirmeyle ilgilidir. JSON, virgüller ve parantezler konusunda çok katıdır. Bir listenin sonundaki fazladan bir virgül, tüm komut dosyasının başarısız olmasına neden olur. Ayrıca, bir metin dizesi içindeki ampersand veya tırnak işaretleri gibi özel karakterler kaçış karakteriyle (escaped) kullanılmalıdır. Belirli bağlamlarda ‘Black & Gold’ yerine ‘Black & Gold’ yazarsanız, ayrıştırıcı dosyayı okumayı tamamen durdurabilir. Doğrulayıcı, bu küçük ama ölümcül hataları anında yakalar.
Alien Road yapılandırılmış veri doğrulamasını nasıl uygular?
Alien Road olarak yapılandırılmış verileri her proj için temel bir teknik gereksinim olarak ele alıyoruz. Sürecimiz ilk site denetimi sırasında başlar. Yalnızca şemanın var olup olmadığını kontrol etmiyoruz; müşterinin belirli sektörü için yararlı olup olmadığını kontrol ediyoruz. Elektronik satan bir Shopify mağazası gibi tipik bir projede, fiyatın ve stok durumunun işaretlemeye nasıl çekildiğine bakarız.
Ekibimiz hazırlık (staging) aşamasında Yandex doğrulayıcısını kullanır. Mağazanın arka ucu (backend) tarafından oluşturulan kodu alır ve Yandex’in fiyat para birimini nasıl yorumladığını görmek için araçtan geçiririz. Para birimi simgesinin bir ayrıştırma hatasına neden olduğunu görürsek, temiz bir ISO kodu üretmek için liquid şablonlarını ayarlarız. Bu, site canlıya geçtiğinde arama sonuçlarının hemen doğru fiyatı ve ‘Stokta Var’ etiketlerini göstermesini sağlar, bu da daha yüksek tıklama oranlarına yol açabilir.
Verileri doğrulamak yalnızca hataları düzeltmekle ilgili değildir; veri kalitesiyle ilgilidir. Her özniteliğin doğru şekilde eşlendiğinden emin olduğumuzda, aslında arama sistemiyle kendi dilinde konuşmuş oluruz ve müşterinin teklifinin yanlış yorumlanmasına yer bırakmayız.
Alien Road SEO ekibi
Yapılandırılmış verilerdeki ayrıştırma hatalarını giderme
Doğrulayıcı bir hata döndürürse, sakin olun ve hata koduna bakın. Yandex genellikle neyin yanlış gittiğine dair kısa bir açıklama sunar. ‘Zorunlu alan eksik’ adı veya fiyatı gibi önemli bir şeyi unuttuğunuz anlamına gelir. ‘Geçersiz karakter’ genellikle yanlışlıkla özel bir sembolün dahil edildiği bir kopyala-yapıştır hatasına işaret eder. ‘Yanlış iç içe yerleştirilmiş’ ise HTML etiketlerinizin yanlış sırada kapandığı anlamına gelir.
Bir İçerik Yönetim Sistemi (CMS) kullanan siteler için bu hatalar genellikle tüm siteyi kapsar. Tek bir şablon dosyasını düzeltmek, tüm etki alanı genelindeki binlerce hatayı çözebilir. Bir düzeltme yaptıktan sonra, önbelleğinizi (cache) her zaman temizleyin ve doğrulayıcıyı yeniden çalıştırın. Bu, kodun hala hatayı içeren eski, önbelleğe alınmış bir sürümünü değil, en son sürümünü test ettiğinizden emin olmanızı sağlar.
Bu hafta nereden başlamalı?
Ana sayfanız, en çok satan ürününüz ve iletişim sayfanız gibi en önemli beş sayfanızı seçerek başlayın. Bu URL’leri Yandex Yapılandırılmış Veri Doğrulayıcısı’ndan geçirin. Kırmızı hatalar görüyorsanız, önce zorunlu alanları düzeltmeye öncelik verin. Microdata iç içe yerleştirmenizi kontrol edin ve tüm tırnak işaretlerinin doğru şekilde eşleştiğinden emin olun. Bu sayfalar temizlendikten sonra, tüm dijital varlığınızda tutarlı veri kalitesi sağlamak için sitenizin diğer şablonlarına geçin.