Bir tişörtün üç rengi ve dört bedeni olduğunda mağazada on iki ayrı satın alınabilir teklif oluşabilir. Kullanıcı bunların aynı ürün ailesine ait olduğunu arayüzden anlayabilir; ancak Google’a yalnız genel bir Product işaretlemesi gönderildiğinde hangi renk ve bedenlerin aynı ana ürünün varyantı olduğu açık olmayabilir. Benzer sorun telefonların depolama kapasitesi, mobilyaların malzeme ve renk seçimi veya ayakkabıların numara ve kalıp seçeneklerinde de görülür.
Product Variant Schema, varyantları ProductGroup altında ilişkilendirerek bu yapıyı makine tarafından okunabilir hale getirir. Ana ürün ailesinin ortak özellikleri grup seviyesinde; her satın alınabilir renk, beden veya konfigürasyonun fiyatı, stoğu, görseli ve kimliği ise ayrı Product nesnesinde belirtilir.
Bu rehber genel Product Schema kurallarını veya ürün sayfası tasarımını tekrar etmez. Odak; ProductGroup, hasVariant, variesBy, isVariantOf, tek ve çok sayfalı URL mimarisi ile Merchant Center varyant verisinin tutarlılığıdır.
Product Variant Schema nedir?
Product Variant Schema, aynı ana ürünün belirli özelliklerde değişen satın alınabilir sürümlerini Google’a ilişkilendiren structured data modelidir. Google, beden, renk, malzeme, desen veya teknik konfigürasyon gibi farklılıklara sahip ürünleri gruplamak için ProductGroup sınıfını ve variesBy, hasVariant ile productGroupID özelliklerini destekler Google Product Variant Structured Data Rehberi.
ProductGroup doğrudan satın alınan teklif değildir. Ortak ürün ailesini temsil eder. Gerçek satın alınabilir seçenekler, grup içindeki ayrı Product varyantları ve bunlara bağlı Offer nesneleridir.
ProductGroup altında toplanmamalıdır.ProductGroup hangi problemi çözer?
Schema.org, ProductGroup türünü yalnız iyi tanımlanmış özelliklerde değişen ürünleri temsil eden grup olarak tanımlar. Grup ortak marka, açıklama, malzeme veya değerlendirme bilgisini taşıyabilir; varyantlar ise renk, beden ve teklif gibi kendilerine özgü alanları içerir Schema.org ProductGroup Tanımı.
- Aynı ürün ailesinin varyantları açıkça ilişkilendirilir.
- Google hangi özelliklerin değiştiğini anlayabilir.
- Her varyantın ayrı fiyat, stok, görsel ve ürün kodu belirtilebilir.
- Tekrarlanan ortak bilgiler grup seviyesinde yönetilebilir.
- Ürün varyantları merchant listing deneyimleri için daha doğru yorumlanabilir.
Varyant ile benzer ürün arasındaki fark nedir?
| Senaryo | Varyant mı? | Gerekçe |
|---|---|---|
| Aynı tişörtün siyah ve beyaz renkleri | Evet | Yalnız renk değişiyor |
| Aynı ayakkabının 40 ve 41 numarası | Evet | Yalnız beden değişiyor |
| Aynı telefonun 128 GB ve 256 GB sürümü | Evet | Tanımlı teknik özellik değişiyor |
| Aynı markanın iki farklı mont modeli | Hayır | Model ve ürün kimliği farklı |
| Tekli ürün ile üçlü paket | Genellikle hayır | Teklif yapısı ve ürün miktarı değişiyor |
| Standart ürün ile kişiselleştirilmiş özel üretim | İş modeline göre | Seçeneklerin aynı ürün ailesi olup olmadığı değerlendirilmelidir |
Yanlış gruplama, birbirinden bağımsız ürünlerin aynı ana ürünmüş gibi değerlendirilmesine neden olabilir. Grup yalnız variesBy ile belirtilen özelliklerde farklılaşmalıdır.
ProductGroup yapısının temel bileşenleri nelerdir?
| Özellik | Görevi | Örnek |
|---|---|---|
ProductGroup | Ana ürün ailesini temsil eder | Aynı model tişört |
productGroupID | Grubun benzersiz parent kimliğidir | TSHIRT-100 |
variesBy | Varyantları ayıran özellikleri listeler | color, size |
hasVariant | Gruba bağlı Product varyantlarını içerir | Siyah-S, Siyah-M |
isVariantOf | Product nesnesini gruba bağlar | Varyanttan parent gruba ilişki |
sku veya gtin | Her varyantı benzersiz tanımlar | TSHIRT-100-BLK-M |
Offer | Varyanta özgü fiyat, stok ve URL’yi taşır | 899 TRY, InStock |
Google, her varyantın structured data içinde benzersiz bir kimliği bulunmasını; her ürün grubunun da productGroupID veya varyantlardaki inProductGroupWithID üzerinden benzersiz biçimde tanımlanmasını ister Google Product Variant Structured Data Rehberi.
variesBy nasıl kullanılmalıdır?
variesBy, gruptaki ürünlerin hangi özellikler nedeniyle farklılaştığını belirtir. Schema.org özellikleri tam URI ile yazılabilir:
"variesBy": [
"https://schema.org/color",
"https://schema.org/size"
]
Bir ürün ailesi yalnız renk ve bedenle değişiyorsa işlemci, desen veya malzeme gibi gerçekte varyant belirlemeyen alanlar eklenmemelidir. Elektronik üründe bellek, ekran veya işlemci gibi doğrudan Schema.org özelliği olmayan özel boyutlar gerekiyorsa Google’ın desteklediği model ve görünür sayfa verisiyle uyum ayrıca değerlendirilmelidir.
Tek sayfalı varyant yapısı nasıl işaretlenir?
Tek sayfalı yapıda bütün varyantlar aynı ürün sayfasında seçilir. Kullanıcı renk veya beden değiştirdiğinde sayfa yenilenmeden görsel, fiyat ve stok değişebilir. Varyant seçimi query parametresiyle doğrudan açılabilir olsa bile genel ürün ailesini temsil eden tek ana sayfa bulunur.
Google, tek sayfalı yapıda bütün varyantların ait olduğu tek bir canonical URL kullanılmasını ister. Bu URL genellikle herhangi bir varyant seçilmeden açılan temel ürün adresidir Google Product Variant Structured Data Rehberi.
{
"@context": "https://schema.org",
"@type": "ProductGroup",
"name": "Organik Pamuk Tişört",
"productGroupID": "TSHIRT-100",
"variesBy": [
"https://schema.org/color",
"https://schema.org/size"
],
"hasVariant": [
{
"@type": "Product",
"sku": "TSHIRT-100-BLK-S",
"color": "Siyah",
"size": "S",
"offers": {
"@type": "Offer",
"url": "https://example.com/tisort?renk=siyah&beden=s",
"price": "899.00",
"priceCurrency": "TRY",
"availability": "https://schema.org/InStock"
}
}
]
}
Tek sayfada markup seçimle birlikte değişmeli mi?
Google’ın tek sayfalı örneğinde, kullanıcı varyant seçtikçe görünür fiyat ve stok değişse de sayfadaki markup’ın kullanıcı etkileşimiyle sürekli yeniden yazılması zorunlu değildir. İlk HTML veya render edilmiş yapı ürün grubunu ve desteklenen varyantları tam olarak açıklayabilir.
Bununla birlikte görünür sayfa ile structured data çelişmemelidir. Doğrudan belirli varyant URL’si açıldığında kullanıcıya o varyant önceden seçili gösteriliyorsa teklif URL’si, görsel, stok ve fiyat ilgili varyantla eşleşmelidir.
Ayrı URL’li varyant yapısı nasıl işaretlenir?
Çok sayfalı yapıda renk veya başka ana seçenekler ayrı sayfalarda bulunur. Örneğin yeşil ürün ve mavi ürün farklı path’lere sahip olabilir; bedenler bu sayfalar içinde seçilebilir. Her varyant sayfası yalnız diğer sayfadaki tek bir tanıma güvenmemeli, kendi markup’ında bulunan varlıkları tam ve bağımsız biçimde açıklamalıdır.
Google, çok sayfalı sitelerde tam ProductGroup tanımının varyant sayfalarında tekrarlanmasını ister. Diğer sayfalardaki varyantlara yalnız URL ile referans verilebilir; böylece Google farklı sayfaları keşfedebilir Google Product Variant Structured Data Rehberi.
- Her sayfa kendi üzerinde gösterilen varyantları eksiksiz açıklar.
- Ortak grup kimliği bütün sayfalarda aynı kalır.
- Diğer varyant sayfalarına
urlile referans verilebilir. - Her sayfanın structured data’sı tek başına anlaşılabilir olmalıdır.
- Sayfalar gerçek HTML bağlantılarıyla birbirine bağlanmalıdır.
Ayrı varyant URL’lerinde canonical nasıl kullanılmalıdır?
Çok sayfalı yapıda her varyant sayfası bağımsız ve eşit derecede önemliyse bütün sayfaları tek parent URL’ye canonical yapmak doğru değildir. Google, bu modelde bütün ProductGroup için tek bir canonical URL bulunmadığını belirtir; çünkü varyantlar farklı ve önemli sayfalara dağılmıştır.
Her indekslenebilir varyant sayfası genellikle kendi temiz URL’sine canonical vermelidir. Ancak URL yalnız takip, oturum veya gereksiz sıralama parametresi taşıyorsa aynı varyantın temiz URL’si canonical seçilmelidir. Canonical kararı ürün grubuna göre değil, gerçek URL ve içerik eşdeğerliğine göre verilmelidir.
Her varyantın ayrı URL’si olmalı mı?
Structured data her varyant için ayrı indekslenebilir sayfa zorunluluğu getirmez. Tek ürün sayfası bütün seçenekleri kullanıcıya eksiksiz sunabiliyorsa tek sayfa modeli kullanılabilir. Ancak Merchant Center’a gönderilen her varyant teklifinin, ilgili renk ve beden önceden seçili olacak şekilde açılabilen kalıcı URL’ye sahip olması veri eşleşmesini kolaylaştırır.
Google Merchant Center, aynı ürün grubundaki her varyantın benzersiz ürün ID’siyle ayrı kayıt olarak gönderilmesini ve mümkünse farklı path veya query parametresi kullanan varyanta özgü landing page URL’si sunulmasını önerir Merchant Center item_group_id Rehberi.
Varyant fiyatı ve stok durumu nasıl gösterilmelidir?
Fiyat ve stok grup seviyesindeki genel tahmin değil, satın alınabilir her varyantın gerçek teklifi olmalıdır. Siyah-M stokta, Siyah-L tükenmiş ve Mavi-M farklı fiyatlıysa her Product varyantı kendi Offer nesnesine sahip olmalıdır.
pricegörünür varyant fiyatıyla eşleşmeli.priceCurrencydoğru para birimini kullanmalı.availabilityseçilen varyantın gerçek stok durumunu göstermeli.urldoğrudan ilgili varyantı açmalı.- Görsel seçilen renk veya modeli göstermeli.
- SKU ve GTIN yalnız ilgili varyanta ait olmalı.
Tek bir fiyat veya stok bilgisini bütün varyantlara kopyalamak, kullanıcı deneyimi ve Merchant Center verisiyle çelişebilir.
Renk ve beden bilgisi nasıl yazılmalıdır?
Varyant değerleri kullanıcıya gösterilen gerçek bilgilerle tutarlı olmalıdır. “BLK” kodu veritabanında kullanılabilir; ancak görünür sayfada “Siyah” yazıyorsa schema ve Merchant Center verisinde anlaşılır değer tercih edilmelidir.
Merchant Center, standart color ve size alanlarının yanında Mayıs 2026’dan itibaren varyant belirleyici özelliklerin açıkça tanımlanabilmesi için variant_option alanını destekliyor. Google, beden varyantında hem standart size hem variant_option gönderilmesini önerir Merchant Center Beden Alanı Rehberi.
ProductGroup ile Merchant Center item_group_id nasıl eşleşir?
Structured data’daki productGroupID ile Merchant Center’daki item_group_id aynı parent ürün mantığını temsil eder. Teknik isimleri farklı olsa da mümkün olduğunda aynı kalıcı parent SKU veya grup kimliğinden üretilmeleri veri tutarlılığını güçlendirir.
| Katman | Grup alanı | Varyant kimliği |
|---|---|---|
| Product structured data | productGroupID | sku veya gtin |
| Merchant Center | item_group_id | id |
| Ürün veritabanı | Parent SKU / model ID | Varyant SKU |
Merchant Center aynı grup ID’sini kullanan her varyantın ayrı ürün ID’sine ve benzersiz renk, beden veya diğer varyant değerleri kombinasyonuna sahip olmasını ister Merchant Center item_group_id Rehberi.
Merchant Center variant_option nedir?
variant_option, Merchant Center ürün verisinde varyantı belirleyen özelliklerin ad ve değer çiftleriyle açıkça gönderilmesini sağlayan güncel grup alanıdır. Örneğin color:black, size:m veya elektronik üründe memory:256GB gibi bilgiler kullanılabilir.
Google, aynı item_group_id içindeki bütün ürünlerin aynı özellik adlarını kullanmasını ve her varyantın benzersiz değer kombinasyonuna sahip olmasını ister. Alan, item_group_title ve item_group_id ile birlikte kullanılmalıdır Merchant Center variant_option Rehberi.
Bu alan Product Variant Schema’nın yerine geçmez. Merchant Center kataloğundaki varyant ilişkisini güçlendirir; structured data ise ürün sayfasının Google Search tarafından anlaşılmasını sağlar.
Varyant kimlikleri nasıl tasarlanmalıdır?
- Her ürün grubu için değişmeyen parent kimliği oluşturun.
- Her satın alınabilir varyanta benzersiz SKU veya varyant ID verin.
- GTIN yalnız üretici tarafından ilgili varyant için atanmışsa kullanın.
- Renk, beden veya kapasite değişiminde varyant ID’sini ayırın.
- Aynı varyant ID’sini başka ürün grubunda yeniden kullanmayın.
- Büyük-küçük harf farkını benzersizlik yöntemi olarak kullanmayın.
- Structured data, feed ve sipariş sisteminde aynı eşleştirmeyi koruyun.
Merchant Center, aynı grup kimliğinin farklı ürünler için yeniden kullanılmamasını ve yalnız harf büyüklüğüne dayanarak benzersizleştirme yapılmamasını ister.
Tükenen varyant nasıl yönetilmelidir?
Ürün grubu satılmaya devam ediyor fakat yalnız belirli beden tükenmişse bütün ürün sayfasını 404 yapmak doğru değildir. Tükenen varyantın availability değeri güncellenmeli, kullanıcıya açıkça bilgi verilmeli ve varsa diğer seçenekler erişilebilir kalmalıdır.
Varyant kalıcı olarak kaldırıldıysa ayrı URL modelinde URL’nin yaşam döngüsü ayrıca değerlendirilir. Eşdeğer yeni varyant yoksa 404 veya 410; gerçekten karşılık gelen yeni ürün varsa ilgili hedefe yönlendirme düşünülebilir. Grup markup’ından ve Merchant Center verisinden kaldırılan varyant temizlenmelidir.
Product Variant Schema nasıl test edilir?
- Rich Results Test ile tek ürün sayfasını doğrulayın.
ProductGroup, grup ID ve varyant ilişkilerini kontrol edin.- Her varyantın benzersiz SKU veya GTIN taşıdığını doğrulayın.
variesByalanlarının gerçek seçeneklerle eşleştiğini inceleyin.- Fiyat, stok, görsel ve URL’yi görünür sayfayla karşılaştırın.
- Tek sayfalı modelde temel canonical URL’yi kontrol edin.
- Çok sayfalı modelde her sayfanın bağımsız ve tam markup taşıdığını doğrulayın.
- URL Inspection ile Google’ın render edilmiş HTML’i gördüğünü test edin.
- Search Console Merchant listings raporunda şablon sorunlarını izleyin.
- Merchant Center ürün gruplarıyla parent ve varyant ID’lerini karşılaştırın.
Google, markup’ın Rich Results Test ile doğrulanmasını, birkaç sayfada yayınlandıktan sonra URL Inspection ile kontrol edilmesini ve değişikliklerin sitemap aracılığıyla bildirilmesini önerir Google Product Variant Structured Data Rehberi.
En sık yapılan Product Variant Schema hataları
- Birbirinden farklı modelleri tek
ProductGroupaltında toplamak. - Her varyanta aynı SKU veya GTIN değerini vermek.
variesByiçinde gerçek olmayan özellikler belirtmek.- Varyanta özgü fiyat ve stok yerine grup seviyesinde tek teklif kullanmak.
- Tek sayfalı yapıda varyant parametrelerini ayrı canonical sayfalar gibi çoğaltmak.
- Çok sayfalı yapıda bütün varyantları tek parent URL’ye canonical yapmak.
- Diğer varyant sayfalarının tam grup tanımını eksik bırakmak.
- Structured data ile görünür renk veya beden değerlerini farklı yazmak.
- Merchant Center
item_group_idile site parent kimliğini ayırmak. - Aynı grup içindeki iki varyanta aynı renk-beden kombinasyonunu vermek.
- JavaScript ile seçilen varyantın URL, fiyat ve stok bilgisini güncellememek.
- Rich Results Test geçişini görünürlük garantisi sanmak.
Product Variant Schema kontrol listesi
- Ürünler gerçekten aynı modelin varyantları mı?
- Her grup kalıcı ve benzersiz
productGroupIDtaşıyor mu? variesBygerçek varyant boyutlarını gösteriyor mu?- Her varyant benzersiz SKU veya GTIN ile tanımlanıyor mu?
- Fiyat, stok, görsel ve URL varyanta özgü mü?
- Tek sayfa ve çok sayfa mimarisi doğru seçildi mi?
- Canonical yapısı seçilen varyant URL modeline uyuyor mu?
- Çok sayfalı varyantlarda her sayfa tam markup taşıyor mu?
- Structured data görünür içerikle eşleşiyor mu?
- Merchant Center grup ve varyant kimlikleri aynı veri modelinden mi geliyor?
- Renk, beden ve yeni
variant_optionalanları tutarlı mı? - Test ve hata takibi şablon bazında otomatikleştirildi mi?
Varyant verisinin ürün sayfası, ERP, structured data ve Merchant Center arasında aynı kaynaktan üretilmesi, e-ticaret entegrasyon hizmeti kapsamında fiyat ve stok uyuşmazlıklarını azaltabilir.
Sonuç: Varyant ilişkisi ürün veri modelinden başlamalıdır
Product Variant Schema yalnız ürün sayfasına eklenen ayrı bir kod parçası değildir. Sağlıklı sonuç için ana ürün, varyant kimliği, renk, beden, URL, fiyat ve stok ilişkileri ürün veritabanında doğru kurulmalıdır. Structured data bu ilişkiyi Google’a yansıtır.
Tek sayfalı mağazalarda tek ProductGroup ve ortak canonical; ayrı URL’li yapılarda ise her sayfada bağımsız ve tam grup ilişkisi gerekir. Structured data’daki productGroupID, Merchant Center’daki item_group_id ve mağazadaki parent SKU aynı ürün ailesini temsil etmelidir. Bu tutarlılık, e-ticaret SEO hizmeti çalışmalarında ürün varyantlarının doğru anlaşılması için temel teknik koşuldur.
Sıkça Sorulan Sorular
ProductGroup ile Product arasındaki fark nedir?
ProductGroup aynı ana ürünün varyant ailesini ve ortak özelliklerini temsil eder. Product ise renk, beden veya teknik özellik kombinasyonuyla satın alınabilen belirli varyanttır.
Her renk ve beden için ayrı Product nesnesi gerekir mi?
Satın alınabilir her benzersiz renk ve beden kombinasyonu ayrı varyant olarak modellenmelidir. Her varyant benzersiz SKU veya GTIN, fiyat, stok ve mümkünse doğrudan açılabilen URL taşımalıdır.
Varyant sayfaları aynı canonical URL’ye mi gitmelidir?
Tek sayfalı modelde bütün varyantlar genellikle ana ürün URL’sini canonical kullanır. Ayrı ve indekslenebilir varyant sayfalarında ise her sayfa çoğunlukla kendi temiz URL’sine canonical vermelidir.
ProductGroup ile Merchant Center item_group_id aynı şey midir?
Farklı sistem alanlarıdır ancak aynı parent ürün grubunu temsil ederler. Mümkün olduğunda productGroupID ve item_group_id aynı kalıcı parent SKU veya grup kimliğinden üretilmelidir.
Merchant Center variant_option nedir?
Variant_option, Merchant Center’da varyantı belirleyen özellikleri ad ve değer çiftleriyle açıklar. Google Mayıs 2026’dan itibaren renk, beden veya özel teknik seçeneklerin item_group_id altında daha net gruplanması için bu alanı destekliyor.
Product Variant Schema görünürlük garantisi verir mi?
Hayır. Geçerli structured data yalnız uygunluk ve ürünün doğru anlaşılması için yardımcı olur. Google’ın varyant bilgisini arama sonuçlarında göstermesi garanti edilmez.