Sophi Ürün Feed Rehberi / Product Feed Guide

1. Genel Bakış / Overview

Sophi, e-ticaret sitenizdeki ürün bilgilerini yapılandırılmış bir XML feed aracılığıyla alır. Bu feed, ürünlerinizin özelliklerini, varyant bilgilerini, fiyatlarını ve stok durumlarını içerir.

Bu rehber, feed'in beklenen yapısını ve içermesi gereken alanları açıklar. Sample Feed XML sayfasında canlı bir örnek ve raw XML dosyası bulunmaktadır.

Sophi receives your product data through a structured XML feed. This guide explains the expected format, required fields, and common pitfalls. See Sample Feed XML and raw XML for a working example.

2. Feed Formatı / Feed Format

Format: RSS 2.0, Google Merchant Center uyumlu
Encoding: UTF-8
Namespace: xmlns:g="http://base.google.com/ns/1.0"
Kök yapı / Root structure:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Product Feed</title>
    <link>https://www.siteniz.com</link>
    <description>Ürün kataloğu</description>

    <item>
      <!-- Her item bir ürün VARYANTI temsil eder -->
    </item>

    <item>...</item>
  </channel>
</rss>

Her <item> bir ürün varyantını temsil eder (benzersiz beden + renk kombinasyonu). Aynı ürünün tüm varyantları aynı item_group_id değerini paylaşır.

3. Zorunlu Alanlar / Required Fields

Alan / Field	Açıklama	Format	Örnek
`g:id`	Varyanta özgü benzersiz ID (SKU veya barkod)	Metin	`BLZ-001-SYA-S`
`g:title`	Ürün başlığı	Metin	`Marka Desenli Bluz Siyah`
`g:description`	Detaylı ürün açıklaması (kumaş, kesim, stil)	CDATA metin	`Desenli bluz. %85 polyester...`
`g:link`	Ürün sayfası URL	URL	`https://www.site.com/urun-p-123`
`g:image_link`	Ana ürün görseli	URL	`https://cdn.site.com/img/01.jpg`
`g:additional_image_link`	Ek görseller (her görsel için ayrı etiket)	URL	`https://cdn.site.com/img/02.jpg`
`g:availability`	Stok durumu	Sabit değer	`in_stock`
`g:brand`	Marka adı	Metin	`VAKKO`
`g:color`	Bu varyantın rengi	Metin	`Siyah`
`g:condition`	Ürün durumu	Sabit değer	`new`
`g:gender`	Cinsiyet	Sabit değer	`female`
`g:gtin`	Barkod (GTIN / EAN)	13 haneli sayı	`8680000000001`
`g:item_group_id`	Ürün grubu ID (tüm varyantlar için aynı)	Metin	`BLZ-001`
`g:price`	Liste fiyatı	`0.00 TRY`	`1990.00 TRY`
`g:sale_price`	İndirimli fiyat (indirim yoksa price ile aynı)	`0.00 TRY`	`1490.00 TRY`
`g:product_type`	Kategori yolu	CDATA metin	`Kadın > Giyim > Bluz`
`g:size`	Bu varyantın bedeni	Metin	`S`, `M`, `38`, `39`

Sabit değer seçenekleri / Allowed tokens:

Alan	Geçerli değerler
`g:availability`	`in_stock` \| `out_of_stock` \| `preorder` \| `backorder`
`g:condition`	`new` \| `refurbished` \| `used`
`g:gender`	`male` \| `female` \| `unisex`

4. Detaylı Alanlar / Detailed Fields

`g:material` - Malzeme Bileşimi

Kumaş veya malzeme bileşimini yüzde oranlarıyla belirtin.

<g:material>%85 Polyester, %10 Elastan, %5 Metalik Elyaf</g:material>

Birden fazla malzeme bileşeni varsa, tek bir etiket içinde virgül ile ayırabilir veya her biri için ayrı etiket kullanabilirsiniz:

