---
title: Schema JSON-LD Nested Graph
category: product
entity_type: skill
price: ₺369
canonical: https://forgehouse.ai/tr/skiller/schema-jsonld-nested-graph/
lang: tr
hreflang_alt: https://forgehouse.ai/skills/schema-jsonld-nested-graph/
last_updated: 2026-06-20
---

# Schema JSON-LD Nested Graph

> Compose typed, nested JSON-LD entity graphs in Astro and Next.js, invalid schema fails to compile, so typos never reach Search Console.

Astro ve Next.js projelerinde tipli, iç içe JSON-LD varlık grafikleri üreten TypeScript öncelikli bir sistem. Ayrık birlikler kullanarak Article, Product, LocalBusiness, Course ve Service şemalarını atomik temel taşlardan (Person, Organization, ImageObject) derleme zamanında bir araya getirir; geçersiz şemayı derlenemez kılar, böylece yazım hataları asla Search Console'a ulaşmaz.

## Ne için kullanılır
- Astro veya Next.js'te tek bir tipli prop'tan 5+ şema türü üretme
- İç içe varlık grafikleri oluşturma (Makale + Yazar + Yayıncı + Görsel)
- Şema yazım hatalarını üretimde değil derleme zamanında yakalama
- E-ticaret, blog ve kataloglar için Zengin Sonuç uyumlu çıktı üretme
- Birçok sayfada @id referansıyla tek bir Organization varlığını paylaşma
- Yapılandırılmış veriyi sıfır çalışma anı maliyetiyle derleme zamanında pişirme

## Faydalar
- Geçersiz şemayı imkansız kıl: yanlış @type veya eksik zorunlu alan derlenmez
- Bir yayıncı logosunu bir kez güncelle, her sayfaya otomatik olarak yansısın
- Daha zengin ve yüksek tıklama oranlı görünüm kazanan Zengin Sonuç uygun sayfalar yayınla
- Birleştirilebilir atomik kurucularla yapılandırılmış veri yeniden işini saatlerden dakikalara indir

## Ne içerir
- Beş şema türü ve atomik temel taşlar için ayrık birlik tip temeli
- Article, Product, LocalBusiness, Course ve Service için kurucu yardımcı fonksiyonlar
- XSS kaçışlı Astro JsonLd bileşeni ve Next.js App Router meta veri desenleri
- Derleme zamanı doğrulama betiği ve package.json CI kapısı bağlantısı
- Varlık otoritesi konsolidasyonu için @graph ve @id varlık-referans desenleri
- Sahte puanlar, fiyat biçimlendirme ve tarih yönetimini kapsayan kapsamlı anti-desen tablosu

## Kimler için
Geçersiz durumları derleyip eleyen ve elle JSON uğraşı olmadan zengin sonuçlar kazanan tip güvenli yapılandırılmış veri isteyen Astro veya Next.js geliştiricileri ve SEO mühendisleri için.

## Nasıl çalışır
Bu beceri schema.org spesifikasyonunu TypeScript discriminated union olarak modeller: geçersiz schema kelimenin tam anlamıyla derlenmez. Sonra iç içe entity graflarını (Article, Product, LocalBusiness, Course, Service) atomik builder'lardan birleştirir ve build anında pişirir.
1. Tip temelini @type literal'leri üzerinde discriminated union olarak tanımlar: Article seçildiğinde headline, author ve datePublished zorunlu olur; 'Atricle' gibi bir yazım hatası bir hafta sonra Search Console sürprizi değil, derleme hatasıdır.
2. Atomik ilkel yapıları bir kez kurar (person, organization, imageObject builder fonksiyonları) ve bileşik entity'leri bunlardan birleştirir; yayıncı logosu değişimi binlerce sayfa düzenlemesi değil tek fonksiyon düzenlemesidir.
3. Tekrarlayan entity'leri @id referansıyla bağlar: yayıncı Organization veya tekrarlayan yazar Person tek düğümde tanımlanır ve her yerden referans alır; entity otoritesi Google grafında sayfalara dağılmak yerine tek noktada birikir.
4. Serileştirmeyi XSS enjeksiyonuna karşı kapanış script dizisini kaçışlayan bir JsonLd bileşeniyle yapar ve birden çok schema'yı (article artı SSS artı breadcrumb) tek @graph dizisine sarar.
5. Her şeyi build anında pişirir: getStaticPaths veya generateStaticParams artı hash ile ezberlenen çıktı; aynı girdi asla iki kez serileşmez, çalışma zamanı maliyeti sıfırdır.
6. Zincir halinde doğrular: tsc --noEmit tip hatalarını yerelde yakalar, CI betiği spesifikasyon uyumunu kontrol eder, Rich Results CLI deploy öncesi test eder, deploy sonrası Search Console 7 gün izlenir ve snapshot testleri sessiz schema farklarını PR incelemesinde görünür kılar.

## Sık sorulanlar
### Yalnızca Astro ve Next.js projelerinde mi çalışır?
Kurucu fonksiyonlar saf TypeScript olduğundan TS'in derlendiği her yerde çalışır. Hazır parçalar, yani XSS kaçışlı Astro JsonLd bileşeni ve Next.js App Router meta veri desenleri bu iki framework'ü hedefler; başka yerde çıktıyı head enjeksiyonuna kendiniz bağlarsınız.

### Geçersiz şemanın derlenmemesi pratikte ne anlama geliyor?
Her şema türü ayrık birlik olarak tiplendiği için yanlış @type veya eksik zorunlu alan, haftalar sonra Search Console uyarısı olarak değil derleme anında TypeScript hatası olarak çıkar. Grafik derleme zamanında üretildiğinden sayfada çalışma anı maliyeti de sıfırdır.

### Hangi sayfaya hangi şema türünün gerektiğine karar verir mi?
Hayır. Beş bileşik tür (Article, Product, LocalBusiness, Course, Service) ile Person ve Organization gibi atomik temel taşları verir; sayfa-şema eşlemesini bildiğinizi varsayar. Strateji ve alan içerikleri sizin işiniz olarak kalır.

## Fiyat
₺369, tek seferlik, abonelik yok. KDV dahil.

İlgili rehber: [Yapay zekâ ile SEO nasıl yapılır](https://forgehouse.ai/tr/rehberler/yapay-zeka-ile-seo-nasil-yapilir/)