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.
Okuduklarınızı güvenli bir denemeye dönüştürün
Gerçek veriye geçmeden önce sentetik bir örnekle adımları tamamlayın. İşaretler yalnızca bu sekmede tutulur.
Ö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.
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. JSON Biçimlendirici ve Doğrulayıcı için beklenen biçim: JSON Biçimlendirici ve Doğrulayıcı için başlangıç girdisi: araç açıklamasında belirtilen nesne, dizi veya alanları içeren sözdizimi geçerli JSON. Araç bu girdiyi “JSON verisini doğrulayın, okunabilir biçime getirin veya küçültün” amacıyla kullanır..
- Uygulama
- Biçimlendir veya küçült seçeneğini belirleyin. JSON Biçimlendirici ve Doğrulayıcı, şu yöntemi uygular: JSON Biçimlendirici ve Doğrulayıcı, “JSON verisini doğrulayın, okunabilir biçime getirin veya küçültün” hedefi için şu açıklanabilir yöntemi uygular: ayrıştırma, alan ve tür sınırlarını koruyan deterministik kurallarla yapılır.
- Kabul kontrolü
- Doğrulanan çıktıyı kopyalayın. JSON Biçimlendirici ve Doğrulayıcı kabul ölçütü: JSON Biçimlendirici ve Doğrulayıcı sonucunu kabul etmeden önce alan adları, veri türleri, kaçışlar ve boş/null değerlerin kaynakla birebir karşılaştırılması kontrolünü tamamlayın; beklenen amaç “JSON verisini doğrulayın, okunabilir biçime getirin veya küçültün” olmalıdır..
- Beklenen çıktı
- JSON Biçimlendirici ve Doğrulayıcı tamamlandığında ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları sunar; bu çıktı “JSON verisini doğrulayın, okunabilir biçime getirin veya küçültün” ihtiyacına göre düzenlenir.. 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. JSON Diff / Yapısal Karşılaştırma için beklenen biçim: JSON Diff / Yapısal Karşılaştırma için başlangıç girdisi: araç açıklamasında belirtilen nesne, dizi veya alanları içeren sözdizimi geçerli JSON. Araç bu girdiyi “İki JSON değerinde eklenen, silinen, değişen ve türü değişen yolları bulun” amacıyla kullanır..
- Uygulama
- Yapısal karşılaştırmayı çalıştırıp yol ve değişiklik türü filtrelerini inceleyin. JSON Diff / Yapısal Karşılaştırma, şu yöntemi uygular: JSON Diff / Yapısal Karşılaştırma, “İki JSON değerinde eklenen, silinen, değişen ve türü değişen yolları bulun” hedefi için şu açıklanabilir yöntemi uygular: ayrıştırma, alan ve tür sınırlarını koruyan deterministik kurallarla yapılır.
- Kabul kontrolü
- Raporu kopyalayın veya JSON olarak indirin; anlamlı değişiklikleri şemayla ayrıca doğrulayın. JSON Diff / Yapısal Karşılaştırma kabul ölçütü: JSON Diff / Yapısal Karşılaştırma sonucunu kabul etmeden önce alan adları, veri türleri, kaçışlar ve boş/null değerlerin kaynakla birebir karşılaştırılması kontrolünü tamamlayın; beklenen amaç “İki JSON değerinde eklenen, silinen, değişen ve türü değişen yolları bulun” olmalıdır..
- Beklenen çıktı
- JSON Diff / Yapısal Karşılaştırma tamamlandığında ayrıştırılmış yapı, alan ölçümleri ve açık sözdizimi bulguları sunar; bu çıktı “İki JSON değerinde eklenen, silinen, değişen ve türü değişen yolları bulun” ihtiyacına göre düzenlenir.. İ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. Meta Etiket / Favicon Üretici için beklenen biçim: Meta Etiket / Favicon Üretici için başlangıç girdisi: desteklenen türde, boyut sınırını aşmayan yerel dosya veya dosyalar. Araç bu girdiyi “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” amacıyla kullanır..
- Uygulama
- Sosyal görsel ile favicon adreslerini ekleyip canlı önizleme ve uyarıları inceleyin. Meta Etiket / Favicon Üretici, şu yöntemi uygular: Meta Etiket / Favicon Üretici, “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” hedefi için şu açıklanabilir yöntemi uygular: dosya tarayıcı belleğinde okunur; özgün dosya değiştirilmeden yeni çıktı üretilir.
- Kabul kontrolü
- HTML veya Next.js taslağını kopyalayın; Search Console ve platform doğrulayıcılarında ayrıca test edin. Meta Etiket / Favicon Üretici kabul ölçütü: Meta Etiket / Favicon Üretici sonucunu kabul etmeden önce özgün dosyanın korunması; çıktı açılabilirliği, beklenen sayfa/kare sayısı, boyut ve görünür kalitenin kontrolü kontrolünü tamamlayın; beklenen amaç “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” olmalıdır..
- Beklenen çıktı
- Meta Etiket / Favicon Üretici tamamlandığında indirilebilir yeni dosya, boyut/biçim ölçümleri ve işlem sınırı sunar; bu çıktı “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” ihtiyacına göre düzenlenir.. 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: JSON Biçimlendirici ve Doğrulayıcı için kullanım sınırı: Şema, kodlama ve veri kaybı varsayımlarını hedef sistemde doğrulayın. 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: JSON Biçimlendirici ve Doğrulayıcı ile yerel analiz” için kabul/red gerekçesini tutun. Böylece kontrol gerçek veriyi çoğaltmadan tekrarlanabilir.
İç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.