Şablonlar ve e-posta oluşturucu
Şablon, tek bir kanal için hazır bir mesajdır: e-posta, Telegram mesajı, SMS, Web Push, webhook ve diğerleri. Aynı şablonu yolculuklar, kampanyalar ve profil kartından elle gönderim kullanır. Değişkenler metne müşterinin adını, sipariş tutarını ve diğer verileri ekler.
Bölüm İletişim → Şablonlar menüsündedir. Şablonları tüm roller görüntüleyebilir; oluşturma ve değiştirme işlemlerini “Müdür” ve üzeri roller yapabilir.
Şablon oluşturma
- Şablonlar sayfasını açın. Sağ üstte projede etkin olan her kanal için bir düğme bulunur, örneğin E-posta veya Telegram. İstediğinize tıklayın.
- Genel alanları doldurun (aşağıdaki tablo).
- İçerik bloğunu doldurun. Alanlar kanala göre değişir. E-postada bunlar Konu, Ön başlık (e-posta listesinde konunun yanındaki metin), E-posta oluşturucu veya HTML ve Düz metin sürümüdür. Düz metin sürümü doldurulmazsa HTML'den oluşturulur.
- Kaydet düğmesine tıklayın. Her kaydetmede sürüm numarası artar (“Sürüm 3”).
| Alan | Anlamı |
|---|---|
| Ad | Yalnızca arayüzde görünür: şablon, yolculuk ve kampanya listelerinde |
| Kanal | Oluşturma sırasında seçilir, sonradan değiştirilemez |
| Abonelik konusu | Örneğin marketing veya news. Müşteri yalnızca bu konunun aboneliğinden çıkabilir |
| İşlemsel mesaj | Abonelik, sıklık ve sessiz saatler kontrol edilmeden gönderilir. Yalnızca sipariş onayı, parola sıfırlama ve benzeri mesajlar için kullanın |
Bir şablonu silmek için listede satırındaki çöp kutusu simgesine tıklayın.
Değişkenler
Şablonlar Twig dilinde yazılır. Değişken çift süslü parantez içine yazılır. İçeriğin altındaki Değişkenler bloğunu açarsanız örnekleriyle birlikte tam liste görünür.
| Değişken | Ne eklenir |
|---|---|
profile.email, profile.phone, profile.user_id |
Müşterinin tanımlayıcıları |
traits.first_name ve diğer traits.* |
Profil nitelikleri |
event.name, event.properties.amount |
Mesajı tetikleyen olay |
context.data.*, context.nodes.* |
Yolculuk verileri: API üzerinden girişte gönderilenler ve “Webhook” düğümünün yanıtı |
project.name, unsubscribe_url |
Proje adı ve abonelikten çıkma bağlantısı |
Merhaba {{ traits.first_name|default('değerli müşterimiz') }}!
{% if event.properties.amount > 5000 %}Kargo ücretsiz.{% endif %}
Şablonlar güvenli bir korumalı alanda (sandbox) çalıştırılır. Burada if koşulları, for döngüleri, set, date, min, max fonksiyonları ve default, date, upper, lower, capitalize, number_format, round, join, replace, striptags gibi filtreler bulunur. Değişken yoksa boş bir metin eklenir; bu nedenle önemli yerler için default belirleyin. Yasaklanmış bir yapı kullanırsanız kaydederken “Şablonda yasak bir yapı kullanılıyor” hatası görünür. Hazır mesaj 512 KB'tan büyük olamaz.
Önizleme ve test gönderimi
- Önizleme panelinde bir profil ID'si, e-posta veya user_id girin ve göz simgesine tıklayın. Alan boş bırakılırsa veriler son etkinliği olan profilden alınır.
- E-posta için Masaüstü, Telefon ve Koyu mod modları arasında geçiş yapın.
- Test gönderimi panelinde bir entegrasyon seçin. Kendi adresinizi veya chat id'nizi belirtin, aksi halde mesaj profilin adresine gider. Test gönder düğmesine tıklayın: düğmenin altında mesajın durumu görünür.
Test gönderimi “Müdür” ve üzeri rollere açıktır. Bu sırada abonelik, sıklık ve sessiz saatler kontrol edilmez. Önizlemede tetikleyici olay yoktur, bu nedenle event.* değişkenleri boş kalır. Kişisel verileri görme yetkiniz yoksa e-posta ve telefon maskelenir.
E-posta oluşturucu
E-posta şablonunda “E-posta oluşturucu” alanındaki Oluşturucuyu aç düğmesine tıklayın. Şablonda zaten HTML varsa oluşturucu e-postaya sıfırdan başlar ve eski kod kaydederken değiştirilir. Outlook ve telefonlar dahil e-posta istemcileri için kodu OneTrace.pro kaydederken kendisi oluşturur.
Tuvalin sağında üç sekme bulunur:
- Bloklar: blok ekler. Blok seçili bloğun sonrasına veya e-postanın sonuna, alt bilginin önüne yerleşir.
- Blok: tuvalde seçili bloğun ayarları. Bloklar yukarı ve aşağı taşınabilir, sürüklenebilir, çoğaltılabilir ve silinebilir.
- E-posta: arka plan, e-posta arka planı, metin ve bağlantı renkleri, yazı tipi, e-posta genişliği (480–800 px), kenar boşlukları ve görsellerin gösterim şekli.
| Blok | Amacı |
|---|---|
| Başlık, Metin | Biçimlendirme ve değişkenler içeren metin, örneğin {{ traits.first_name }} |
| Görsel | Medya kütüphanesinden görsel: alternatif metin, bağlantı, %10–100 genişlik |
| Düğme | Metin, bağlantı, renkler ve köşe yuvarlaklığı |
| Ayırıcı, Boşluk | Çizgi ve boş alan |
| Sütunlar | Başlık, metin, görsel, düğme ve boşluk içeren 2–3 sütun. Telefonda sütunlar alt alta dizilir |
| Ürünler | Önerilerden seçki: kişisel, popüler, “Birlikte görüntülenenler”, “Benzer” vb. 1–4 sütunda, fiyat ve düğmeyle 1 ile 12 arasında ürün gösterilebilir. Uygun ürün yoksa blok e-postaya eklenmez |
| HTML | Kendi kodunuz, olduğu gibi |
| Alt bilgi | Metin ve abonelikten çıkma bağlantısı |
“E-posta” sekmesindeki HTML'ye geç düğmesi e-postayı düz koda dönüştürür. Bundan sonra oluşturucuya geri dönülemez.
Bağlantı mı ek mi
| Bağlantı (CDN) | E-postaya ek | |
|---|---|---|
| E-posta boyutu | Hafif | Görsellerin boyutu kadar büyük |
| Gösterim | Görsel e-posta açıldığında yüklenir. E-posta istemcisi görselleri engelliyorsa yalnızca alternatif metin görünür | Görsel hemen görünür |
Varsayılan yöntem “E-posta” sekmesindeki Varsayılan görsel gösterimi alanında belirlenir. Tek bir görsel için Gösterim alanından değiştirilebilir. Bir e-postanın tüm ekleri toplamda 1 MB'ı geçemez. Kurulumda herkese açık bağlantılar yapılandırılmamışsa yalnızca ekler kullanılabilir.
Medya kütüphanesi
Medya kütüphanesi bir “Görsel” bloğu eklediğinizde veya Görsel seç düğmesine tıkladığınızda açılır.
- Yükle en fazla 10 MB boyutunda JPEG, PNG, GIF, WebP ve AVIF dosyalarını kabul eder. Geniş görseller 1200 px'e küçültülür. WebP ve AVIF yeniden kodlanır, çünkü her e-posta istemcisi bunları göstermez. GIF animasyonuyla birlikte olduğu gibi kalır.
- Aynı dosyayı yeniden yüklerseniz kopya oluşmaz.
- Bir şablonda kullanılan görsel, şablondan kaldırılana kadar silinemez.
- Görsellerin kapladığı alan tarife sınırına dahildir.
