Next.js App Router’da güvenli JSON-LD üretimi, @id ilişkileri, Article/Breadcrumb/WebApplication seçimi, deprecated şemaların temizliği ve production doğrulaması için rehber.
Önce sayfanın ana türünü seçin
Bir blog yazısının ana türü BlogPosting, araç sayfasının WebApplication, gezinme yolunun BreadcrumbList olması doğaldır. Aynı sayfaya ilgisiz şema türleri eklemek arama motoruna daha fazla bilgi vermek yerine ana amacı belirsizleştirebilir. Structured data sıralama garantisi değil, görünür içeriğin makinece okunabilir açıklamasıdır.
FAQPage ve HowTo gibi türlerin Schema.org anlamı devam edebilir; ancak Google’ın bu rich result özelliklerini göstermemesi nedeniyle yalnızca görünür ve gerçekten ana içeriği temsil ettiklerinde kullanılmalıdır. Her araç sayfasına aynı genel soruları şema olarak çoğaltmak yerine asıl WebApplication ve Breadcrumb düğümlerini tamamlamak daha temizdir.
@id ile varlıkları tekrar etmeden bağlayın
Organization ve WebSite düğümlerine kalıcı @id verildiğinde makale publisher alanı tüm kuruluş bilgilerini yeniden yazmak yerine bu kimliğe referans verebilir. Örneğin https://bytequant.org/#organization ve /#website gibi fragment kimlikleri aynı varlığı sayfalar boyunca tutarlı biçimde tanımlar.
Makale için final URL sonuna #article eklemek; mainEntityOfPage, isPartOf ve publisher ilişkilerini anlaşılır kılar. @id kullanmak tek başına Knowledge Panel veya zengin sonuç üretmez, fakat çelişkili ad, URL ve logo tekrarını azaltır.
- Tek kuruluş adı ve final ana sayfa URL’si kullanın.
- Logo URL’sini taranabilir ve mutlak verin.
- Yazar ile yayıncı aynı değilse ayrı düğümler kurun.
- Sosyal profilleri yalnızca resmî hesaplar için sameAs ile bağlayın.
Article alanlarında doğruluk
headline görünür H1 ile, description sayfanın gerçek özetiyle ve author görünür byline ile eşleşmelidir. datePublished ilk yayın tarihini; dateModified yalnızca önemli içerik değişikliğini göstermelidir. Saat dilimi içeren ISO 8601 değerleri belirsizliği azaltır.
image alanına yalnızca makaleyi gerçekten temsil eden ve taranabilir görsel ekleyin. Site logosunu her yazının özel görseli gibi işaretlemektense uygun makale görseli yoksa alanı boş bırakmak daha dürüst olabilir. Kaynak bağlantıları görünür kaynakça ile birlikte citation alanında ifade edilebilir.
Next.js’te güvenli çıktı
JSON-LD sunucu bileşeninde script type=application/ld+json olarak üretilebilir. JSON.stringify tek başına kullanıcı veya içerik kaynaklı küçüktür işaretini güvenli hâle getirmez; < karakterini \u003c ile değiştirmek script bağlamından çıkış riskini azaltır. ByteQuant’ın SchemaScript bileşeni bu sanitizasyonu merkezi uygular.
Metadata ve JSON-LD farklı katmanlardır: canonical link, Open Graph ve robots Next.js Metadata API ile; varlık ilişkileri JSON-LD ile yönetilmelidir. Her ikisi de aynı rota ve başlık kaynaklarını kullanırsa çelişki riski düşer.
Production denetim sırası
Önce JSON.parse ile her scriptin geçerli JSON olduğunu doğrulayın; ardından @type, URL, tarih ve görünür metin eşleşmesini test edin. Google Rich Results Test yalnızca Google’ın desteklediği türleri değerlendirir; genel Schema.org sözdizimi için Schema Markup Validator ayrıca kullanılabilir.
Son olarak export edilmiş HTML’yi tarayıcıda kontrol edin. Yinelenen Organization düğümleri, eski FAQPage kalıntıları, göreli URL’ler ve yanlış dilde başlıklar build sonrası daha kolay görülür. Testin amacı mümkün olan en çok şemayı geçirmek değil, doğru ana varlığı eksiksiz ve yanıltmadan tarif etmektir.
- Tüm JSON-LD scriptlerini parse edin.
- Görünür H1, byline ve tarih ile karşılaştırın.
- URL’lerin final 200 hedeflerini doğrulayın.
- Google ve genel Schema.org doğrulamasını ayrı düşünün.
Kaynaklar ve doğrulama
Bu rehber hazırlanırken aşağıdaki birincil ve resmî belgeler kontrol edildi. Bağlantıların güncel sürüm ve değişiklik tarihlerini ayrıca inceleyin.
İçerik, görünür ByteQuant ürün davranışı ve varsa listelenen birincil kaynaklarla karşılaştırılarak hazırlanır. Genel bilgilendirmedir; hukuki veya güvenlik danışmanlığı değildir.