<!-- Tek etikette -->
<g:material>%85 Polyester, %10 Elastan, %5 Metalik Elyaf</g:material>

<!-- Veya ayrı etiketlerde -->
<g:material>%85 Polyester</g:material>
<g:material>%10 Elastan</g:material>
<g:material>%5 Metalik Elyaf</g:material>

`g:product_detail` - Ürün Özellikleri

Yapılandırılmış ürün özelliklerini aktarmak için kullanılır. Her product_detail bloğu üç alan içerir:

<g:product_detail>
  <g:section_name>Bölüm Adı</g:section_name>
  <g:attribute_name>Özellik Adı</g:attribute_name>
  <g:attribute_value>Değer</g:attribute_value>
</g:product_detail>

Bir ürün için istediğiniz kadar product_detail bloğu ekleyebilirsiniz. Sisteminizde bulunan TÜM ürün özelliklerini paylaşın - ne kadar fazla veri olursa müşteri deneyimi o kadar iyi olur.

5. Varyant Yönetimi / Variant Management

Bu, feed'in en kritik bölümüdür. Varyant gruplama doğru yapılmazsa, Sophi ürünleri doğru şekilde eşleştiremez.

Temel Kural

Bir item_group_id = Bir ürün. Aynı ürünün tüm beden ve renk kombinasyonları aynı item_group_id değerini paylaşır.

Örnek: Doğru Gruplama

Bir bluzun 2 rengi (Siyah, Beyaz) ve 3 bedeni (S, M, L) varsa, toplam 6 varyant olmalıdır ve hepsi aynı item_group_id'yi paylaşır:

item_group_id = "BLZ-001"
├── BLZ-001-SYA-S   (Siyah, S)
├── BLZ-001-SYA-M   (Siyah, M)
├── BLZ-001-SYA-L   (Siyah, L)
├── BLZ-001-BYZ-S   (Beyaz, S)
├── BLZ-001-BYZ-M   (Beyaz, M)
└── BLZ-001-BYZ-L   (Beyaz, L)

Farklı bir ürün (örneğin bir sneaker) farklı bir item_group_id alır:

item_group_id = "SNK-042"
├── SNK-042-SYA-39  (Siyah, 39)
├── SNK-042-SYA-40  (Siyah, 40)
└── SNK-042-SYA-41  (Siyah, 41)

YANLIŞ: Renkleri Ayrı Grup Yapmak

Aşağıdaki yapı HATALIDIR. Her renk için farklı item_group_id kullanmayın:

YANLIŞ:
item_group_id = "BLZ-001-SYA"     <-- Siyah için ayrı grup
├── BLZ-001-SYA-S
├── BLZ-001-SYA-M
└── BLZ-001-SYA-L

item_group_id = "BLZ-001-BYZ"     <-- Beyaz için ayrı grup
├── BLZ-001-BYZ-S
├── BLZ-001-BYZ-M
└── BLZ-001-BYZ-L

Bu yapıda Sophi aynı ürünün iki farklı rengi olduğunu anlayamaz ve bunları iki ayrı ürün olarak görür.

DOĞRU: Tüm Renkler ve Bedenler Tek Grupta

DOĞRU:
item_group_id = "BLZ-001"          <-- Tek grup, tüm varyantlar içinde
├── BLZ-001-SYA-S   (color=Siyah, size=S)
├── BLZ-001-SYA-M   (color=Siyah, size=M)
├── BLZ-001-SYA-L   (color=Siyah, size=L)
├── BLZ-001-BYZ-S   (color=Beyaz, size=S)
├── BLZ-001-BYZ-M   (color=Beyaz, size=M)
└── BLZ-001-BYZ-L   (color=Beyaz, size=L)

Varyantlar Arası Farklar

Aynı item_group_id'ye sahip varyantlar arasında değişen ve değişmeyen alanlar:

