Merchant Center variant_option, her varyant satırında renk, beden ve benzeri seçenekleri aynı ürün grubuyla ilişkilendirerek feed, API veya platform entegrasyonu üzerinden eklenir. Alanın doğru çalışması için her varyantın benzersiz kimliği, ortak ürün grubu ve seçeneği açıkça eşleşmelidir.
Google, Mayıs 2026'da ürün varyantlarını renk, beden ve benzeri özelliklerle daha açık tanımlamak için variant_option alanını kullanıma sundu. Bu alan özellikle moda, ayakkabı, aksesuar ve birden fazla kombinasyonu bulunan perakende kataloglarında önem taşır.
Merchant Center variant_option nedir ve ne işe yarar?
variant_option, aynı temel ürüne bağlı varyantın hangi seçenekle ayrıldığını Merchant Center'a bildiren ürün verisi alanıdır. Örneğin siyah, M beden bir tişört; kırmızı, L beden aynı ürün ailesinin farklı bir varyantıdır.
Önceden varyant ilişkisi yalnızca ürün başlığı, ürün kimliği veya grup işaretleri üzerinden anlaşılabiliyordu. Bu bilgiler tutarsızsa Merchant Center, aynı ürünü ayrı ürünler gibi görebiliyor veya farklı ürünleri tek varyant ailesinde birleştirebiliyordu.
Alan, ürünün bütün özelliklerini tekrar etmek için kullanılmaz. Varyantı diğer kardeş ürünlerden ayıran seçenekleri düzenli biçimde aktarmak için kullanılır. Renk ve beden birlikte değişiyorsa iki seçenek de aynı varyant kaydında belirtilmelidir.
Örneğin bir ayakkabı kataloğunda 40 numara beyaz ve 41 numara beyaz ürünleri ayrı stok kayıtlarıdır. Ancak ikisi aynı model, marka ve ürün grubuna bağlıdır. variant_option bu ilişkiyi renk ve numara üzerinden görünür kılar.
Bu alan tek başına yanlış ürün kimliğini düzeltmez. Her varyantın stok, fiyat, görsel, URL ve kullanılabilirlik bilgileri de kendi kaydında doğru olmalıdır. Eksik temel veriler, doğru seçenek bilgisine rağmen ürün reddine yol açabilir.
variant_option hangi ürünlerde kullanılmalıdır?
variant_option, aynı ürünün seçenekleri değiştiğinde kullanılmalıdır. Renk, beden, ölçü, kapasite, desen veya üretici tarafından sunulan benzer seçenekler bu kapsama girebilir.
Bir ürünün yalnızca paketi değişiyorsa önce bunun gerçek varyant mı, yoksa ayrı bir ürün mü olduğunu belirleyin. Örneğin 250 gram ve 500 gram kahve paketleri bazı kataloglarda seçenek, bazı kataloglarda farklı ürün olarak yönetilebilir.
Varyant kararı, ürünün satın alma sürecindeki seçime bağlı olmalıdır. Kullanıcı aynı ürün sayfasında yalnızca renk veya beden seçiyorsa kayıtlar çoğunlukla tek ürün ailesinde gruplanabilir.
Farklı marka, model, kullanım amacı veya temel tasarım söz konusuysa variant_option kullanmak uygun değildir. Siyah spor ayakkabı ile siyah bot aynı renge sahip olsa bile aynı varyant ailesine bağlanamaz.
Yanlış: Renk değeri aynı olan tüm ürünleri tek varyant grubuna almak. Doğru: Aynı model ve ürün ailesindeki kayıtları, renk ve beden seçenekleriyle birlikte eşleştirmek.
Alan, ürün grubunu yapay biçimde genişletmek için kullanılmamalıdır. Google'ın ürün verisi politikaları ve katalog yapısı, varyantların gerçekten aynı ürüne ait olmasını gerektirir. Bu nedenle önce platformunuzdaki ürün ailelerini kontrol edin.
variant_option feed dosyasına nasıl eklenir?
variant_option feed dosyasına, Merchant Center hesabınızda kullanılan veri kaynağının desteklediği alan adı ve veri tipiyle eklenir. CSV, XML veya Google Sheets kullanıyorsanız ilgili sütun ya da düğümü veri kaynağı şemasına göre oluşturun.
İlk adım, Merchant Center'da ürün veri kaynağını açıp alanın hesabınızda nasıl adlandırıldığını kontrol etmektir. Alan adını tahmin ederek yazmayın. Google'ın kullandığı ad, feed formatına göre farklı gösterilebilir.
CSV veya Google Sheets akışında her varyant satırı ayrı bulunmalıdır. Aynı ürün ailesindeki kayıtlar ortak grup kimliğiyle ilişkilendirilirken, variant_option hücresinde o satırın gerçek seçeneği yer almalıdır.
Örnek yapı şu mantığı taşımalıdır: ürün kimliği benzersiz, grup kimliği ortak, variant_option değeri satıra özel olmalıdır. Birinci satırda renk siyah ve beden M, ikinci satırda renk siyah ve beden L bulunabilir.
Bir ürünün yalnızca rengi değişiyorsa beden alanını boş bırakmak yerine sisteminizin desteklediği biçimde yalnızca renk seçeneğini gönderin. Kullanılmayan seçeneklere sahte değer yazmak, katalogda yanlış varyant bilgisi oluşturabilir.
XML veya API kullanan mağazalarda da mantık aynıdır. Her ürün kaydında seçeneklerin hangi ürüne ait olduğu, hangi değerleri taşıdığı ve kardeş kayıtlarla nasıl gruplandığı açıkça aktarılmalıdır.
Feed'i gönderdikten sonra dosyanın yalnızca yüklenmiş olması yeterli değildir. Merchant Center'da işleme sonucunu, alan eşleşmesini, uyarıları ve ürün bazında oluşan son değeri kontrol edin.
Platform entegrasyonunda variant_option nasıl oluşturulur?
Platform entegrasyonunda variant_option genellikle ürün seçenekleri, varyant kombinasyonları veya Google ürün alanları bölümünden oluşturulur. Alanı doğrudan tema ayarlarında değil, Google feed veya kanal entegrasyonu ekranında arayın.
İkas, T-Soft veya başka bir e-ticaret platformunda önce ürünün varyant yapısını inceleyin. Renk ve beden seçenekleri ürün seçenekleri olarak tanımlanmışsa entegrasyonun bunları Google alanına otomatik taşıyıp taşımadığını kontrol edin.
Otomatik aktarım yapılmıyorsa platformun özel alan, feed şablonu veya alan eşleme özelliğini kullanmanız gerekir. Bu işlemde kaynak alan renk ve beden, hedef alan ise Merchant Center'ın variant_option alanı olmalıdır.
Kaynak sistemde renk adı “Siyah”, Google feed'inde “black” veya “Black” olarak gönderilebilir. Ancak aynı katalog içinde farklı yazım biçimleri kullanmak raporlamayı ve varyant kontrolünü zorlaştırır.
Bu nedenle önce standart bir sözlük hazırlayın. Renk, beden, ölçü ve kapasite değerlerini tek biçimde yazın. Ürün yöneticileri, içerik ekibi ve entegrasyon sorumluları aynı sözlüğü kullanmalıdır.
Platform karşılaştırması yaparken yalnızca tema veya ödeme özelliklerine bakmayın. Varyantların Google'a hangi alanlarla aktarıldığını da inceleyin. Bu konuda İkas mı T-Soft mu karşılaştırması içindeki teknik değerlendirme başlıkları yardımcı olabilir.
Entegrasyon alanı desteklemiyorsa geçici çözüm olarak manuel feed kullanılabilir. Ancak ürün sayısı yüksekse bu yöntem sürdürülebilir değildir. Güncelleme sıklığı, stok değişimi ve yeni varyant ekleme yükünü ayrıca hesaplayın.
Renk ve beden değerleri nasıl yazılmalıdır?
Renk ve beden değerleri, ürün sayfasındaki gerçek seçeneklerle birebir ve tutarlı yazılmalıdır. Kullanıcıya “Koyu gece”, feed'e “Siyah” gönderiyorsanız iki alan arasında açık bir eşleşme kurmanız gerekir.
Renk değerlerinde gereksiz pazarlama sıfatları kullanmayın. “Muhteşem gece siyahı” yerine ürün sayfasında ve feed'de anlaşılır bir renk adı tercih edin. Birden fazla renk varsa ürünün gerçek baskın veya kombinasyon değerini belirtin.
Beden değerlerinde mağazanızın ölçü sistemini koruyun. “M”, “L”, “38”, “40” ve “42” gibi değerler birbirinin yerine yazılmamalıdır. Ayakkabıda EU 40 kullanıyorsanız aynı modelin diğer numaraları da aynı sistemle aktarılmalıdır.
Unisex ürünlerde kadın ve erkek bedenlerini tek alanda karıştırmayın. Kaynak sistemde “Kadın 38” ve “Erkek 38” ayrımı varsa bu ayrımın ürün grubu veya seçenek yapısında korunması gerekir.
Çoklu seçenekleri tek metinde birleştirirken hesabınızdaki şema kurallarına uyun. Google'ın alan formatı belirli ayraç, sıra veya yapı istiyorsa yalnızca o format kullanılmalıdır. Rastgele virgül ya da eğik çizgi eklemeyin.
Değer değişikliklerini toplu yapmadan önce küçük bir test grubunda deneyin. Beş ila on ürünlük bir örneklemde renk, beden, URL ve stok eşleşmesini kontrol etmek, tüm kataloğu bozma riskini azaltır.
Ürün sayfasında seçilebilir olmayan bir değeri variant_option olarak göndermeyin. Kullanıcı satın alamadığı bir seçeneği Merchant Center'a bildirmek, stok ve kullanılabilirlik verilerinde çelişki yaratır.
Varyant ürün kimliği ve grup ilişkisi nasıl kurulmalıdır?
Varyant ilişkisinin temelinde iki ayrı kimlik bulunur: her satırı ayıran varyant kimliği ve aynı ürün ailesini belirten grup kimliği. Bu iki alanı aynı değerle doldurmak doğru değildir.
Örneğin siyah-M tişörtün kimliği “tisort-001-siyah-m”, siyah-L tişörtün kimliği “tisort-001-siyah-l” olabilir. Her iki kayıt aynı ürün ailesini temsil eden ortak bir grup kimliği taşımalıdır.
Kimliklerde renk veya beden kullanıyorsanız değerleri sabit biçimde üretin. “Siyah-M”, “siyah_m” ve “BLACK-M” gibi değişken biçimler aynı seçeneğin üç ayrı kayıt gibi görünmesine neden olabilir.
Ürün URL'si varyanta özel açılıyorsa URL'nin ilgili renk ve bedeni gerçekten seçtiğini kontrol edin. Tüm varyantların aynı genel ürün sayfasına yönlenmesi, seçenek bilgisini kullanıcı deneyiminde görünmez bırakabilir.
Görsel de varyanta uygun olmalıdır. Kırmızı ürün kaydında yalnızca siyah ürün görseli bulunması, variant_option alanındaki doğru değeri pratikte zayıflatır.
Fiyat ve stok da varyant bazında gönderilmelidir. Siyah-M stokta yokken siyah-L stokta varsa iki satırın kullanılabilirlik ve miktar verileri aynı olmamalıdır.
Bu düzen, Merchant Center raporlarını okurken de önemlidir. Fiyat karşılaştırması yapmak için Merchant Center fiyat rekabeti raporunu inceliyorsanız, yanlış gruplanmış varyantlar ürün eşleşmelerini etkileyebilir.
variant_option ekledikten sonra hangi kontroller yapılmalıdır?
variant_option ekledikten sonra önce feed işleme durumunu, ardından ürün bazlı uyarıları ve son olarak ürün sayfasındaki seçenekleri kontrol edin. Bu üç aşamadan biri atlanırsa sorun kaynağı belirsiz kalır.
- Test ürünlerinden oluşan küçük bir feed gönderin.
- Merchant Center'da veri kaynağının son işleme zamanını kontrol edin.
- variant_option alanının tanındığını ve boş kalmadığını inceleyin.
- Aynı ürün grubundaki varyantların doğru eşleştiğini karşılaştırın.
- Renk, beden, fiyat, stok ve URL bilgilerini ürün sayfasında doğrulayın.
- Uyarı veya ret oluşursa hata metnini ürün kimliğiyle birlikte kaydedin.
- Düzeltmeden sonra yeniden işleme alın ve sonucu tekrar kontrol edin.
İlk kontrolde yalnızca toplam ürün sayısına bakmayın. Toplam sayı değişmemiş olabilir, ancak varyantların grup yapısı, seçeneği veya kullanılabilirlik bilgisi düzelmiş olabilir.
Ürün ayrıntılarında variant_option görünmüyorsa alanın henüz işlenmemiş olması mümkündür. Bu durumda feed gönderim zamanı ile Merchant Center'ın son güncelleme zamanını karşılaştırın.
Kontrol sırasında şu listeyi kullanın:
- Her varyantın benzersiz ürün kimliği var mı?
- Aynı modele ait varyantlar ortak grup kimliği taşıyor mu?
- Renk ve beden değerleri ürün sayfasıyla aynı mı?
- Varyanta özel URL ve görsel doğru mu?
- Stokta olmayan seçenekler yanlışlıkla kullanılabilir görünüyor mu?
- Feed işleme raporunda alan biçimi hatası var mı?
- Ürün grubu, farklı model veya marka kayıtlarını içermiyor mu?
Özellikle toplu güncellemelerde raporu dışa aktararak eski ve yeni değerleri karşılaştırın. Değişiklik kaydı tutmak, hangi alanın reddi veya yanlış eşleşmeyi oluşturduğunu bulmayı kolaylaştırır.
variant_option hangi hatalara ve retlere yol açabilir?
En yaygın hata, variant_option değerinin ürün sayfasındaki seçenekle uyuşmamasıdır. Feed “M beden” derken sayfada yalnızca “L” seçilebiliyorsa veri tutarsız kabul edilebilir.
İkinci hata, aynı ürün ailesine ait olmayan kayıtları ortak gruba almaktır. Farklı model, farklı marka veya farklı kullanım amacı bulunan ürünler aynı renk değerini taşısa bile tek varyant grubuna bağlanmamalıdır.
Üçüncü hata, varyant kimliklerini değiştirmektir. Her feed güncellemesinde kimlik değişirse Merchant Center yeni ürünler görebilir. Bu durum geçmiş performansın ve ürün eşleşmelerinin izlenmesini zorlaştırır.
Bir başka sorun da stok bilgisinin varyantlar arasında kopyalanmasıdır. Tüm bedenlere aynı stok gönderilirse kullanıcılar bulunmayan seçeneğe yönlendirilebilir. Stok, sipariş sistemiyle düzenli ve tutarlı güncellenmelidir.
Yanlış yapılandırma, yanlış beyan veya ürün verisi uyuşmazlığı gibi farklı incelemeleri de tetikleyebilir. Ret mesajını yorumlarken Merchant Center'da yanlış beyan reddinin çözüm adımlarını ayrıca inceleyin.
Bir alanı ekledikten sonra tüm retlerin hemen kaybolacağını varsaymayın. variant_option yalnızca varyant bilgisini düzenler; teslimat, iade, fiyat, görsel veya marka sorunlarını kendiliğinden çözmez.
Hatanın kaynağını ayırmak için önce tek ürün üzerinde düzeltme yapın. Aynı değişikliği yüzlerce ürüne uygulamadan önce ürün ayrıntısındaki sonucu ve feed teşhisini doğrulayın.
variant_option için feed, API ve manuel yöntem nasıl karşılaştırılır?
Yöntem seçimi, katalog büyüklüğü, güncelleme sıklığı ve teknik erişime göre yapılmalıdır. Az sayıda ürün için manuel feed yeterli olabilir; sık değişen büyük kataloglarda otomasyon daha uygundur.
| Yöntem | Ne zaman uygundur? | Temel risk | Kontrol noktası |
|---|---|---|---|
| CSV veya Google Sheets | Az ve orta büyüklükte kataloglar | Elle yazım ve güncelleme hatası | Sütun adı, satır eşleşmesi |
| XML feed | Otomatik ve düzenli veri akışı | Şema veya düğüm hatası | XML doğrulama ve işleme raporu |
| API | Gerçek zamanlıya yakın sistem entegrasyonu | Kimlik ve veri eşleme hatası | İstek yanıtı ve ürün durumu |
| Platform entegrasyonu | Teknik kaynak sınırlı mağazalar | Alanların eksik aktarılması | Kaynak-hedef alan eşleşmesi |
CSV yönteminde en önemli konu, aynı satırda bulunan ürün kimliği, grup kimliği ve seçenek değerinin doğru eşleşmesidir. Sıralama değiştiğinde alanlar yanlış ürüne kaymamalıdır.
XML ve API yöntemlerinde veri tipi ile şema doğrulaması önem kazanır. Alan metin beklerken dizi gönderilmesi veya seçenek değerlerinin yanlış düğüm altında bulunması işleme hatası oluşturabilir.
Platform entegrasyonu kolay görünse de kaynak sistemin varyant yapısı sınırlı olabilir. Entegrasyon ekranında alan eşleme özelliği yoksa otomatik aktarımın eksik kalıp kalmadığını örnek ürünlerle test edin.
Seçtiğiniz yöntem ne olursa olsun, değişiklik sonrası ürün bazlı kontrol gereklidir. Dosyanın başarıyla alınması, Merchant Center'ın tüm varyantları doğru yorumladığı anlamına gelmez.
variant_option kullanımını ne sıklıkla denetlemelisiniz?
variant_option denetimi, ürün kataloğunda değişiklik yapıldığında ve düzenli veri güncellemelerinde gerçekleştirilmelidir. Sabit bir süre belirlemek yerine stok, fiyat ve varyant değişim sıklığını temel alın.
Yeni renk veya beden eklendiğinde ilgili ürün ailesini kontrol edin. Eski seçenek kaldırıldığında ise web sayfası, feed ve stok sisteminde aynı kaldırma işleminin yapıldığını doğrulayın.
Platform değişikliği, tema yenilemesi veya ürün veri kaynağı değişikliği sonrasında daha geniş test yapın. Bu işlemler, alan eşlemelerini ve varyant kimliklerini etkileyebilir.
Denetim için bir örneklem tablosu oluşturabilirsiniz. Her ürün ailesinden farklı renk, farklı beden ve stokta olmayan en az bir varyant seçin. Böylece yalnızca aktif ürünleri kontrol etmiş olmazsınız.
Popüler ürünlerde hata etkisi daha yüksek olabilir. Bu nedenle Merchant Center Popüler Ürünler raporunu incelerken yüksek gösterim alan ürünlerin varyant eşleşmelerini ayrıca kontrol edin.
Kontrol kaydında ürün kimliği, son feed zamanı, variant_option değeri, stok durumu ve alınan hata mesajı bulunmalıdır. Bu alanlar sorunu yeniden üretmeyi ve yapılan düzeltmeyi karşılaştırmayı sağlar.
Varyant yapısını düzeltmek, ürün verisinin yalnızca bir alanını değiştirmek değildir. Ürün grubu, URL, görsel, fiyat, stok ve seçeneklerin aynı ürünü göstermesi gerekir. Bu eşleşme sağlanmadan yapılan güncelleme eksik kalır.
Merchant Center ürün varyantlarınızı feed yapısı, alan eşleme ve ürün bazlı kontrollerle birlikte değerlendirmek istiyorsanız Medyografya'nın e-ticaret reklam süreçleri üzerine hazırladığı çalışmalardan yararlanabilirsiniz.
İlgili Yazılar
Sık Sorulan Sorular
Merchant Center variant_option nedir?
variant_option, aynı temel ürüne bağlı varyantın renk, beden, ölçü veya benzeri seçeneğini Merchant Center'a bildiren alandır.
variant_option feed dosyasına nasıl eklenir?
Kullandığınız CSV, XML, Google Sheets veya API şemasında desteklenen alan adıyla eklenir. Her varyant satırında ürün kimliği, grup ilişkisi ve gerçek seçenek değeri bulunmalıdır.
variant_option hangi ürünlerde kullanılmalıdır?
Aynı model veya ürün ailesinde yalnızca renk, beden, ölçü ya da benzeri seçenekleri değişen ürünlerde kullanılmalıdır.
variant_option ekledikten sonra ne kontrol edilmelidir?
Feed işleme durumu, alan eşleşmesi, ürün kimliği, grup ilişkisi, renk ve beden değerleri, URL, görsel, fiyat ve stok bilgileri kontrol edilmelidir.
variant_option yanlış eklenirse hangi sorunlar oluşabilir?
Varyantlar yanlış gruplanabilir, ürün seçenekleri sayfayla uyuşmayabilir, stok bilgisi hatalı görünebilir veya ürün verisi tutarsızlığına bağlı uyarılar oluşabilir.