Alan 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

Katalog → Ürün Beslemesi (Catalog → Product Feed) → Configuration → Field Mapping (Alan Eşleme). Sayfanın en altındaki 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. Her kutu en fazla 200 karakter alır. Eşleştirmeyi Save Mapping (Eşlemeyi Kaydet) kaydeder, Clear Mapping (Eşlemeyi Temizle) tüm kutuları boşaltır. Ekran yalnızca admin rolünün yazabildiği bir ekrandır; kataloğu başka bir kanaldan okuyan bir kanalda salt okunurdur (Paylaşılan Katalog).

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.

Beslemenizde ne olduğunu görün

Tablonun üstündeki Fields in your feed (Beslemedeki alanlar) listesi, beslemenizin gerçekten taşıdığı yolları örnek değerleriyle gösterir. Liste, son senkronizasyonda saklanan ilk 10 satırdan gelir; henüz senkronizasyon yoksa ya da beslemeyi yeniden okumak istiyorsanız Re-read the source (Kaynağı yeniden oku) düğmesi beslemeyi o an okur. Arama kutusu alan adında ve örnek değerde arar. Örnek değer işi yapan kısımdır: attributes.pre_ent_beden kimseye bir şey ifade etmez, "38" ile yan yana durduğunda ise ne olduğu bellidir.

Bir yola tıklamak onu son tıkladığınız eşleme kutusuna yazar; kutulara yazarken de aynı liste öneri olarak açılır.

Her yolun yanındaki yüzde (in 80% of rows), o yolun örnek satırların kaçında bulunduğunu söyler. Satırların yalnızca onda birinde görünen bir alan, göründüğü alan değildir. Beslemeye henüz hiç ulaşılmadıysa liste "There is no feed yet" der: önce bir adres kaydedin ya da dosya yükleyin.

Kaydetmeden önce önizleyin

Preview (Önizle), ekrandaki eşlemeyi — henüz kaydetmediğiniz hâliyle — senkronizasyonun kullandığı eşleyicinin aynısıyla saklanan örnek satırlarınız (en fazla 10) üzerinde çalıştırır. Tablo her alan için Source path (hangi yoldan okunduğu; kendiliğinden bulunduysa automatic), Filled (kaç satırda değer çıktığı) ve örnek Values gösterir; hiç değer çıkmayan alan Empty olarak işaretlenir. Zorunlu alanlar yıldızlıdır. Mapping preview yalnızca ilk 10 satırı gördüğü için, yalnızca daha sonraki satırlarda boş olan bir alan orada görünmez.

Bunun önemi şudur: yanlış yazılmış bir alan adı sessizdir. Çözümlenemeyen bir yol, denk gelen bir varsayılan ada düşer; besleme senkronize olur, kalite puanı iyi görünür ve markası ile görseli olmayan ürünler yayınlanır. Önizleme bunu kaydetmeden önce gösterir. Önizleme ayrıca bu eşlemeyle düşecek satırları söyler ("This mapping would drop N row(s)" ve ilk nedeni): ürün kodu, başlık ya da fiyat okunamayan satırlar — bkz. Çalışma Geçmişi.

Önizlemede ayrıca beslemenizin taşıdığı özel alanlar listelenir — bunları zenginleştirme bloklarınızda ${attr.<ad>} olarak kullanabilirsiniz.

Hazır eşleme ile başlayın