Varyantlar arası DEĞİŞEN	Varyantlar arası AYNI KALAN
`g:id` (benzersiz SKU)	`g:item_group_id`
`g:color`	`g:brand`
`g:size`	`g:product_type`
`g:gtin` (benzersiz barkod)	`g:material`
`g:image_link` (renk bazlı)	`g:product_detail` blokları
`g:availability` (stok bazlı)	`g:gender`
`g:price` / `g:sale_price` (nadiren)	`g:condition`

6. Ürün Özellikleri / Product Attributes

product_detail blokları ile yapılandırılmış ürün özelliklerini aktarabilirsiniz. Aşağıda kategori bazında örnek özellikler verilmiştir.

Giyim / Apparel

section_name	attribute_name	Örnek değerler
Ürün Özellikleri	Ürün Grubu	Bluz, Gömlek, Pantolon, Ceket, Elbise
Ürün Özellikleri	Kumaş Tipi	Örme, Dokuma, Denim, Triko
Ürün Özellikleri	Kesim Tipi	Standart Kalıp, Slim Fit, Oversize, Regular Fit
Ürün Özellikleri	Yaka Tipi	O Yaka, V Yaka, Polo Yaka, Gömlek Yaka
Ürün Özellikleri	Kol Tipi	Kısa Kollu, Uzun Kollu, Kolsuz, 3/4 Kollu
Ürün Özellikleri	Desen	Düz, Desenli, Çizgili, Kareli, Çiçek Desenli
Ürün Özellikleri	Boy	Mini, Midi, Maxi
Ürün Özellikleri	Astar Bilgisi	Astarlı, Astarsız
Ürün Özellikleri	Cep Bilgisi	Cepli, Cepsiz
Ürün Özellikleri	Kapama Tipi	Düğmeli, Fermuar, Bağcıklı
Ürün Özellikleri	Yaşam Tarzı	Casual, Spor, Klasik, Özel Gün

Ayakkabı / Shoes

section_name	attribute_name	Örnek değerler
Ürün Özellikleri	Ürün Grubu	Sneaker, Bot, Sandalet, Topuklu
Ürün Özellikleri	Dış Materyal	Doğal Deri, Suni Deri, Tekstil, Süet
Ürün Özellikleri	İç Materyal	Tekstil, Deri, Suni Deri
Ürün Özellikleri	Taban Tipi	Kauçuk, EVA, Deri, TPU
Ürün Özellikleri	Topuk Yüksekliği	3 cm, 5 cm, 7 cm, 10 cm
Ürün Özellikleri	Kapama Tipi	Bağcıklı, Fermuar, Tokalı, Slip-on

Ev & Yaşam / Home & Living

section_name	attribute_name	Örnek değerler
Ürün Özellikleri	Ürün Grubu	Nevresim, Havlu, Bardak, Tabak
Ürün Özellikleri	Boyut	50x70 cm, 200x220 cm, 250 ml
Ürün Özellikleri	Malzeme	Pamuk, Porselen, Cam, Paslanmaz Çelik
Ürün Özellikleri	İplik Sayısı	300 TC, 400 TC

Kozmetik / Cosmetics

section_name	attribute_name	Örnek değerler
Ürün Özellikleri	Ürün Grubu	Parfüm, Ruj, Fondöten, Serum
Ürün Özellikleri	Hacim	50 ml, 100 ml, 200 ml
Ürün Özellikleri	Cilt Tipi	Normal, Kuru, Yağlı, Karma
Ürün Özellikleri	Koku Ailesi	Çiçeksi, Odunsu, Oryantal

Genel / Common to All

section_name	attribute_name	Açıklama
Ürün Özellikleri	Ürün Grubu	Her kategoride bulunmalı - ürün tipini tanımlar
Ürün Özellikleri	Menşei	Üretim ülkesi (Türkiye, İtalya, vb.)
Ürün Özellikleri	Sezon	Koleksiyon sezonu (SS 2025, FW 2025, vb.)
Ürün Özellikleri	Koleksiyon	Koleksiyon adı

ÖNEMLİ: Yukarıdaki listeler örnektir. Sisteminizde bulunan her özellik için bir product_detail bloğu ekleyin. Sınır yoktur.

