serkankaya.
English version
Birlikte çalışalım ↗

Product Schema: Ürün Sayfası İçin JSON-LD Rehberi

Product schema nedir, nasıl eklenir? Ürün snippet'i ile satıcı listesi farkı, zorunlu alanlar, varyantlar, indirimli fiyat ve test adımları tek rehberde.

Product schema, bir ürün sayfasındaki ad, görsel, fiyat, stok ve değerlendirme bilgisini Schema.org sözlüğüyle işaretleyen yapılandırılmış veridir. Google bu veriyi okuyarak ürünü arama sonuçlarında fiyat, stok ve puan gibi ek bilgilerle gösterebilir. Doğru kurulduğunda sayfaya yeni bilgi eklemez; sayfadaki bilgiyi arama motoru için netleştirir.

Bu yazıda ürün şemasını bir e-ticaret sitesine nasıl eklediğimi, hangi alanların zorunlu olduğunu ve en sık gördüğüm hataları anlatıyorum. Genel çerçeveyi e-ticaret SEO rehberimde verdim. Burada yalnızca ürün sayfasının işaretlemesine odaklanıyorum.

Product schema ne işe yarar?

Product schema, ürün bilgisini Google’ın yanlış yorumlayamayacağı bir biçimde vererek ürünün arama sonuçlarında zengin görünüme uygun hale gelmesini sağlar. Google’ın Product dokümantasyonuna göre bu işaretleme sayesinde fiyat, stok, değerlendirme puanı ve kargo bilgisi doğrudan arama sonuçlarında görünebilir.[1] Aynı belge, ürün bilgisinin Google Görseller ve Google Lens’te de daha zengin gösterilebileceğini belirtir.[1]

Yapılandırılmış veri (structured data), sayfadaki içeriği standart bir sözlükle etiketleyen ek bir katmandır. Schema.org bu sözlüğü sağlar. Product ise bu sözlükteki türlerden biridir ve Offer, AggregateRating, Review gibi alt türlerle birlikte çalışır.

Ürün sayfası JSON-LD Google ayrıştırır Zengin sonuç
Sayfadaki ürün bilgisi JSON-LD ile işaretlenir, Google bu veriyi ayrıştırır ve uygun görürse sonucu zengin biçimde gösterir.

Burada önemli bir sınır var. Google, işaretleme Zengin Sonuç Testi’nden geçse bile zengin sonucun gösterileceğini garanti etmediğini açıkça yazar.[5] Product schema bu yüzden bir uygunluk koşuludur, bir sıralama kaldıracı değildir. Ben beklentiyi müşteriyle konuşurken bu cümleyi aynen kullanırım.

Ürün snippet’i ile satıcı listesi arasındaki fark nedir?

Ürün snippet’i satın alma yapılamayan ürün sayfaları içindir; satıcı listesi ise ürünü doğrudan sattığınız sayfalar içindir. Google, ürün işaretlemesini bu iki sınıfa ayırır ve hangisinin sayfanıza uyduğuna göre farklı gereksinimler tanımlar.[1] İnceleme yazısı, karşılaştırma sayfası ya da üretici tanıtım sayfası ilk gruba girer. Sepete ekle düğmesi olan bir mağaza sayfası ikinci gruba girer.

Ürün snippet'i

  • Satın alma yapılamayan sayfalar
  • Zorunlu: name ve review, aggregateRating ya da offers alanlarından biri
  • Artılar ve eksiler (positiveNotes, negativeNotes) desteklenir
  • Editoryal inceleme sayfalarına uygun

Satıcı listesi

  • Ürünün doğrudan satıldığı sayfalar
  • Zorunlu: name, image ve offers
  • Fiyat sıfırdan büyük olmalı
  • Kargo, iade ve beden bilgisi gibi ayrıntılar eklenebilir
Google'ın iki ürün işaretleme sınıfı ve temel gereksinimleri (Google Search Central).

İki deneyim kısmen örtüşür. Google’a göre satıcı listesi için gereken zorunlu alanları eklediğinizde sayfanız genellikle ürün snippet’ine de uygun hale gelir.[1] Bu yüzden bir e-ticaret sitesinde hedefi baştan satıcı listesi olarak koyarım. Böylece tek işaretleme iki deneyimi birden kapsar.

