Otomatik Tanınan Alan Adları
Eşleştirme yazmadan okunan besleme alan adları
Beslemenizin alan adları Selwise'in bildiğiyle aynıysa ya da yaygın bir adsa hiçbir eşleştirme yazmanız gerekmez: Selwise her alan için bir ad listesini sırayla dener. Bu sayfa o listedir. Eşleştirme yazdığınızda neyin geçersiz kıldığını da burada görürsünüz.
Panelde nerede
Bu liste panelde görünmez; Catalog → Product Feed → Configuration → Field Mapping sekmesindeki Mapping preview (Eşleştirme önizlemesi) hangi alanın hangi yoldan doldurulduğunu ("Source path" sütunu; kendiliğinden bulunan alanlar için automatic) gösterir — bkz. Alan Eşleştirme.
Bir değer nasıl bulunur
Her alan için sırayla (aşağıdaki tablo, alanın kendi adından sonra denenen adları listeler):
- Eşleştirmeye yazdığınız yol (varsa). Nokta gösterimiyle iç içe de olabilir:
attributes_kwargs.integration_brand.label. - Alanın kendi adı (
price,title,imageUrl…), o da yol olarak okunur. - Tablodaki tanınan adlar, soldan sağa.
İlk bulunan değer kullanılır. Yazdığınız yol hiçbir satırda bir değer bulamazsa sessizce 2. ve 3. adıma düşülür: yanlış yazılmış bir yol hata vermez, Mapping preview'da Empty olarak görünür. Bu yüzden eşleştirmeyi kaydetmeden önce önizleyin.
Öneklenmiş XML etiketleri (g: ve c:) ve XML öznitelikleri öneksiz adla bulunur. Dizilerde numarasız yol ilk elemanı alır. Değer bir nesneyse label, value, #text, name, image, url anahtarları sırayla denenir.
Tanınan adlar
| Selwise alanı | Kendiliğinden denenen adlar (sırayla) |
|---|---|
id (ürün kodu) | sku, itemCode, item_code, product_id, pk, @_id (XML id özniteliği) |
sku | sku, itemCode, id |
title | name, product_name |
description | desc, summary, attributes.aciklama, attributes.ent_urun_icerigi |
shortDescription | short_description, short_desc |
price | sale_price, current_price — hiçbiri yoksa fiyat 0 sayılır; okunamayan bir değer (abc) ise satırı atlatır |
originalPrice | old_price, originalPrice, retail_price, regular_price, compare_at_price — yoksa satış fiyatına eşitlenir (indirimsiz görünür) |
discountRate | discount_rate, discount, discount_percent — yoksa fiyat ve liste fiyatından hesaplanır |
currency | currency, currency_type, g:currency, price_currency — yoksa kanalın para birimi |
imageUrl | image_url, image, thumbnail, image_link, productimage_set.0.image |
additionalImages | additional_image_link, g:additional_image_link, additional_images, images, image_links, productimage_set |
url | link, url, absolute_url, product_url, product_link |
categories | category |
productType | product_type, g:product_type |
categoryHierarchy | category_hierarchy, c:category_hierarchy |
brand | brand, manufacturer |
stock | quantity, inventory |
inStock | in_stock, availability (in stock, out_of_stock, preorder… yazımları ayırt edilmez); Akinon'da is_ready_to_basket false ise ürün stokta değil sayılır |
rating | average_rating, review_rating |
reviewCount | review_count, reviews |
isNew | is_new |
isBestseller | is_bestseller |
itemGroupId | base_code, item_group_id, g:item_group_id, parent_sku, group_id — yalnızca gruplama modu item_group_id iken okunur |
cartCode | yalnızca eşleştirmeye yazarsanız; yoksa ürünün kendi kodu sepet kodudur |
size, color | yalnızca eşleştirmeye yazarsanız ya da kartın bilinen size/beden, color/renk adları |
Eşleşme adları büyük/küçük harfe duyarlıdır (SKU ile sku farklıdır).
Değerler nasıl okunur
| Alan | Kural |
|---|---|
| Fiyat | 1.299,90 ve 1299.90 ikisi de doğru okunur: son nokta ya da virgül ondalık ayracıdır; arkasında tam üç hane varsa binlik ayracıdır. Para simgeleri ve boşluklar atılır |
| İndirim oranı | Binlik gruplaması yapılmaz, yüksek duyarlıklı değerler (10.02506256) okunur, 0–100 arasına kırpılır; negatif değer okunmaz sayılır |
| Stok adedi | Tam sayıya indirilir, negatifler 0 olur |
| Stokta mı | true, 1, yes, available, in stock, preorder, backorder → evet; false, 0, no, unavailable, discontinued, sold out, out of stock → hayır; başka bir değer ya da boşsa stok adedine bakılır (> 0) |
isNew, isBestseller | true, 1, yes, evet → evet; her şey hayır |
| Metinler | Başlık 500, kısa açıklama 1000, açıklama 5000, URL ve görsel 1000, kategori 500, ürün tipi 200, marka 255, kategori hiyerarşisi 255 karakterde kesilir; ürün kodu 100 |
| Ek görseller | En fazla 6; ana görsel listeden çıkarılır, tekrarlar atılır. Dizi, virgülle ayrılmış metin ya da nesne dizisi (image, src, url) olabilir |
| Para birimi | ISO koduna normalleştirilir; satırda yoksa kanalın para birimi |
Hangi satır atlanır
Bir satır şu durumlarda ürün olmaz ve Rows skipped sayılır:
- ürün kodu okunamadı (
idhiçbir yoldan bir değer bulamadı), - başlık okunamadı,
- fiyat var ama okunamayan ya da negatif bir değer,
- aynı kodu taşıyan daha önceki bir satır vardı (tekrarlayan kod).
Fiyat alanı hiç yoksa ürün atlanmaz, fiyatı 0 olur — bu, istemediğiniz bir sonuç olabilir; Mapping preview'daki price satırını kontrol edin.
Kendi alanlarınız (Selwise'in tanımadığı her şey) ayrıca toplanır: ürün başına en fazla 40 alan, alan başına 500 karakter, toplam 8.000 bayt. Bunları zenginleştirmede ${attr.<ad>} olarak kullanırsınız — bkz. Ürün Özellikleri.
Son güncelleme: 10 Ekim 2026