Kütüphaneye Genel Bakış
Şablon oluşturma, editörden kaydetme ve uygulama
Kütüphane, sık kullandığınız HTML, CSS ve JavaScript kodunu şablon olarak sakladığınız yerdir. Bir kez yazarsınız; kampanya, ürün kartı, içerik bloğu ve sayfa deneyi editörlerinden tek tıkla uygularsınız.
Panelde nerede
Sol menüde Tasarım → Kütüphane (Design → Library), adres /dashboard/library. Her kod editörünün üstündeki Templates (Şablonlar) düğmesi aynı kütüphaneyi açar.
Kütüphane hesabınızındır: bir kanalda kaydettiğiniz şablon hesabınızın her kanalının editörlerinde görünür. Kütüphane ekranı yine de bir kanal üzerinden açılır, bu yüzden üst çubukta bir kanal seçili olmalıdır. Kanal türünün kullanamayacağı şablonlar o kanalın listesinde gösterilmez; örneğin bir uygulama kanalı, yalnızca web kanallarına yazılmış şablonları görmez. Kütüphane bir modül gerektirmez, her hesapta vardır; yalnızca JavaScript içeren şablon Custom Code modülüne bağlıdır (aşağıda).
Kütüphane ekranı
Şablonlar kartlar hâlinde listelenir: üstte şablonun küçük bir önizlemesi (yalnızca CSS ya da JavaScript içeren şablonda kodun ilk satırları), altında ad, açıklama, yüzey ve içerdiği parçalar (HTML, CSS, JS). Arama ad ve açıklamada yapılır; All ve dört yüzey (Campaign, Product card, Content block, Page experiment) süzgeçleri vardır. Hesabınızın birden çok kanalı varsa kartın altında şablonun hangi kanalda yapıldığı yazar (Made in satırı); o kanal kalıcı olarak silinmişse "Kaldırılmış bir kanalda yapıldı" yazar. Tek kanallı hesapta bu satır görünmez. Ekranın üstündeki not da yalnızca çok kanallı hesapta çıkar. Karta tıklayınca düzenleme ekranı açılır; kartın menüsünde Duplicate (Kopyasını oluştur) ve Delete (Sil) bulunur. Kopya, adın sonuna "(copy)" eklenmiş bir adla oluşur; bu ad alınmışsa sayı eklenir. Hesapta iki kayıt aynı adı taşıyamaz (409); ad, kanala göre değil hesaba göre benzersizdir.
Yüzeyler
Her şablon bir yüzey için yazılır. Yüzey, şablonun hangi parçaları taşıyabileceğini ve ürün alanlarının doldurulup doldurulmayacağını belirler.
| Yüzey | Taşıdığı parçalar | Ürün alanları |
|---|---|---|
| Campaign (Kampanya) | HTML, CSS, JavaScript | Doldurulmaz |
| Product card (Ürün kartı) | HTML, CSS, JavaScript | Kart alanları doldurulur (örneğin ${name}) |
| Content block (İçerik bloğu) | HTML, CSS | Ürün alanları doldurulur (örneğin ${brand}) |
| Page experiment (Sayfa deneyi) | HTML, CSS, JavaScript | Doldurulmaz |
İçerik bloğu JavaScript çalıştırmadığı için içerik bloğu şablonunda JavaScript sekmesi yoktur. Yüzeylerin güvenlik temizleyicileri, doldurulan alanlar ve hangi etiketlerin silindiği için: Kütüphane Yüzeyleri.
Şablon oluşturma
- New template (Yeni şablon) düğmesine basın ve yüzeyi seçin (Which surface is this template for?). Seçim bir kez yapılır; sonraki adımda yüzey özet olarak görünür ve Change ile geri dönebilirsiniz.
- Template name (ad, en fazla 150 karakter) ve isteğe bağlı Description (açıklama, en fazla 500 karakter) yazın. Ad, hesabınızdaki şablonlar arasında benzersiz olmalıdır.
- Kodu HTML, CSS ve JavaScript sekmelerine yazın ya da Start from a ready-made template (Hazır şablonla başla) satırından birini seçip düzenleyin. Hazır şablon seçmek editördeki kodun yerine geçer.
- Sağdaki önizlemeyi masaüstü ve mobil genişlikte kontrol edin, sonra Save (Kaydet) düğmesine basın.
Kod uzunluğu parça başına 100.000 karakterle sınırlıdır; aşarsanız hangi parçanın kaç karakter olduğu yazılır. En az bir parçada kod olmalıdır. Düzenleme ekranında yüzeyi değiştirebilirsiniz; yeni yüzeyin taşımadığı parçalar kaydederken düşer.
Önizleme, şablonu seçtiğiniz yüzeyin temizleyicisinden geçirir ve kanalınızın marka renklerini kullanır. Örneğin içerik bloğu ve sayfa deneyi satır içi stili, formu, düğmeyi ve SVG'yi mağazada da siler; önizlemede de bunları görmezsiniz. Önizlemede ürün alanları doldurulmaz ve JavaScript çalışmaz.
Hazır şablonlar
Selwise altı hazır şablon sunar (kendi dilinizde): Announcement bar (duyuru şeridi), Shipping info (kargo bilgisi), Coupon card (kupon kartı), Feature list (özellik listesi), Trust badges (güven rozetleri) ve Brand note (marka notu). Çoğu kampanya, içerik bloğu ve sayfa deneyi için yazılmıştır; kupon kartı yalnızca kampanya ve sayfa deneyi, marka notu yalnızca içerik bloğu içindir. Ürün kartı yüzeyi için hazır şablon yoktur. Hepsi en katı temizleyiciye uygun yazılmıştır ve marka değişkenlerini okur.
Dinamik alanlar
Kod editörünün altındaki Dynamic fields (Dinamik alanlar) kutusu, seçtiğiniz yüzeyde hangi alanların doldurulduğunu ve her birinin ne tuttuğunu listeler. Bir alana tıkladığınızda açık sekmede imlecin olduğu yere eklenir.
- Ürün kartı: kart her ürün için ayrı çizilir;
${name},${formattedPrice},${imageUrl}gibi alanlar o ürünün değeriyle dolar.${addToCartAttrs}gibi eylem bağlayıcıları bir açılış etiketinin içine yazılır. Kartın JavaScript'indeproduct,containervewidgethazırdır. - İçerik bloğu: blok, gösterildiği ürün sayfasındaki ürünün değerleriyle dolar (
${title},${brand},${formattedPrice}gibi). Kanalınızın ürün beslemesindeki ek alanlar${attr.<anahtar>}biçiminde yazılır; kutu bu kanalın beslemesinde bulunan anahtarları da listeler. - Kampanya ve sayfa deneyi: dinamik alan doldurulmaz;
${price}gibi bir yer tutucu mağazada düz metin olarak görünür. Ürün adı ya da fiyat gibi bilgileri JavaScript ile sayfanın kendisinden okuyun.
Yer tutucular JavaScript'te doldurulmaz. Bu yüzden JavaScript sekmesi açıkken kutudaki alanlar eklenemez. Tüm yer tutucular: Yer Tutucular.
Şablonu kullanma
Şablonu editörde uygulamak, kodu kütüphaneye kaydetmek, yapay zekâyla yazmak ve mağaza editöründe kullanmak için: Şablon Uygulama ve Yapay Zekâ.
Kopyalanır, bağlanmaz
Bir şablonu uyguladığınızda kodu o alana kopyalanır. Şablonu sonradan düzenlemek ya da silmek, onu daha önce uyguladığınız kampanya, kart, blok ve deneyleri değiştirmez. Böylece yayındaki bir A/B deneyinin içeriği, kütüphanedeki bir düzenleme yüzünden ortasında değişmez. Silme kalıcıdır (geri alınamaz).
Bloklar ve kurallar sekmesi
Kütüphanenin ikinci ekranı, blok oluşturucudan, sayfa deneyinin hedeflemesinden ve deneylerin hedeflerinden kaydettiğiniz öğeleri listeler: Bloklar, Kurallar ve Hedefler. Adres /dashboard/library/blocks. Bu öğeler kendi editörlerinde yapılır; burada görülür ve silinir. Bunlar da hesabınızındır: bir kanalda kaydettiğiniz kural, hedef ya da blok diğer kanalların deneylerinde de seçilebilir. Çok kanallı hesapta her satırın altında hangi kanalda yapıldığı yazar; kanalın kullanamayacağı kayıtlar listelenmez.
Bir kayıtlı öğeyi uyguladığınızda içeriği kullanıldığı yere kopyalanır, öğeye bir bağ kalmaz. Bu yüzden silmek, onu daha önce uyguladığınız hiçbir şeyi değiştirmez; silme kalıcıdır (geri alınamaz) ve yalnızca kütüphane yetkisi olanlarda görünür. Bloklar sekmesinin altında hazır bloklar da bulunur: Add to library (Kütüphaneye ekle) onları hesabınızın kendi bloğu olarak kopyalar, siz düzenler ve silersiniz.
Roller
Admin şablon görür, oluşturur, düzenler ve siler. Marketing şablon görür, oluşturur ve düzenler, silemez (listede Delete hiç görünmez). Rolü görüntüleme dışında olanlarda New template da görünmez.
Neden boş, neden gri
- Kanal seçilmedi: kütüphane hesabınızındır ama bir kanal üzerinden açılır; Open channels ile ya da üst çubuktan bir kanal seçin.
- Bu alan için şablon yok: başka bir yüzey için yazılmış şablonları görmek üzere Show every surface ya da All'a geçin.
- JavaScript sekmesi kilitli: JavaScript içeren şablonlar Custom Code modülünü gerektirir (API 402; hesap yöneticinize başvurun). HTML ve CSS her hesapta kullanılabilir. Modülü olmayan hesapta mevcut bir şablonun adını ya da açıklamasını değiştirmek, script'ine dokunmuyorsanız çalışır.
- Sil düğmesi yok: şablon silmek yönetici yetkisidir.
- Kaydet simgesi gri: editörde kaydedilecek kod yoktur.
- Yapay zekâ düğmesi yok: AI Studio modülü hesabınızda açık değil. Modülü eklemek için hesap yöneticinizle görüşün.
- "Bu hesapta bu adda bir kayıt zaten var": ad hesap genelinde benzersizdir; başka bir kanalda yapılmış bir kayıt da adı tutuyor olabilir. Adı değiştirin.
- JavaScript söz dizimi hatası: şablondaki JavaScript derlenir; hata varsa kayıt reddedilir ve düzeltmeniz istenir.
Son güncelleme: 18 Kasım 2026