Product schema için hangi alanlar zorunlu?

Kısa cevap

Product schema için hangi alanlar zorunlu?

Satış yapılan bir ürün sayfasında product schema için name, image ve offers alanları zorunludur. Offer içinde sıfırdan büyük bir price ve üç harfli ISO 4217 koduyla priceCurrency verilmelidir. Satın alma yapılamayan sayfalarda ise name alanı ile review, aggregateRating ya da offers alanlarından en az biri yeterlidir.

Zorunlu alanlar yalnızca alt sınırdır. Google’ın satıcı listesi belgesinde önerilen alanlar listesi çok daha uzundur.[3] Ben şablonu kurarken alanları aşağıdaki üç gruba ayırırım.

GrupAlanlarNot
Zorunluname, image, offers.price, offers.priceCurrencySatıcı listesi için olmazsa olmaz
Önemli öneridescription, sku, brand, gtin, offers.availability, offers.url, offers.itemConditionÜrünün doğru eşleşmesine yardım eder
Duruma göreaggregateRating, review, shippingDetails, hasMerchantReturnPolicy, inProductGroupWithIDVerisi gerçekten varsa eklenir

Fiyat alanında iki ayrıntıya dikkat ederim. Google, satıcı listesinde fiyatın sıfırdan büyük olmasını şart koşar.[3] Para birimi de “TL” gibi bir yazımla değil, ISO 4217 koduyla, yani Türk lirası için TRY ile verilmelidir.[3] Türkçe sitelerde en sık gördüğüm hata, fiyatın “1.299,90” gibi yerel biçimle yazılmasıdır. Schema’da ondalık ayırıcı noktadır ve binlik ayırıcı kullanılmaz: 1299.90.

Stok durumu (availability) için Schema.org’un tam adreslerini kullanırım: https://schema.org/InStock, https://schema.org/OutOfStock ya da https://schema.org/BackOrder. Google kısa adları da kabul ettiğini belirtir.[3] Yine de tutarlılık için tek bir biçimde kalmak, toplu kontrolü kolaylaştırır.

Product schema nasıl eklenir?

Product schema, ürün şablonuna eklenen bir JSON-LD bloğuyla ve değerleri sayfanın kendi verisinden otomatik doldurarak eklenir. Google üç biçimi destekler: JSON-LD, Microdata ve RDFa.[5] Önerdiği biçim JSON-LD’dir.[5] JSON-LD, HTML’nin geri kalanından ayrı durduğu için tema değişikliklerinden daha az etkilenir.

