Ürün Şeması (Product JSON-LD) Oluşturucu

Ürün şeması (JSON-LD) nasıl oluşturulur?

Google, ürün sayfasındaki fiyatı ve stoğu HTML'den tahmin etmek yerine sayfaya gömülü schema.org Product verisini okur. Şema JSON-LD biçiminde, tek bir script etiketi içinde yazılır: ürünü tanımlayan bir Product nesnesi ve fiyat, para birimi, stok durumu, adres ve kargo bilgisini taşıyan bir Offer nesnesi. Yıldız puanı varsa AggregateRating, marka varsa Brand nesnesi eklenir.

Product { name, image[], description, brand, sku, gtin13, aggregateRating, offers: Offer { price, priceCurrency, availability, url, priceValidUntil, shippingDetails } }

Fiyat metin olarak, iki ondalıkla ve noktaylayazılır (549,90 TL → "549.90"); para birimi 3 harfli ISO kodudur (TRY). Stok durumu serbest metin değil, schema.org listesinden tam adresle verilir (https://schema.org/InStock). Barkod (GTIN) yazılmadan önce kontrol basamağı doğrulanır:

kontrol basamağı = (10 − (Σ hane × ağırlık) mod 10) mod 10 · ağırlık sağdan 3, 1, 3, 1…

Çıktıdaki her < karakteri \u003colarak kaçışlanır; böylece açıklamaya yazılan bir </script> parçası etiketi kapatıp sayfayı bozamaz. Tarayıcı ve Google bunu aynen < olarak okur.

Örnek hesaplama

1. Ürün: "Pamuklu Oversize Tişört, Siyah", 549,90 TL, stokta, iki görsel, marka "Marka", SKU TS-OVS-SYH, barkod 8691234567890, 4,6 puan / 128 değerlendirme, fiyat 2026-12-31'e kadar geçerli, Türkiye'ye kargo 49,90 TL.
2. GTIN denetimi: kontrol basamağı hariç 12 hane (869123456789) sağdan 3-1 ağırlıkla toplanır: 9×3 + 8×1 + 7×3 + 6×1 + 5×3 + 4×1 + 3×3 + 2×1 + 1×3 + 9×1 + 6×3 + 8×1 = 130. 130 zaten 10'un katı; kontrol basamağı (10 − 0) mod 10 = 0, numaranın son hanesiyle aynı. 13 hane olduğu için gtin13 olarak yazılır.
3. Fiyat 549,90 → "549.90", priceCurrency TRY; kargo 49,90 → shippingRate "49.90", addressCountry TR.
4. Puan 4,6 ve 128 değerlendirme → AggregateRating (bestRating 5, worstRating 1). Denetim: 0 sorun, 0 uyarı; tüm zorunlu ve önerilen alanlar dolu.
5. Üretilen kod (sayfaya aynen yapıştırılır):

<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Product", "name": "Pamuklu Oversize Tişört, Siyah", "image": [ "https://magazam.com/img/tisort-siyah-1.jpg", "https://magazam.com/img/tisort-siyah-2.jpg" ], "description": "%100 pamuk, 240 g/m² kumaş; S–XXL beden. 500 TL üzeri ücretsiz kargo, 14 gün iade.", "brand": { "@type": "Brand", "name": "Marka" }, "sku": "TS-OVS-SYH", "gtin13": "8691234567890", "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.6, "reviewCount": 128, "bestRating": 5, "worstRating": 1 }, "offers": { "@type": "Offer", "price": "549.90", "priceCurrency": "TRY", "availability": "https://schema.org/InStock", "url": "https://magazam.com/urun/pamuklu-oversize-tisort-siyah", "itemCondition": "https://schema.org/NewCondition", "priceValidUntil": "2026-12-31", "shippingDetails": { "@type": "OfferShippingDetails", "shippingRate": { "@type": "MonetaryAmount", "value": "49.90", "currency": "TRY" }, "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "TR" } } } } </script>

Zorunlu ve önerilen alanlar

Google iki ayrı zengin sonuç üretir: ürün snippet'i (fiyat, puan, stok satırı) için name ve offers yeterlidir; satıcı listesi(Alışveriş sekmesi, görselli kart) için görsel de zorunludur ve fiyat 0'dan büyük olmalıdır.

Sık yapılan hatalar

• Virgüllü fiyat."549,90" Google için geçersizdir; ondalık ayırıcı nokta olmalı. Araç bunu otomatik çevirir, elle yazarken en sık bozulan alan budur.
• Göreli görsel ve ürün adresi. /img/urun.jpg Google tarafından çözümlenmez; https:// ile başlayan tam adres gerekir. Araç göreli adresi koda yazmaz ve denetimde işaretler.
• Tutmayan barkod.Yanlış kopyalanan bir hane kontrol basamağını bozar; Google tutmayan GTIN'i hata sayar. Araç beklenen haneyi söyler; barkodu ürün etiketinden ya da tedarikçi listesinden düzeltin.
• Puan var, sayı yok. ratingValue yazılıp reviewCount ya da ratingCount verilmezse AggregateRating geçersiz olur. Sitenizde toplanmamış puanları şemaya yazmak yönerge ihlalidir.
• Şema ile sayfa farklı. Kampanya bitince sayfadaki fiyat değişir ama şema eski kalırsa Google uyuşmazlık verir. Şema ürün verisinden otomatik üretilmeli, elle güncellenmemeli.
• Her sayfada aynı şema. Kategori ve anasayfaya Product şeması koymayın; yalnız tek bir ürünü satan sayfada, o ürünün verisiyle kullanılır.

Mağaza yazılımında otomatik şema

Bu araç tek ürün için kod üretir; yüzlerce ürünü elle işlemek sürdürülebilir değildir. Doğru kurulumda mağaza yazılımı her ürün sayfasına şemayı ürün kaydından üretir: fiyat ve stok değiştiğinde şema aynı anda değişir, varyantlı ürünlerde ProductGroup ve hasVariant yapısı kurulur, kargo politikası shippingDetails olarak, müşteri puanları aggregateRating olarak yazılır. Çok ülkeye satan mağazalarda ise bölgenin para birimi ve fiyatı yazılmalıdır; aksi hâlde Almanya'daki müşteri arama sonucunda TL fiyat görür. ESOLTEC mağazalarında bu üretim ürün verisinden otomatik yapılır; araç, hazır bir yazılımınız yokken ya da mevcut sitenizin şemasını kontrol ederken işinize yarar.