Yer Tutucular
Her yer tutucu, örnek çıktısı ve hangi yüzeyde çalıştığı
Yer tutucu (token), içeriğinizin içine yazdığınız ve gösterim anında ürünün gerçek değerine dönüşen işarettir: ${title} yazarsınız, ziyaretçi ürünün adını görür. Bu sayfa panelin her yerinde geçerli olan yer tutucuları, ne basacaklarını ve hangi yüzeyde çalışıp hangisinde çalışmadığını listeler.
Panelde nerede
Yer tutucular iki yerde yazılır ve seçilir:
- İçerik blokları: Content Blocks → New block, Product tokens (Ürün alanları) kutusu. Her yer tutucu bir etiket olarak listelenir.
- Kod düzenleyiciler (ürün kartı kodu, Kütüphane): düzenleyicide yazarken öneri listesi çıkar; Kütüphane'de Dynamic fields (Dinamik alanlar) kutusundan tıklayarak imlecin olduğu yere eklersiniz.
Yazım
İki yazım da aynı işi yapar: ${title} ve {{title}} (süslü parantezin içinde boşluk olabilir). Değer her zaman HTML'e güvenli yerleştirilir: üründe < ya da & gibi karakterler varsa kaçırılır, sayfaya kod giremez. Değeri olmayan yer tutucu boş basılır; ziyaretçi hiçbir zaman ${brand} yazısını görmez.
İçerik bloğu yer tutucuları
Örnek ürün: Kırmızı Keten Gömlek, marka Ardisa, satış fiyatı 899,90, liste fiyatı 1199,90, para birimi TRY.
| Yer tutucu | Ne basar | Örnek çıktı | Boş kalırsa |
|---|---|---|---|
${code} | Ürünün katalogdaki ürün kodu (item_code) | 904236 | Hiçbir zaman boş değil |
${title} | Ürün adı | Kırmızı Keten Gömlek | Hiçbir zaman boş değil |
${brand} | Marka | Ardisa | Besleme markayı taşımıyorsa boş |
${price} | Satış fiyatı, ham sayı, para birimi yok | 899.9 | Hiçbir zaman boş değil |
${originalPrice} | Liste fiyatı, ham sayı | 1199.9 | Besleme liste fiyatı taşımıyorsa boş |
${currency} | Para birimi kodu | TRY | Ürün ve kanal para birimi yoksa varsayılan |
${formattedPrice} | Satış fiyatı para birimiyle biçimlenmiş | ₺899,90 (biçim ziyaretçinin tarayıcısına göre) | Para birimi tanınmıyorsa boş |
${url} | Ürün sayfası adresi | https://magaza.com/gomlek | Besleme adres taşımıyorsa boş |
${imageUrl} | Ürün görseli adresi | https://cdn.magaza.com/g1.jpg | Besleme görsel taşımıyorsa boş |
${inStock} | Stokta mı | true ya da false | Hiçbir zaman boş değil |
${stock} | Stok adedi | 12 | Stok adedi bilinmiyorsa boş |
${categories} | Kategoriler, beslemedeki metin | Giyim > Gömlek | Besleme kategori taşımıyorsa boş |
${attr.alan_adı} | Beslemenizin kendi alanı | 2 yıl | Üründe o alan yoksa boş |
Fiyat yer tutucuları beslemeden gelir
${price}, ${originalPrice} ve ${formattedPrice} ürün beslemenizden okunur. Besleme senkronizasyon aralığı varsayılan olarak 180 dakikadır (Product Feeds ekranından değişir), yani bu değerler temanızın gösterdiği canlı fiyatın bu kadar gerisinde kalabilir. Aynı sayfada iki farklı fiyat görünmesini istemiyorsanız fiyat yer tutucularını kullanmayın.
Tarayıcıda çizilen içerikte ${formattedPrice} ziyaretçinin tarayıcı diline göre biçimlenir; ürün kartlarındaki fiyatla aynı görünür. Sunucu taraflı render çıktısında ise biçim API sunucusunun yerel ayarına göredir; kesin bir biçim gerekiyorsa ${price} ile kendi biçimlendirmenizi yazın.
${attr.alan_adı} yer tutucusunun kuralları, alan adı sadeleştirme ve sınırlar için: Ürün Özellikleri. Bu yer tutucuları yalnızca listelenenler ve attr. ile başlayanlardır; ${name} ya da ${sku} bir içerik bloğunda çalışmaz ve olduğu gibi kalır.
Ürün kartı yer tutucuları
Özel HTML yazılan ürün kartında (Product Cards → Custom Code → HTML) kartın kendi yer tutucuları geçerlidir. Bunlar içerik bloğununkilerden farklıdır (${name} kartta çalışır, blokta çalışmaz). Tam liste: Kart Alanları ve Özel Kart Oluşturma.
Nerede çalışır, nerede çalışmaz
| Yüzey | Yer tutucu doldurulur mu | Ne yazarsınız |
|---|---|---|
| İçerik bloğu (kod sekmesi, tasarımcı) | Evet, sayfadaki ürünün değerleriyle | ${title}, ${attr.garanti} |
| Ürün kartı özel HTML | Evet, kartın çizildiği ürünün değerleriyle | ${name}, ${formattedPrice} |
| Ürün kartı tasarımcısı | Yer tutucu yok; öğeyi bir ürün alanına bağlarsınız | Öğe ayarlarında Product field |
| Blok tasarımcısı metin öğesi | Yer tutucu yok; öğeyi bir ürün alanına bağlarsınız | Product field listesi |
| Kampanya alanları (başlık, metin) | Ayrı bir sözdizimiyle, yalnızca ürün sayfasında | {product.price}. Bkz. Koşullu İçerik |
| Kampanya özel HTML / JavaScript | Hayır, düz metin olarak görünür | Değeri sayfadan JavaScript ile okuyun |
| Sayfa deneyi eylemleri | Hayır, düz metin olarak görünür | Değeri sayfadan JavaScript ile okuyun |
| Kütüphane şablonu | Yüzeyine göre: ürün kartı ve içerik bloğunda evet, kampanya ve sayfa deneyinde hayır | Kütüphane Yüzeyleri |
Kampanyada kart ya da blok şablonu kullanmayın
Ürün kartı ya da içerik bloğu için yazılmış bir şablonu kampanyaya uygularsanız ${price} gibi yer tutucular mağazada düz metin olarak görünür. Kütüphane bunu uygulamadan önce söyler.
Sık yapılan hatalar
- Yanlış yüzeyin adı. İçerik bloğunda
${name}yazmak: bloğun alanı${title}'dır. attr.öneki unutmak.${garanti_suresi}çalışmaz,${attr.garanti_suresi}yazın.- Besleme alanı yok. Beslemede olmayan alan boş basılır; kural doğru olsa bile kutu boş görünür. Önizlemede Resolved feed attributes listesine bakın.
- Sayfa deneyinde yer tutucu. Sayfa deneyi eylemleri hiçbir ürün alanını doldurmaz.
Son güncelleme: 10 Ekim 2026