Ürünlerinizi alışveriş platformlarına taşımak: XML feed rehberi

Ürünlerinizi Google'ın alışveriş sonuçlarında göstermek istediniz. Merchant Center hesabı açıldı, ürün dosyası yüklendi ve birkaç gün sonra ekranda bir uyarı belirdi: ürünlerin önemli bir kısmı "onaylanmadı". Sebep çoğu zaman karmaşık değildir; dosyada yazan fiyat, stok ya da ürün kodu sitedekiyle uyuşmuyordur. Bu yazıda ürün feed'inin ne olduğunu, Google'ın hangi alanları beklediğini ve feed'i nasıl sağlıklı tutacağınızı anlatıyoruz.

Ürün feed'i nedir?

Ürün feed'i, kataloğunuzun makinelerin okuyabileceği bir listesidir. Her ürün bir kayıt, her bilgi (ad, fiyat, stok, görsel) bir alandır. Alışveriş platformları sitenizi tek tek gezmek yerine bu listeyi okur ve ürünlerinizi kendi sonuçlarında gösterir.

Google Merchant Center için en yaygın biçim XML'dir: RSS 2.0 yapısında, Google'a özgü alanların g: önekiyle yazıldığı bir dosya. Örneğin fiyat <g:price>1299.00 TRY</g:price> şeklinde yer alır. Merchant Center ayrıca sekmeyle ayrılmış metin (TSV) dosyalarını kabul eder; büyük kataloglar için API seçeneği de vardır.

Dosyayı elle yüklemek yerine sitenizde sürekli güncel duran bir adres vermek daha sağlıklıdır. Merchant Center bu adresten dosyayı planlı olarak çeker; varsayılan aralık 24 saattir. Feed, ürün veritabanınızdan anlık üretildiğinde sitedeki her değişiklik bir sonraki çekimde platforma yansır.

Google Merchant Center hangi alanları zorunlu tutuyor?

Google'ın ürün verisi spesifikasyonuna göre ilk yedi alan her üründe zorunludur; sonrakiler ürüne göre zorunlu hâle gelir:

• id: Ürünün benzersiz kimliği, en fazla 50 karakter. Mümkünse stok kodunuzu (SKU) kullanın ve bir kez verdikten sonra değiştirmeyin; kimlik değişirse platform onu yeni bir ürün olarak görür.
• title: Ürün adı, en fazla 150 karakter. Sayfadaki ürün adıyla uyumlu olmalı.
• description: Ürün açıklaması, en fazla 5.000 karakter.
• link: Ürünün açılış sayfası; doğrulanmış alan adınızda, http ya da https ile başlamalı.
• image_link: Ana ürün görseli. Googlebot'un erişebileceği bir adreste olmalı.
• availability: Stok durumu: in_stock, out_of_stock, preorder ya da backorder. Ön sipariş için ayrıca availability_date gerekir.
• price: Fiyat ve ISO 4217 para birimi kodu (ör. TRY). ABD ve Kanada dışındaki ülkelerde fiyat KDV dahil yazılır.
• brand: Yeni ürünlerde zorunlu (film, kitap ve müzik kayıtları hariç). Markası olmayan ürünlerde boş bırakılmalı; "Genel" ya da "Yok" gibi yer tutucular kullanılmamalı.
• gtin: Üreticinin verdiği barkod numarası (EAN-13, UPC gibi). Ürünün GTIN'i varsa gönderilmesi beklenir. Geçerli bir GS1 numarası olmalı; tahmin edilmemeli, çünkü hatalı GTIN onaylanmama sebebidir.
• mpn: Üretici parça numarası. Ürünün GTIN'i yoksa gerekir.
• identifier_exists: Ürünün gerçekten GTIN'i, MPN'i ya da markası yoksa (ör. el yapımı ürünler) no olarak gönderilir. Tanımlayıcısı olan bir üründe bu alanı kullanmak sorun yaratır.
• condition: Ürün ikinci el ya da yenilenmişse zorunlu; değerler İngilizce yazılır (new, refurbished, used).

Kargo bilgisi (shipping) bir istisna. Google, kargo ücretini belirli ülkelerde zorunlu tutuyor; Türkiye bugün bu listede görünmüyor. Yine de kargo ücretini Merchant Center hesap ayarlarında ya da feed'de tanımlamak, alışveriş sonuçlarında toplam maliyeti doğru göstermek için iyi bir alışkanlıktır.

Varyantlı ürünler nasıl tanımlanır?

Bir tişörtün üç rengi ve dört bedeni varsa, Google için bunlar on iki ayrı üründür. Her varyant kendi id değeriyle gönderilir; aynı ürüne ait tüm varyantlar ise ortak bir item_group_id taşır. Bu alan bazı ülkelerde ve ücretsiz listelemelerde zorunlu; zorunlu olmadığı durumda da göndermek, platformun varyantları doğru gruplamasını sağlar.

Varyantı ayıran özellik hangisiyse o alan doldurulmalı: color, size, material, pattern, giyimde ayrıca age_group ve gender. En sık atlanan kural şudur: her varyantın açılış adresi farklı olmalı ve sayfa o varyant seçili açılmalı. Kırmızı M beden için gönderilen bağlantı, ziyaretçiyi varsayılan mavi S bedene götürüyorsa fiyat ya da stok uyuşmazlığı kaçınılmazdır.