7. Bakım Bilgileri / Care Instructions

Bakım talimatlarını product_detail blokları ile section_name = "Bakım" altında aktarın.

<g:product_detail>
  <g:section_name>Bakım</g:section_name>
  <g:attribute_name>Yıkama</g:attribute_name>
  <g:attribute_value>30 derecede makinede yıkanabilir</g:attribute_value>
</g:product_detail>

<g:product_detail>
  <g:section_name>Bakım</g:section_name>
  <g:attribute_name>Ağartma</g:attribute_name>
  <g:attribute_value>Ağartıcı kullanılmaz</g:attribute_value>
</g:product_detail>

<g:product_detail>
  <g:section_name>Bakım</g:section_name>
  <g:attribute_name>Ütüleme</g:attribute_name>
  <g:attribute_value>Düşük ısıda ütülenebilir</g:attribute_value>
</g:product_detail>

<g:product_detail>
  <g:section_name>Bakım</g:section_name>
  <g:attribute_name>Kuru Temizleme</g:attribute_name>
  <g:attribute_value>Kuru temizleme yapılabilir (P)</g:attribute_value>
</g:product_detail>

<g:product_detail>
  <g:section_name>Bakım</g:section_name>
  <g:attribute_name>Kurutma</g:attribute_name>
  <g:attribute_value>Tamburlu makinede kurutulmaz</g:attribute_value>
</g:product_detail>

Bakım alanları tekstil ürünlerinde (giyim, ev tekstili) özellikle önemlidir.

8. Fiyatlandırma / Pricing

Alan	Açıklama	Format	Örnek
`g:price`	Liste fiyatı (etiket fiyatı)	`0.00 TRY`	`1990.00 TRY`
`g:sale_price`	İndirimli fiyat	`0.00 TRY`	`1490.00 TRY`

Fiyat formatı: rakam (2 ondalık) + boşluk + para birimi kodu
İndirim yoksa sale_price değeri price ile aynı olmalıdır
Her iki alan da zorunludur

<!-- İndirimli ürün -->
<g:price>1990.00 TRY</g:price>
<g:sale_price>1490.00 TRY</g:sale_price>

<!-- İndirimsiz ürün -->
<g:price>1990.00 TRY</g:price>
<g:sale_price>1990.00 TRY</g:sale_price>

9. Stok Durumu / Availability

g:availability alanı aşağıdaki değerlerden birini tam olarak içermelidir:

Değer	Anlamı
`in_stock`	Stokta var, sevkiyata hazır
`out_of_stock`	Stokta yok
`preorder`	Ön sipariş alınabilir
`backorder`	Sipariş alınabilir, stok bekleniyor

<g:availability>in_stock</g:availability>

Not: Stokta olmayan ürünleri (out_of_stock) feed'e dahil etmek zorunlu değildir, ancak dahil edilmeleri tercih edilir.

10. Sık Yapılan Hatalar / Common Mistakes

Aşağıdaki hatalar gerçek feed analizlerinde tespit edilmiştir. Lütfen feed'inizi oluşturmadan önce bu listeyi kontrol edin.

10.1 Renklerin Ayrı Grup Olarak Gönderilmesi

En sık karşılaşılan hata. Her renk için farklı item_group_id kullanılması, Sophi'nin aynı ürünün farklı renklerini birleştirmesini engeller.

<!-- YANLIŞ: Her renk farklı item_group_id -->
<g:item_group_id>ABC-123-SIYAH</g:item_group_id>  <!-- Siyah grubu -->
<g:item_group_id>ABC-123-BEYAZ</g:item_group_id>  <!-- Beyaz grubu -->

<!-- DOĞRU: Tüm renkler ve bedenler aynı item_group_id -->
<g:item_group_id>ABC-123</g:item_group_id>         <!-- Tek grup -->

10.2 `color` ve `size` Etiketlerinin Eksik Olması