Aşağıdaki örnek, Türk lirasıyla satılan tek varyantlı bir ürünün temel işaretlemesidir. Değerler örnek amaçlıdır.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Seramik Kahve Kupası 350 ml",
  "image": [
    "https://www.ornekmagaza.com/img/kupa-1x1.jpg",
    "https://www.ornekmagaza.com/img/kupa-4x3.jpg"
  ],
  "description": "El yapımı, bulaşık makinesinde yıkanabilir 350 ml seramik kupa.",
  "sku": "KP-350-BEYAZ",
  "brand": { "@type": "Brand", "name": "Örnek Marka" },
  "offers": {
    "@type": "Offer",
    "url": "https://www.ornekmagaza.com/seramik-kahve-kupasi/",
    "price": 349.90,
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

Bu blok <script type="application/ld+json"> etiketi içinde sayfaya girer. Kodu elle değil, ürün şablonunda değişkenlerle üretirim. Böylece fiyat ya da stok değiştiğinde işaretleme de kendiliğinden güncellenir.

  1. Sayfa türünü belirleyin

    Ürün doğrudan satılıyorsa satıcı listesi, satılmıyorsa ürün snippet'i gereksinimlerini hedefleyin.

  2. Alan eşlemesini çıkarın

    Altyapıdaki her veri alanını (ürün adı, SKU, fiyat, stok) karşılık gelen Schema.org özelliğiyle eşleyin.

  3. Şablona JSON-LD ekleyin

    Bloğu ürün şablonunda değişkenlerle üretin; sabit değer yazmayın.

  4. Tek URL ile test edin

    Zengin Sonuç Testi ile birkaç farklı ürün tipini (stokta, tükendi, indirimli) ayrı ayrı deneyin.

  5. Yayına alıp izleyin

    Search Console'daki Satıcı listeleri ve Ürün snippet'leri raporlarında hata ve uyarıları takip edin.

Shopify, WooCommerce ya da IdeaSoft, T-Soft, ikas gibi Türkiye’de yaygın altyapıların birçoğunda tema, hazır bir Product işaretlemesiyle gelebilir. Bunu silip baştan yazmadan önce mevcut çıktıyı test ederim. Sorun çoğu zaman eksik bir alan ya da yanlış para birimidir ve tema düzeyinde küçük bir düzeltmeyle çözülür. İki ayrı eklentinin aynı sayfaya iki ayrı Product bloğu basması da sık rastladığım bir durumdur.

İndirimli fiyat ve varyantlar nasıl işaretlenir?

İndirimli fiyat, aktif fiyatı price alanında bırakıp eski fiyatı StrikethroughPrice türünde ikinci bir fiyat olarak ekleyerek işaretlenir. Google’ın satıcı listesi belgesine göre bu durumda aktif fiyat otomatik olarak indirimli fiyat kabul edilir.[3] Aynı belge, aktif fiyatın priceType ile etiketlenmemesi gerektiğini de belirtir.[3]

"offers": {
  "@type": "Offer",
  "price": 279.90,
  "priceCurrency": "TRY",
  "priceSpecification": {
    "@type": "UnitPriceSpecification",
    "priceType": "https://schema.org/StrikethroughPrice",
    "price": 349.90,
    "priceCurrency": "TRY"
  }
}

Üstü çizili fiyatı yalnızca sayfada da gerçekten gösterilen bir eski fiyat varsa eklerim. Kampanya dönemlerinde bu değerin kampanya bitince kalkması, şablonun mantığına bağlanmalıdır. Kampanya sayfalarının kendisini kampanya sayfası SEO yazısında ayrıca ele aldım.

Varyantlı ürünler: ProductGroup

Varyantlı ürünler, her varyantı ayrı bir Product olarak tanımlayıp bunları ProductGroup altında toplayarak işaretlenir. Google bu yapıda ProductGroup ile birlikte variesBy, hasVariant ve productGroupID alanlarının kullanılmasını önerir.[4] Bu işaretleme, ürünlerin satıcı listesinde varyant bilgisiyle gösterilmesine de uygunluk sağlar.[4]

Google varyantlar için iki site yapısı tanımlar.[4] Birincisinde tüm varyantlar tek sayfada, genellikle URL parametresiyle seçilir. İkincisinde her renk ya da beden ayrı bir sayfadadır. Hangisini kullandığınız, ProductGroup bloğunun hangi sayfada duracağını belirler. Varyant URL’lerinin kopya içerik üretmemesi için canonical etiketi kararını da aynı anda vermek gerekir.

Merchant Center tarafında aynı ilişki item_group_id alanıyla kurulur. Google, Product işaretlemesindeki inProductGroupWithID alanını bu feed alanının karşılığı olarak tanımlar.[3] İki tarafta aynı grup kimliğini kullanmak, sayfa ile feed arasındaki eşleşmeyi netleştirir. Feed tarafını ürün feed optimizasyonu yazısında anlattım.

Product schema’da en sık yapılan hatalar nelerdir?

Product schema’da en sık yapılan hata, sayfada görünmeyen ya da sayfayla çelişen bilgiyi işaretlemektir. Google’ın genel yönergeleri, okuyucunun göremediği içeriğin işaretlenmemesini ve yanıltıcı içerik kullanılmamasını açıkça ister.[5] Aynı yönergeler, ihlallerin manuel işleme yol açabileceğini ve bu durumda sayfanın zengin sonuç uygunluğunu kaybedeceğini belirtir.[5]

Denetimde en çok karşılaştığım hatalar şunlar:

  • Sahte ya da kaynağı belirsiz puan: Sayfada gerçek kullanıcı değerlendirmesi yokken aggregateRating eklemek.
  • Yerel fiyat biçimi: "price": "1.299,90 TL" gibi metin değeri. Doğrusu sayısal 1299.90 ve ayrı priceCurrency.
  • Bayat stok: Ürün tükendiği halde işaretlemenin InStock kalması. Önbelleğe alınmış şablonlarda sık görülür.
  • Çift blok: Tema ve bir SEO eklentisinin aynı ürün için iki farklı Product bloğu üretmesi.
  • Kategori sayfasında Product: Liste sayfasını tek bir ürün gibi işaretlemek. Kategori sayfası farklı bir sayfa türüdür; ayrıntısı kategori sayfası SEO yazısında.
  • Engellenmiş sayfa: Google, yapılandırılmış veri içeren sayfaların robots.txt ya da noindex ile engellenmemesi gerektiğini belirtir.[5]

Product schema nasıl test edilir ve izlenir?

Product schema, yayın öncesinde Zengin Sonuç Testi ile, yayından sonra Search Console’daki ürün raporlarıyla test edilir ve izlenir. Google’ın genel yönergeleri, teknik hataların çoğunun Zengin Sonuç Testi ve URL Denetimi aracıyla yakalanabildiğini belirtir.[5] Schema.org’un kendi doğrulayıcısı ise sözdizimini kontrol eder, ama Google’ın deneyime özel gereksinimlerini değerlendirmez.

Search Console’da Satıcı listeleri ve Ürün snippet’leri raporları, hangi URL’lerde hangi alanın eksik olduğunu gösterir. Raporların nasıl okunacağını Google Search Console kullanımı yazısında anlattım. Ben bir değişiklikten sonra önce birkaç URL’yi URL Denetimi aracıyla yeniden test eder, sonra raporun güncellenmesini beklerim.

Product schema yayın öncesi kontrol listesi0/9

Product schema ile Merchant Center birlikte mi kullanılmalı?

Evet, product schema ile Merchant Center feed’i birlikte kullanıldığında Google aynı ürün bilgisini iki kaynaktan görür. Bu iki kaynak birbirinin yerine geçmez. Feed, Alışveriş reklamlarını ve Merchant Center ücretsiz listeleme yüzeylerini besler. Sayfadaki işaretleme ise organik arama sonucunun kendisini zenginleştirir.

İki kaynağın tutarlı olması burada belirleyicidir. Sayfada 349,90 TL yazıp feed’de farklı bir fiyat göndermek, Merchant Center’da fiyat uyuşmazlığı sorununa yol açabilir. Bu yüzden fiyat ve stok değerini altyapıdaki tek bir alandan okutmayı tercih ederim. Alışveriş tarafının kurulumunu Google Alışveriş reklamları rehberinde ele aldım.

Yapay zekâ destekli alışveriş deneyimleri de ürün bilgisini yapılandırılmış kaynaklardan okur. Bu konudaki gözlemlerimi ChatGPT alışveriş yazısında paylaştım. Temiz bir product schema, bu yeni yüzeyler için de aynı veriyi tek bakışta okunur kılar.

Sonuç: Önce doğru veri, sonra işaretleme

Product schema, ürün sayfasındaki bilgiyi Google’ın okuyacağı biçimde netleştiren, düşük maliyetli ama disiplin isteyen bir teknik SEO işidir. Satış yapılan sayfada hedef satıcı listesidir; name, image ve offers olmadan başlamayın. Fiyatı sayısal ve TRY koduyla verin, indirimde eski fiyatı StrikethroughPrice olarak ayırın, varyantları ProductGroup altında toplayın.

Bir sonraki adım olarak sitenizdeki üç farklı ürünü (stokta, tükendi, indirimli) Zengin Sonuç Testi’nden geçirin ve sonuçları sayfadaki görünen bilgiyle karşılaştırın. Mağazanın geneline bakmak isterseniz e-ticaret SEO ve reklam yönetimi sayfasında nasıl çalıştığımı, teknik SEO yazısında ise altyapı tarafını anlattım.

Bu yazıdaki terimler

JSON-LD
JSON-LD, yapılandırılmış veriyi HTML'den ayrı bir script bloğunda JSON biçiminde yazmayı sağlayan bir bağlantılı veri formatıdır. Google'ın yapılandırılmış veri için önerdiği biçimdir; şablona eklenmesi ve test edilmesi Microdata ile RDFa'ya göre daha kolaydır.
Product schema
Product schema, bir ürün sayfasındaki ad, görsel, fiyat, stok ve değerlendirme bilgisini Schema.org'daki Product türüyle işaretleyen yapılandırılmış veridir. Google bu veriyi ürün snippet'i ve satıcı listesi gibi zenginleştirilmiş arama sonuçlarında kullanabilir.
ProductGroup
ProductGroup, aynı ana ürünün renk, beden ya da malzeme gibi özelliklerle ayrışan varyantlarını tek bir grupta toplayan Schema.org türüdür. productGroupID, variesBy ve hasVariant alanlarıyla Google'a varyant ilişkisini açıkça bildirir.
Satıcı listesi
Satıcı listesi, İngilizcede merchant listing olarak geçen ve ürünü doğrudan satan sayfalar için tanımlanmış bir Google arama deneyimidir. Fiyat, stok, kargo ve iade gibi ayrıntıları gösterebilir; bunun için Product işaretlemesinde Offer bilgisi zorunludur.
Ürün snippet'i
Ürün snippet'i, arama sonucundaki metin bağlantısının altında puan, değerlendirme, fiyat ve stok gibi ek ürün bilgisini gösteren bir zengin sonuç türüdür. Google bu işaretlemeyi özellikle doğrudan satın alma yapılamayan inceleme ve karşılaştırma sayfaları için tanımlar.
Tüm sözlük ↗

Sık sorulan sorular

Product schema nedir?

Product schema, bir ürün sayfasındaki ad, görsel, fiyat, stok ve değerlendirme bilgisini Schema.org sözlüğüyle makinenin okuyabileceği biçimde işaretleyen yapılandırılmış veridir. Google bu veriyi kullanarak ürünü arama sonuçlarında fiyat, stok ve puan gibi ek bilgilerle gösterebilir.

Product schema sıralamayı yükseltir mi?

Product schema doğrudan bir sıralama sinyali olarak çalışmaz. Etkisi, sonucun görünümünü zenginleştirerek tıklamayı artırma ihtimalinde ve ürün bilgisinin Google tarafından doğru anlaşılmasındadır. Google ayrıca doğru işaretlemenin zengin sonuç gösterimini garanti etmediğini belirtir.

Product schema için hangi alanlar zorunlu?

Ürün snippet'i için name alanı ve review, aggregateRating ya da offers alanlarından en az biri gerekir. Satış yapılan sayfalarda hedeflenen satıcı listesi deneyimi için name, image ve offers zorunludur. Offer içinde de sıfırdan büyük bir price ve ISO 4217 biçiminde priceCurrency verilmelidir.

Product schema'yı JSON-LD ile mi Microdata ile mi eklemeliyim?

Google üç biçimi de destekler: JSON-LD, Microdata ve RDFa. Google'ın önerdiği biçim JSON-LD'dir, çünkü HTML'den ayrı bir script bloğunda durur ve şablona eklemesi, bakımı ve test etmesi daha kolaydır.

Varyantlı ürünlerde product schema nasıl yazılır?

Varyantlı ürünlerde her varyant ayrı bir Product olarak işaretlenir ve bunlar ProductGroup altında toplanır. ProductGroup içinde productGroupID, variesBy ve hasVariant alanları kullanılır. Böylece Google hangi ürünlerin aynı ana ürünün renk ya da beden çeşidi olduğunu anlar.

Kaynaklar

  1. Google Search Central: Product yapılandırılmış verisine giriş
  2. Google Search Central: Ürün snippet'i (Product, Review, Offer)
  3. Google Search Central: Satıcı listesi (Product, Offer)
  4. Google Search Central: Ürün varyantı yapılandırılmış verisi (ProductGroup, Product)
  5. Google Search Central: Yapılandırılmış veri genel yönergeleri