Kart Alanları

Kartta gösterilebilecek veri alanları. Hepsi ürün beslemenizden gelir; kartı tasarlarken bir metni, rozeti ya da koşulu bu alanlara bağlarsınız.

Panelde nerede

• Designer (Tasarımcı): bir Text öğesi seçin → Product field (Ürün alanı) listesi. Rozetin Product field kaynağı ve Visibility koşulları aynı listeyi kullanır.
• My own code (Kendi kodum): Slot bindings bölümünde bir token'ı bir ürün alanına bağlarken kullanılan Select field listesi; HTML editörünün yanındaki Token reference (Token başvurusu) paneli.

Kullanılabilir alanlar

Toplam 20 alan vardır. Tür, değerin koşullarda nasıl karşılaştırıldığını belirler.

Alan	Tür	Kaynak
id	metin	Ürün kimliği
title	metin	Ürün adı
description	metin	Tam açıklama
shortDescription	metin	Kısa açıklama
price	sayı	Satış fiyatı
originalPrice	sayı	Liste fiyatı
discountRate	sayı	Beslemedeki indirim oranı; besleme vermiyorsa iki fiyattan hesaplanır
imageUrl	metin	Ürün görseli
url	metin	Ürün sayfası adresi
categories	metin	Kategoriler
categoryHierarchy	metin	Kategori yolu
productType	metin	Ürün tipi
stock	sayı	Stok adedi
inStock	mantıksal	Stokta var mı
sku	metin	Stok kodu
brand	metin	Marka
rating	sayı	Puan
reviewCount	sayı	Değerlendirme sayısı
isNew	mantıksal	Yeni ürün mü
isBestseller	mantıksal	Çok satan mı

Bunların yanında beslemenizin özel alanları attr.alan_adı olarak listelenir (örneğin attr.garanti_suresi). Özel alanlar her zaman metindir. Alan adlarının nasıl oluştuğu için: Ürün Özellikleri. Liste yüklenemezse yalnızca standart alanlar sunulur.

Kart tasarımcısına özgü iki veri daha vardır ve alan listesinde yer almaz: Hover image öğesi için ürünün ek görselleri, Colours öğesi için aynı grup kodlu kardeş ürünler. Bkz. Kart Tasarımcısı.

Alan boşsa

Beslemenizde karşılığı olmayan bir alanı kartta kullanırsanız o öğe çizilmez: metin öğesi boş kalır ve ayrı bir satır bırakmaz; yedek metin (Fallback text) yazdıysanız o görünür. Özel HTML kartında ise token boş metne döner, öğe yerinde kalır; boş öğeyi CSS ile gizleyin (.marka:empty { display: none; }). Panelde Product Feeds ekranından birkaç ürüne bakıp hangi alanların dolu olduğunu görün.

En sık boş kalanlar: brand, rating, reviewCount, shortDescription. Bunlar çoğu beslemede bulunmaz.

Biçimlendirilmiş değerler

Fiyat alanlarının biçimlendirilmiş sürümleri de vardır: ham price değeri 299.9 iken biçimli sürüm para birimini ve ondalık ayırıcıyı içerir. Tasarımcıdaki Price öğesi bunu kendiliğinden yapar; özel HTML kartında ${formattedPrice} ve ${formattedOldPrice} kullanırsınız (bkz. Özel Kart Oluşturma).

Biçim, ziyaretçinin tarayıcısının dil ayarıyla kanalın para biriminden üretilir. Aynı fiyat bir ziyaretçide 299,90 ₺, başkasında TRY 299.90 görünebilir. Kartta fiyat gösterirken her zaman biçimli sürümü kullanın; ham sayı para birimi taşımaz.

Türetilmiş işaretler

isNew, isBestseller ve indirim işareti ham veriden türetilir ve rozet göstermek için kullanılır. Tasarımcıda isOnSale, hasDiscount, isOutOfStock gibi yedi hazır işaret ayrıca koşullarda kullanılabilir. Bkz. Rozetler.

Alan sıralaması

Tasarımcıda sıra, katman ağacındaki sıradır: öğeleri yukarı aşağı taşırsınız ya da başka bir kapsayıcıya sürüklersiniz. Tipik sıra: görsel alanı (üstünde rozetler) → marka → ad → fiyat → sepete ekle. Tasarımcıdan önce yapılmış eski kartlarda alanlar satır sırasıyla çizilir.