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.
Okuduklarınızı güvenli bir denemeye dönüştürün
“Next.js JSON-LD Denetimi: Article, Breadcrumb ve WebApplication Şemaları” adımlarını gerçek veriye geçmeden önce sentetik bir örnekle JSON Biçimlendirici ve Doğrulayıcı üzerinde deneyin. İşaretler yalnızca bu sekmede tutulur.
Kaynaklar ve doğrulama
“Next.js JSON-LD Denetimi: Article, Breadcrumb ve WebApplication Şemaları” hazırlanırken 3 birincil veya resmî belge doğrudan kontrol edildi. Uygulamadan önce bağlantılardaki güncel sürümü ve değişiklik tarihini yeniden doğrulayın.
Rehberi tekrarlanabilir bir kontrole dönüştürün
“Next.js JSON-LD Denetimi: Article, Breadcrumb ve WebApplication Şemaları” için aşağıdaki 3 araçlık kontrol planını kullanın. Hedef: 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. Gerçek veri yerine güvenli bir örnekle başlayın; her adımın beklenen sonucunu ve kabul kararını kaydedin.
JSON Biçimlendirici ve Doğrulayıcı
- Hazırlık
- JSON verisini yapıştırın.
- Uygulama
- Biçimlendir veya küçült seçeneğini belirleyin.
- Kabul kontrolü
- Doğrulanan çıktıyı kopyalayın.
- Beklenen çıktı
- Biçimlendirilmiş JSON yanında kök türü, alan sayısı, en derin seviye ve UTF-8 çıktı baytı gösterilir. Alan sayısı dizi uzunluğuyla aynı ölçü değildir.. JSON verisini doğrulayın, okunabilir biçime getirin veya küçültün.
JSON Diff / Yapısal Karşılaştırma
- Hazırlık
- Eski ve yeni geçerli JSON değerlerini iki alana yapıştırın.
- Uygulama
- Yapısal karşılaştırmayı çalıştırıp yol ve değişiklik türü filtrelerini inceleyin.
- Kabul kontrolü
- Raporu kopyalayın veya JSON olarak indirin; anlamlı değişiklikleri şemayla ayrıca doğrulayın.
- Beklenen çıktı
- ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları. İki JSON değerinde eklenen, silinen, değişen ve türü değişen yolları bulun.
Meta Etiket / Favicon Üretici
- Hazırlık
- Site başlığı, açıklaması ve mutlak canonical URL'yi girin.
- Uygulama
- Sosyal görsel ile favicon adreslerini ekleyip canlı önizleme ve uyarıları inceleyin.
- Kabul kontrolü
- HTML veya Next.js taslağını kopyalayın; Search Console ve platform doğrulayıcılarında ayrıca test edin.
- Beklenen çıktı
- indirilebilir yeni dosya, boyut/biçim ölçümleri ve işlem sınırı. SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin.
JSON Biçimlendirici ve Doğrulayıcı için şu sınır geçerlidir: JavaScript Number büyük tam sayılarda hassasiyet kaybedebilir; uzun kimlikleri tırnaklı metin olarak tutun. Yinelenen anahtarlar ayrıştırmada kaybolabilir. Bu araç JSON Schema doğrulaması yapmaz. Bu koşul karşılanmıyorsa çıktıyı zincirin sonraki adımına aktarmayın.
“Next.js JSON-LD Denetimi: Article, Breadcrumb ve WebApplication Şemaları” kaydında hassas içeriği değil; araç adını, seçilen ayarı, tarayıcı sürümünü ve “API yanıtı inceleme” için kabul/red gerekçesini tutun. Böylece kontrol gerçek veriyi çoğaltmadan tekrarlanabilir.
“Next.js JSON-LD Denetimi: Article, Breadcrumb ve WebApplication Şemaları”, yapılandırılmış veri kapsamındaki görünür ByteQuant davranışı ve listelenen 3 birincil kaynak karşılaştırılarak hazırlandı. Sınırlar ve kabul ölçütleri karar desteği sunar; hukuki ya da güvenlik danışmanlığı yerine geçmez.