Her varyant için g:color ve g:size etiketleri ayrı alanlar olarak bulunmalıdır. Renk veya beden bilgisini sadece başlıkta veya açıklamada belirtmek yeterli değildir.

<!-- YANLIŞ: Renk sadece başlıkta -->
<g:title>Marka Bluz Siyah S</g:title>
<!-- g:color ve g:size etiketi yok! -->

<!-- DOĞRU: Ayrı etiketler -->
<g:title>Marka Bluz Siyah</g:title>
<g:color>Siyah</g:color>
<g:size>S</g:size>

10.3 Açıklamalarda HTML Kullanımı

g:description ve diğer alanlarda HTML etiketleri (<b>, <br>, <div>, inline CSS vb.) olmamalıdır. Düz metin veya CDATA kullanın.

<!-- YANLIŞ -->
<g:description><b>Güzel</b> bir <br/>ürün</g:description>

<!-- DOĞRU -->
<g:description><![CDATA[Güzel bir ürün. Detaylı açıklama burada yer alır.]]></g:description>

10.4 `product_detail` Bloklarının Eksik Olması

Sisteminizde ürün özellikleri (kumaş tipi, kesim, yaka, desen vb.) mevcut olduğu halde bunların product_detail blokları ile aktarılmaması. Bu verileri açıklama alanına gömmeyin, yapılandırılmış olarak gönderin.

<!-- YANLIŞ: Özellikler sadece açıklamada -->
<g:description>Örme kumaş, O yaka, kısa kollu bluz</g:description>

<!-- DOĞRU: Yapılandırılmış product_detail blokları -->
<g:product_detail>
  <g:section_name>Ürün Özellikleri</g:section_name>
  <g:attribute_name>Kumaş Tipi</g:attribute_name>
  <g:attribute_value>Örme</g:attribute_value>
</g:product_detail>
<g:product_detail>
  <g:section_name>Ürün Özellikleri</g:section_name>
  <g:attribute_name>Yaka Tipi</g:attribute_name>
  <g:attribute_value>O Yaka</g:attribute_value>
</g:product_detail>

10.5 Malzeme Bilgisinin Eksik Olması

g:material alanı özellikle tekstil ve deri ürünlerinde kritik öneme sahiptir. Malzeme bileşimini yüzde oranlarıyla aktarın.

<!-- YANLIŞ: Malzeme bilgisi yok -->
<!-- (g:material etiketi tamamen eksik) -->

<!-- DOĞRU -->
<g:material>%85 Polyester, %10 Elastan, %5 Metalik Elyaf</g:material>

10.6 Belirsiz Beden Değerleri

"40" gibi bir beden değeri giysi, ayakkabı veya yaş grubu olabilir. Mümkünse beden sistemi hakkında ek bilgi verin veya product_type kategorisinin beden tipini anlaşılır kılmasını sağlayın.

10.7 Boş veya Placeholder Değerler

Gerçek veri olmayan placeholder değerlerden kaçının: - %100 Diğer (bilinmeyen malzeme yerine) - Çok Renkli (gerçek renk yerine) - Boş etiketler (<g:color></g:color>)

11. Dosyalar / Files

Bu klasördeki dosyalar:

Dosya	Açıklama
`feed-guide.md`	Bu rehber dosyası
sample-feed.md	Dokümantasyon içinde görüntülenebilir XML örneği
sample_feed.xml	Raw örnek XML feed (2 ürün, 4 varyant, tüm alanlar ve açıklamalar dahil)

sample_feed.xml dosyasında: - Ürün 1 (Bluz, item_group_id = BLZ-001): 3 varyant (Siyah S, Siyah M, Beyaz S) - çoklu varyant örneği - Ürün 2 (Sneaker, item_group_id = SNK-042): 1 varyant (Siyah 39) - farklı ürün örneği, ayakkabıya özel özelliklerle

Bu iki ürün birlikte, item_group_id'nin nasıl çalıştığını gösterir: aynı ürünün varyantları aynı grupta, farklı ürünler farklı gruplarda.