Ürünler neden onaylanmıyor?

Merchant Center'daki onaylanmama nedenlerinin büyük kısmı birkaç başlıkta toplanır:

• Fiyat uyuşmazlığı: Feed'deki fiyat, açılış sayfasındaki ya da ödeme adımındaki fiyattan farklı. Kampanya başladı, site güncellendi ama feed bir gün sonra çekildi.
• Stok uyuşmazlığı: Sayfada "tükendi" yazarken feed hâlâ in_stock diyor.
• Eksik ya da hatalı tanımlayıcı: Barkodu olan bir ürün GTIN'siz gönderilmiş ya da GTIN uydurulmuş.
• Görsel sorunları: Görsel adresi robots.txt ile engelli, çok küçük, yer tutucu görsel kullanılmış ya da görselin üzerinde promosyon yazısı var. Google, tüm ürün görselleri için en az 500x500 piksel şartını duyurdu; uygulama 31 Ocak 2027'de başlayacak. Şimdiden buna göre hazırlanmak mantıklı.
• Açılış sayfası sorunları: Bağlantı ana sayfaya yönleniyor, 404 dönüyor ya da Googlebot sayfaya erişemiyor. Site taşıma sonrası eski adreslerin feed'de kalması bu sorunun yaygın bir kaynağıdır; ayrıntısını site taşıma ve 301 yönlendirmeleri yazımızda anlattık.

Merchant Center'ın "otomatik ürün güncellemeleri" özelliği, sayfadaki yapılandırılmış veriye bakarak fiyat, indirimli fiyat, stok ve durum alanlarındaki ara sıra oluşan uyuşmazlıkları düzeltebilir. Ancak Google bu özelliğin düzenli güncellemenin yerini tutmadığını, uyuşmazlık tespit edildiğinde ürünün güncellenmek yerine onaylanmayabileceğini açıkça belirtiyor.

Feed, sitenizde yazanın kopyasıdır; ondan farklı bir şey söylememeli.

Yapılandırılmış veri feed'le neden uyumlu olmalı?

Ürün sayfalarınızdaki Product şeması (schema.org yapılandırılmış verisi), Google'ın sayfayı okuyup feed'deki bilgiyi doğrulamak için kullandığı kaynaklardan biridir. Google'ın satıcı listeleme belgelerine göre bu işaretlemede ürün adı, görsel ve bir Offer içinde sıfırdan büyük fiyat ile para birimi bulunmalı; stok durumu da aynı yapıda belirtilir.

Pratikte kural basit: fiyat ve stok bilgisi üç yerde aynı olmalı. Feed'de, sayfada görünen metinde ve yapılandırılmış veride. Bu üçü aynı veritabanı alanından üretildiğinde uyuşmazlık neredeyse ortadan kalkar. Ayrı ayrı elle güncellendiğinde ise er geç biri geride kalır.

Feed ne sıklıkla güncellenmeli?

Merchant Center'da ürünler, son güncellemeden 30 gün sonra sona erer. Planlı çekim kurulu bir feed'de bu genellikle sorun olmaz; asıl soru, fiyat ve stok değişikliklerinin ne kadar hızlı yansıdığıdır.

Fiyatlarınız ayda bir değişiyorsa günlük çekim yeterlidir. Stok hızlı tükeniyorsa ya da sık kampanya yapıyorsanız çekimi gün içinde birkaç kez tekrarlamayı ya da API ile anlık güncellemeyi düşünün. Kampanyalarda fiyatı elle değiştirmek yerine sale_price ve sale_price_effective_date alanlarıyla indirim dönemini önceden tanımlamak, başlangıç ve bitiş anındaki uyuşmazlığı önler.

Meta ve pazaryerleri için ne değişiyor?

Meta'nın ürün kataloğu da benzer bir mantıkla çalışır; CSV, TSV, RSS XML, Atom XML ve Google Sheets biçimlerini kabul eder. Alan adları büyük ölçüde Google'ınkine benzer, ancak her platformun kendi zorunlu alanları ve kuralları vardır. En sağlıklı yaklaşım, tek bir ana ürün verisinden her kanal için ayrı feed üretmektir; aynı ürünü her platform için ayrı ayrı elle güncellemek, tutarsızlığın en kısa yoludur.

Türkiye'deki pazaryerleri ürün aktarımını genellikle kendi API'leri ya da entegratör yazılımlar üzerinden yürütür. Kategori eşleştirme, zorunlu özellik alanları ve fiyat kuralları platformdan platforma değiştiği için bu iş çoğu zaman bir yazılım entegrasyonu projesine dönüşür. Burada da ilke aynıdır: ürünün doğru bilgisi tek yerde durmalı, kanallar oradan beslenmeli.

Sonuç

Ürün feed'i kurulup unutulacak bir dosya değil, sitenizle aynı anda nefes alması gereken bir veri akışıdır. Fiyat, stok ve tanımlayıcılar tek kaynaktan geldiğinde onaylanmama sorunlarının çoğu kendiliğinden çözülür. E-ticaret projelerimizde ürün feed'leri sitenizle aynı panelden besleniyor; reddedilen ya da eksik ürünleri düzenli olarak kontrol ediyoruz.