Alan Eşleştirme
Feed alanlarını eşleştirme
Alan eşleştirme, beslemenizdeki alan adlarını Selwise'in okuduğu alanlara bağlar. Beslemeniz farklı adlar kullanıyorsa burada çözersiniz.
Panelde nerede
Product Feed → Field mapping. Tablo, Selwise'in okuduğu her alan için bir satır gösterir; sağdaki kutuya kendi beslemenizdeki alan adını yazarsınız. Kutular serbest metindir — panel beslemenizi açıp içindeki alan adlarını listelemez, alan adını beslemenizden siz bakarak yazarsınız.
Soldaki gri kod (id, cartCode, itemGroupId) Selwise'in alan adıdır;
bunlar değişmez. Sağa yazdığınız değer sizin beslemenizden gelir.
Tanınmayan bir alan adı artık sessizce kabul edilmiyor
Selwise'in okumadığı bir alana yazı yazarsanız kaydetme işlemi hata verir ve hangi alanın tanınmadığını söyler. Eskiden böyle bir kayıt kabul edilir, saklanır ve hiçbir şey tarafından okunmazdı — yazdığınız değerin hiçbir etkisi olmadığını gösteren tek belirti, çalışmayan bir özellikti.
Hazır eşleme ile başlayın
Platformunuz listede varsa tek tek yazmanız gerekmez. Ready-made mapping bölümünden platformunuzu seçip Apply deyin; tüm satırlar o platformun bilinen alan adlarıyla dolar, sonra istediğiniz satırı elle değiştirirsiniz.
| Hazır eşleme | Ne zaman |
|---|---|
| Akinon (Project Zero / PZ Next) | Beslemeyi mağaza ön yüzünün ürün yükünden alıyorsanız |
| Akinon Omnitron | Beslemeyi PIM/yönetim API'sinden alıyorsanız |
| Google Merchant Center | Zaten Shopping için yayınladığınız beslemeyi kullanıyorsanız |
Hazır eşleme değiştirir, birleştirmez: uygulandığında mevcut satırların tamamı silinip yerine gelenler yazılır. Yarım uygulanmış bir eşleme kimsenin hesabını veremediği bir durumdur, bu yüzden bilinçli olarak böyledir.
Hazır eşleme yeni eşitlemede geçerli olur; mevcut kataloğunuz o ana kadar değişmez.
Üç kod, üç ayrı alan
Bu bölüm eşleştirmenin en kritik yeridir. Bir üründe üç ayrı kod olabilir ve bunlar birbirinin yerine geçmez.
| Satır | Selwise alanı | Ne olduğu | Akinon'da |
|---|---|---|---|
| Ürün Kodu | id | Besleme satırının kendi kodu. Ürünün kimliği bu. | sku |
| Sepete Ekleme Kodu | cartCode | Mağazanızın sepetinin kabul ettiği kod | pk |
| Ürün Grubu Anahtarı | itemGroupId | Hangi ürünlerin kardeş olduğu | base_code |
base_code buraya yazılır — adı itemGroupId
En sık sorulan soru bu: "base_code'u nereye yazıyorum?" Cevap Ürün Grubu
Anahtarı satırı. Selwise alanın adını itemGroupId olarak tutar çünkü aynı
kavramın Google Merchant beslemelerindeki adı item_group_id, Akinon'daki adı
base_code; alan tek, karşılığı platforma göre değişir.
base_code'u Ürün Kodu satırına yazmayın. Grup, ürünün kimliği değildir:
yazdığınızda bir grubun tüm üyeleri tek ürüne iner ve geri kalanı başlığını,
adresini, açıklamasını ve arama karşılığını kaybeder. Ayrıntı için
Varyant Gruplama.
Bu satırı boş bırakırsanız Selwise sırayla base_code, item_group_id,
parent_sku ve group_id adlarını dener. Beslemeniz bu adlardan birini
kullanıyorsa eşleştirme yazmanız gerekmez.
Sepete ekleme kodu boş kalabilir
Çoğu altyapıda sepet, ürünün kendi koduyla çalışır ve bu satır boş kalır.
Akinon'da kalmaz: sepet uç noktası numerik pk ister ve sku'yu reddeder. Bu
satır boşsa kart doğru görünür, tıklanır, sonra sepete ekleme her seferinde
başarısız olur.
Besleme kalite puanı bu alanı denetlemez
Kalite puanı başlık, fiyat, görsel gibi alanların doluluğunu ölçer; sepete ekleme kodunu ölçmez. Yani eksik bir sepet kodu ile puan 100 görünebilir. Akinon kullanıyorsanız bu satırın dolu olduğunu gözünüzle doğrulayın.
Ürün kodu ile siparişleriniz aynı dili konuşmalı
Ürün kodu (id), siparişlerinizde gönderdiğiniz ürün kodu ile aynı olmalıdır.
Kod uyuşmazlığı sessizce çalışır ama yanlış
Beslemede 12345, siparişte PRD-12345 gönderiyorsanız hiçbir hata almazsınız —
ama hiçbir sipariş bir ürüne bağlanmaz. Ürün bazlı ciro raporları boş kalır,
"birlikte alınanlar" önerisi hiç çalışmaz. Kurulumda mutlaka kontrol edin.
Geçmiş veri aktarımı yapıyorsanız doğrulama adımı bu eşleşmeyi ölçer ve size oran verir — bkz. Doğrulama ve Uygulama.
Selwise'in okuduğu alanlar
Tablo panelde sekiz bölüme ayrılmıştır.
Kimlik
| Satır | Alan | Zorunlu |
|---|---|---|
| Ürün Kodu | id | Evet |
| SKU | sku | Hayır |
| Sepete Ekleme Kodu | cartCode | Hayır |
| Ürün Grubu Anahtarı | itemGroupId | Hayır |
İçerik
| Satır | Alan | Ne için |
|---|---|---|
| Başlık | title | Zorunlu. Kartta ve aramada |
| Açıklama | description | Aramada eşleşme |
| Kısa Açıklama | shortDescription | Kartta |
| Marka | brand | Filtreleme |
Fiyat
| Satır | Alan | Ne için |
|---|---|---|
| Fiyat | price | Ödenecek tutar |
| Liste Fiyatı | originalPrice | İndirim öncesi tutar |
| İndirim Oranı | discountRate | Beslemeniz taşıyorsa; taşımıyorsa hesaplanır |
| Para Birimi | currency | ISO kodu |
Görsel ve bağlantı
| Satır | Alan | Ne için |
|---|---|---|
| Görsel | imageUrl | Kart görseli |
| Ürün Linki | url | Karta tıklanınca gidilecek adres |
Kategori
| Satır | Alan | Ne için |
|---|---|---|
| Kategoriler | categories | Kategori filtresi, benzer ürünler |
| Ürün Tipi | productType | Kategori hiyerarşisi metni |
| Kategori Hiyerarşisi | categoryHierarchy | Kategori ID hiyerarşisi |
Stok
| Satır | Alan | Ne için |
|---|---|---|
| Stok Adedi | stock | Stok filtresi |
| Stokta | inStock | Tükendi durumu |
Seçenek eksenleri
| Satır | Alan | Ne için |
|---|---|---|
| Beden | size | Kartın seçenek satırı |
| Renk | color | Kartın seçenek satırı |
Etiketler
| Satır | Alan |
|---|---|
| Puan | rating |
| Değerlendirme Sayısı | reviewCount |
| Yeni Ürün | isNew |
| Çok Satan | isBestseller |
İç içe alanlar için nokta gösterimi
Beslemeniz JSON ise ve değer bir nesnenin içindeyse yolu nokta ile yazarsınız. Dizi elemanı için sıra numarası kullanılır (sıfırdan başlar):
Görsel → productimage_set.0.image
Marka → attributes_kwargs.integration_brand.label
Beden → attributes.pre_ent_beden
XML beslemelerde g: önekli etiketler (g:item_group_id gibi) öneksiz adla da
bulunur; item_group_id yazmanız yeterlidir.
İndirim oranı
İndirim oranını beslemenizde taşıyorsanız İndirim Oranı satırında belirtirsiniz. Taşımıyorsanız Selwise hesaplar, ama bunun için fiyat ve liste fiyatının ikisi de eşlenmiş olmalıdır. Yalnızca tek fiyat gönderiyorsanız oran sıfır kalır ve İndirimli Ürünler stratejisi hiç çalışmaz.
Google Merchant beslemelerinde bu iki alanın adı diğer platformların tersidir:
price liste fiyatı, sale_price ödenecek fiyattır. Hazır eşleme bunu doğru
kurar; elle yazıyorsanız ters kurmamaya dikkat edin — ters kurulduğunda kart
fiyat artışını indirim olarak gösterir.
Varyant gruplama
Eşleştirme tablosunun üstündeki Variant grouping seçimi, grup anahtarının okunup okunmayacağını belirler. Üç modun hiçbirinde besleme satırları birleştirilmez — ayrıntı için Varyant Gruplama.
Grup anahtarını kullanmak istiyorsanız By group code seçili olmalıdır. none
seçiliyken grup anahtarı hiç okunmaz; sonradan gerektiğinde modu değiştirip
yeniden eşitlemeniz gerekir.
Kendi alanlarınız
Beslemenizde Selwise'in bilmediği alanlar varsa (garanti_suresi, mensei,
kumas_turu) bunlar da otomatik olarak yakalanır ve ürün zenginleştirmede
kullanılabilir — bkz.
Ürün Özellikleri. Bunlar için
eşleştirme yazmanız gerekmez; eşleştirme tablosu yalnızca Selwise'in kendi
alanları içindir.
Bu yakalama sınırlıdır: ürün başına en fazla 40 alan, alan başına 500 karakter. Sınır bilinçlidir — beslemenizin tamamını taşımak kataloğu şişirir.
Kategori biçimi
Kategori alanı tek bir metin olarak okunur. Hiyerarşik kategoriler için ayırıcı kullanın:
Kadın > Ayakkabı > Bot
Benzer ürünler stratejisi bu metnin içindeki her parçaya bakar; hiyerarşi ne kadar zenginse öneriler o kadar isabetli olur.
Eşleştirme ne zaman geçerli olur
Kaydettiğiniz eşleştirme bir sonraki eşitlemede uygulanır. Hemen görmek istiyorsanız Sync Now ile eşitlemeyi elle başlatın.
Son güncelleme: 10 Eylül 2026