Platformunuz listede varsa tek tek yazmanız gerekmez. Ready-made mapping (Hazır eşleme) bölümünden platformunuzu seçip Apply (Uygula) 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
IdeaSoft (XML ürün export)	IdeaSoft XML ihracını kullanıyorsanız — bkz. IdeaSoft

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 var olan bir feed'e uygulanır: önce Feed URL sekmesinde bir adres kaydedin ya da bir dosya yükleyin. Uygulamak aynı zamanda Variant grouping modunu da preset'in modu yapar (dört hazır eşlemenin dördü de item_group_id modundadır). Eşleme bir sonraki 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
Product Code (Ürün Kodu)	id	Besleme satırının kendi kodu. Ürünün kimliği bu.	sku
Add-to-Cart Code (Sepete Ekleme Kodu)	cartCode	Mağazanızın sepetinin kabul ettiği kod	pk
Product Group Key (Ü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 Product Group Key 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.

Ü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.

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; toplam 26 satır vardır. Selwise'in kendiliğinden tanıdığı adlar için bkz. Otomatik Tanınan Alan Adları.

Identity (Kimlik)

Satır	Alan	Zorunlu
Product Code (Ürün Kodu)	id	Evet
SKU	sku	Hayır
Add-to-Cart Code (Sepete Ekleme Kodu)	cartCode	Hayır
Product Group Key (Ürün Grubu Anahtarı)	itemGroupId	Hayır

Content (İçerik)

Satır	Alan	Ne için
Title (Başlık)	title	Zorunlu. Kartta ve aramada
Description (Açıklama)	description	Aramada eşleşme
Short Description (Kısa Açıklama)	shortDescription	Kartta
Brand (Marka)	brand	Filtreleme

Price (Fiyat)

Satır	Alan	Ne için
Price (Fiyat)	price	Ödenecek tutar. Hiç yoksa 0 olur
Original Price (Liste fiyatı)	originalPrice	İndirim öncesi tutar; yoksa satış fiyatına eşitlenir
Discount Rate (İndirim oranı)	discountRate	Beslemenizin taşıdığı oran; aşağıya bakın
Currency (Para Birimi)	currency	ISO kodu

Media and links (Görsel ve bağlantılar)

Satır	Alan	Ne için
Image URL (Görsel)	imageUrl	Kart görseli
Additional images (Ek görseller)	additionalImages	Kart üzerine gelince geçilen ikinci görsel; en fazla 6 saklanır, ana görsel listeden çıkarılır
Product URL (Ürün Linki)	url	Karta tıklanınca gidilecek adres

Category (Kategori)

Satır	Alan	Ne için
Categories (Kategoriler)	categories	Kategori filtresi, benzer ürünler
Product Type (Ürün Tipi)	productType	Kategori hiyerarşisi metni
Category Hierarchy (Kategori Hiyerarşisi)	categoryHierarchy	Kategori ID hiyerarşisi

Stock (Stok)

Satır	Alan	Ne için
Stock Quantity (Stok Adedi)	stock	Stok filtresi
In Stock (Stokta)	inStock	Tükendi durumu

Option axes (Seçenek eksenleri)

Satır	Alan	Ne için
Size (Beden)	size	Kartın seçenek satırı
Colour (Renk)	color	Kartın seçenek satırı

Badges (Etiketler)

Satır	Alan
Rating (Puan)	rating
Review Count (Değerlendirme Sayısı)	reviewCount
Is New (Yeni Ürün)	isNew
Is Bestseller (Çok Satan)	isBestseller

variantCode, cartCode'un eski adıdır; tabloda görünmez ama eski bir eşleştirme onu taşıyorsa hâlâ okunur.

İç 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.

Liste fiyatı ve indirim oranı

Discount Rate satırı, beslemenizin taşıdığı oranı okur (discount_rate, discount ve discount_percent adları kendiliğinden tanınır; yüzde, 0–100 arasına kırpılır). Beslemeniz oran taşımıyorsa Selwise oranı fiyat çiftinden hesaplar: satış fiyatı liste fiyatından düşükse (liste − satış) / liste, tam sayıya yuvarlanır (799'dan 479'a düşen ürün %40). Beslemenin kendi oranı varsa o kullanılır. Oranı okuyan yüzeyler — İndirimdekiler stratejisi, kart rozeti ve arama sıralaması — bu değeri okur.

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 (Varyant gruplama) seçimi, grup anahtarının okunup okunmayacağını belirler: No grouping — each row stands alone, By group code — keep siblings resolvable ya da Variants nested inside the row (Shopify). Üç 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. By group code seçiliyken Product Group Key boşsa base_code, item_group_id, parent_sku ve group_id sırayla denenir.

Tanınmayan alan hatası ve uyarısı

Tablodaki satırlar dışında bir anahtar (örneğin eski bir name ya da oldPrice) eşleştirmede kalmışsa ekranda Unrecognised mapping fields (Tanınmayan eşleme alanları) uyarısı çıkar; bu anahtarlar etkisizdir ve kaydederken temizlenir. API doğrudan çağrılırsa aynı durum 400 döner ve geçerli alanların listesini yazar.

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, toplam 8.000 bayt. 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; mevcut katalog o ana kadar değişmez, kaydetmek ise besleme durumunu pending yapar. Hemen görmek istiyorsanız Sync Now ile eşitlemeyi elle başlatın (yalnızca URL ile beslenen feed'lerde; dosya ve API ile beslenen feed'de dosyayı yeniden yükleyin ya da yeniden gönderin).