Yapılandırılmış veri (structured data) ekledikten sonra Google'dan hata veya uyarı almak sık karşılaşılan bir durumdur. Bu rehberde en yaygın schema hatalarını, nedenlerini ve adım adım çözümlerini ele alacağız.
Hatalar genelde eksik zorunlu alanlar, yanlış tarih/URL formatı veya sayfa içeriği ile şema uyumsuzluğundan kaynaklanır. Doğru araçlarla tespit edip düzelttiğinizde zengin sonuç uygunluğunuz artar.
Hata: Zorunlu Alanlar Eksik
Belirti: Rich Results Test "Sayfa zengin sonuçlar için uygun değil" der; "Missing required field" uyarısı görürsünüz.
Çözüm: İlgili şema türü için zorunlu alanları ekleyin. FAQPage için mainEntity, her Question için name ve acceptedAnswer.text; Article için headline, author.name, datePublished mutlaka olmalıdır. Detaylar için Zorunlu Alanlar rehberine bakın.
Hata: Geçersiz Tarih Formatı
Belirti: "Invalid date" veya tarih alanının işlenemediği uyarısı.
Çözüm: ISO 8601 formatı kullanın: YYYY-MM-DD veya YYYY-MM-DDThh:mm:ss+03:00. 28-02-2025, Feb 28, 2025 gibi formatlar kabul edilmez. Ay ve gün tek haneliyse önüne sıfır ekleyin (örn. 2025-02-08). Tarih ve URL Formatları rehberinde örnekler bulabilirsiniz.
Hata: Geçersiz URL
Belirti: "Invalid URL" veya image/mainEntityOfPage alanında hata.
Çözüm: Tüm URL'ler mutlak (absolute) olmalıdır. /sayfa/ yerine https://site.com/sayfa/ kullanın. Protokol (https://) mutlaka ekleyin. Göreli path'ler schema'da kabul edilmez.
Hata: Boş mainEntity Dizisi
Belirti: FAQPage için "mainEntity should not be empty" benzeri mesaj.
Çözüm: mainEntity en az bir geçerli Question nesnesi içermelidir. Boş dizi [] veya hiç tanımlamamak hata verir. Dinamik içerikte, soru yoksa FAQPage şemasını sayfaya eklemeyin.
Hata: Sayfa İçeriği ile Şema Uyumsuzluğu
Belirti: Google, sayfadaki görünür içerikle şemadaki bilgilerin eşleşmediğini belirtir; manuel ceza veya "Spam" işareti alabilirsiniz.
Çözüm: Şemadaki sorular, cevaplar, başlıklar ve yazar bilgileri sayfada kullanıcıya görünür şekilde olmalıdır. Sadece SEO için eklenen, sayfada yer almayan bilgiler politika ihlalidir. İçeriği güncelleyin veya şemayı sayfadaki gerçek içerikle uyumlu hale getirin.
Uyarı: Önerilen Alanlar Eksik
Belirti: "Page is eligible for rich results" yazsa da "Missing recommended field" uyarıları görürsünüz.
Çözüm: Zorunlu değildir ancak eklemeniz önerilir. Article için image, publisher, dateModified; LocalBusiness için address, telephone, openingHoursSpecification ekleyerek zengin sonuç olasılığını artırırsınız.
Google Rich Results Test Kullanımı
Rich Results Test sayfa URL'si veya HTML kodu ile test yapmanıza olanak verir. Adımlar:
- Test sayfasına gidin.
- "Test etmek istediğiniz URL'yi girin" alanına sayfa adresinizi yapıştırın veya "KOD EKLE" ile HTML/JSON-LD girin.
- "URL TEST ET" butonuna tıklayın.
- Sonuçta "Uygun" veya "Uygun değil" ve hata/uyarı listesini inceleyin.
Schema Markup Validator Kullanımı
Schema.org Validator daha detaylı sözdizimi ve schema.org uyumluluk kontrolü yapar. URL veya doğrudan JSON-LD kodu girebilirsiniz. schema.org spesifikasyonuna göre eksik property'leri ve yanlış type kullanımlarını gösterir.
Search Console Yapılandırılmış Veri Raporu
Google Search Console → "Deneyim" → "Zengin sonuçlar" bölümünde indekslenmiş sayfalarınızdaki yapılandırılmış veri durumunu görürsünüz. "Geçerli" ve "Hatalı" sayfa sayıları listelenir. Hatalı sayfalara tıklayarak detaylı hata mesajlarına ulaşabilirsiniz.
Adım Adım Hata Ayıklama Akışı
- Tespit: Rich Results Test veya Schema Validator ile hatayı tespit edin.
- Sınıflandırma: Eksik alan mı, format hatası mı yoksa içerik uyumsuzluğu mu?
- Düzeltme: İlgili rehberlere (Zorunlu Alanlar, Tarih/URL Formatları) göre şemayı düzeltin.
- Tekrar test: Düzeltilmiş kodu veya sayfayı tekrar test edin.
- Yayın: Canlı sayfaya uygulayın ve birkaç gün sonra Search Console'dan kontrol edin.
Sonuç
Schema hataları çoğunlukla düzeltilebilir. Doğru formatları ve zorunlu alanları kullanarak, Schema JSON-LD Oluşturucu aracımızın doğrulama panelinden yararlanarak hataları önleyebilirsiniz. Zengin sonuç görünürlüğü Google'ın kararına bağlıdır; ancak geçerli şema kullanmak uygunluk için ilk adımdır.