# Varyant Gruplama

Grup anahtarı ve kardeş ürünler
Kaynak: https://selwise.com/docs/product-feeds/variant-grouping

Ürün grubu, aynı ürünün farklı beden, renk veya ton seçeneklerinin hangi
ürünlerden oluştuğunu söyleyen bir anahtardır. Selwise'da **grup, ürünün
kimliği değildir** — bir besleme satırı her zaman bir üründür.

## Panelde nerede

**Katalog → Ürün Beslemesi** (Catalog → Product Feed) → **Configuration** → **Field Mapping** sekmesi → **Variant grouping** (Varyant gruplama) seçimi.

## Her satır bir ürün

Beslemenizdeki her satır kendi ürünü olur: kendi kodu, kendi başlığı, kendi
adresi, kendi fiyatı ve kendi stoğuyla. Aramada bulunur, önerilerde çıkar,
raporlarda kendi satırı vardır.

Bu, Akinon'un kendi modelidir. Akinon'da bir ürün zaten SKU seviyesindedir:
her tonun kendi `pk`'sı, kendi `sku`'su, kendi ürün sayfası ve kendi stoğu
vardır. Mağazanızın kendi liste sayfası da bu yüzden her tonu ayrı kart olarak
gösterir. `base_code` ise yalnızca hangi ürünlerin kardeş olduğunu söyler.

Örnek — yedi ton, yedi ürün, tek grup:

```
KS000000045002B   Coloured Balm - 02 Vanilla      grup: KS02001088
KS000000045003B   Coloured Balm - 03 Guava        grup: KS02001088
KS000000322006B   Coloured Balm - 06 Blackberry   grup: KS02001088
...
```

## Grup anahtarı ne işe yarar

Grup, kimlik değil sinyal olduğu için şunlarda kullanılır:

- **Öneri çeşitliliği.** Aynı ürünün yedi tonu birbirine en çok benzeyen
  ürünlerdir; grup bilinmezse sekiz kartlık bir şerit tek ürünün tonlarıyla
  dolar. Selwise şeritte grup başına bir kart gösterir, sonra şeridi
  kısaltmamak için kalanlardan tamamlar.
- **Ürün sayfasındaki şerit.** "Benzer Ürünler" şeridi, ziyaretçinin baktığı
  ürünün grubunu dışarıda bırakır: o seçenekler zaten ürün sayfasının kendi
  varyant satırında duruyor.
- **Kart üzerinde seçenek satırı.** Beslemeniz beden veya renk taşıyorsa kart
  bunları okuyabilir.

## Grup anahtarı nereden okunur

Google Merchant beslemelerinde `item_group_id`, Akinon yüklerinde `base_code`
alanı doğrudan tanınır. Beslemeniz başka bir ad kullanıyorsa alan
eşleştirmesinde **Product Group Key** (Ürün Grubu Anahtarı) satırında belirtirsiniz.

IdeaSoft XML beslemesinde grup alanı hiç yoktur. Orada varyant kendi satırıdır;
`label` alanı yalnızca varyant değerini ("M", "Yeşil"), `rootlabel` alanı ise
ebeveynin adını bu değerle birlikte taşır. Gruplama açıksa ve grup anahtarı
eşleştirilmemişse Selwise grubu ebeveyn adından çıkarır: `rootlabel` eksi
`label`, büyük-küçük harf ve boşluk farkı yok sayılarak. Aynı adı taşıyan
ebeveyn satırı da aynı gruba düşer.

## Modlar

| Mod (panel seçeneği) | Ne yapar |
|---|---|
| `none` — **No grouping — each row stands alone** | Satır tek başına durur; grup anahtarı okunmaz. |
| `item_group_id` — **By group code — keep siblings resolvable** | Grup anahtarı okunur ve kardeşler çözümlenebilir olur. |
| `nested` — **Variants nested inside the row (Shopify)** | Satırın kendi içindeki seçenek listesi okunur (Shopify biçimi). |

Mod, hazır bir eşleme uygulandığında preset'in modu olur (dört hazır eşlemenin dördü de `item_group_id`'dir). Sonradan değiştirmek yeni bir senkronizasyon gerektirir: grup anahtarı satır yazılırken yakalanır.

Üç modun hiçbirinde satırlar birleştirilmez. `nested`, seçeneğin gerçekten
kendi ürünü olmadığı tek biçimdir.

## Sepete ekleme

Her ürün kendi koduyla sepete eklenir — gruplama gerektirmez.

Bazı altyapılarda sepetin kabul ettiği kod, ürünün mağaza tarafındaki kodundan
farklıdır. Akinon'da sepet uç noktası ürünün numerik `pk`'sını ister ve `sku`'yu
reddeder. Bu yüzden Selwise ürün başına iki kod taşır: kimlik (`sku`) ve sepet
kodu (`pk`). Alan eşleştirmesinde **Add-to-Cart Code** (Sepete Ekleme Kodu) satırında hangi alanın
sepet kodu olduğunu belirtirsiniz; Akinon ve Google Merchant hazır
eşleştirmelerinde bu zaten doludur.

Beslemesi ayrı bir sepet kodu taşımayan altyapılarda ürünün kendi kodu sepet
kodudur ve bu satır boş kalır.

## Bedenli katalogda ne olur

Her beden kendi ürünü olarak katalogda durur ve kendi koduyla sepete eklenir.
Gruplama açıksa ve satırlar beden taşıyorsa (alan eşleştirmesindeki **Size** (Beden)
satırı ya da `size`, `beden` gibi bilinen alan adları), öneri ve arama
kartları aynı grubun **aynı rengindeki** bedenleri bir seçici olarak gösterir;
seçilen bedenin kendi sepet kodu sepete gider. Renk bilinmiyor ve grupta
birden fazla renk varsa seçici gösterilmez — başka bir rengin bedeni sepete
girmesin diye.

IdeaSoft beslemesinde beden ayrı bir alan değildir: varyant satırının
`label` değeri ("M", "42") seçenek olarak okunur.

Beslemeniz beden taşımıyorsa gösterilecek bir eksen yoktur ve kart seçenek
satırı çizmez; Akinon'da bu durumda bedenler, ziyaretçi sepete eklemeye
çalıştığında ürün sayfasından okunur — bkz. [Tamamlayıcı Ürünler → Sepete
ekleme ve beden](/docs/recommendations/complementary).