Modelli ed editor email
Un modello è un messaggio pronto per un singolo canale: email, messaggio Telegram, SMS, Web Push, webhook e altri. Lo stesso modello viene usato da percorsi, campagne e dall'invio manuale dalla scheda del profilo. Le variabili inseriscono nel testo il nome del cliente, l'importo dell'ordine e altri dati.
La sezione si trova nel menu Coinvolgimento → Modelli. Tutti i ruoli possono vedere i modelli; crearli e modificarli possono il «Manager» e i ruoli superiori.
Creazione di un modello
- Apra Modelli. In alto a destra c'è un pulsante per ogni canale attivo nel progetto, ad esempio Email o Telegram. Faccia clic su quello desiderato.
- Compili i campi generali (vedi la tabella sotto).
- Compili il blocco Contenuto. I campi dipendono dal canale. Per un'email sono Oggetto, Preheader (il testo accanto all'oggetto nell'elenco delle email), Editor email o HTML e Versione in testo semplice. Se la versione in testo semplice non viene compilata, viene generata dall'HTML.
- Faccia clic su Salva. A ogni salvataggio il numero di versione aumenta («Versione 3»).
| Campo | Significato |
|---|---|
| Nome | Visibile solo nell'interfaccia: negli elenchi di modelli, percorsi e campagne |
| Canale | Si sceglie alla creazione e non può essere modificato in seguito |
| Argomento di iscrizione | Ad esempio marketing o news. Il cliente può disiscriversi solo da questo argomento |
| Messaggio transazionale | Viene inviato senza verificare iscrizione, frequenza e ore di silenzio. Lo usi solo per conferme d'ordine, reimpostazione della password e messaggi simili |
Per eliminare un modello, faccia clic sull'icona del cestino nella sua riga dell'elenco.
Variabili
I modelli si scrivono nel linguaggio Twig. Una variabile va racchiusa tra doppie parentesi graffe. L'elenco completo con esempi si apre espandendo il blocco Variabili sotto il contenuto.
| Variabile | Cosa viene inserito |
|---|---|
profile.email, profile.phone, profile.user_id |
Identificatori del cliente |
traits.first_name e altri traits.* |
Attributi del profilo |
event.name, event.properties.amount |
L'evento che ha avviato il messaggio |
context.data.*, context.nodes.* |
Dati del percorso: quelli trasmessi all'ingresso tramite API e la risposta del nodo «Webhook» |
project.name, unsubscribe_url |
Nome del progetto e link di disiscrizione |
Buongiorno, {{ traits.first_name|default('cliente') }}!
{% if event.properties.amount > 5000 %}Spedizione gratuita.{% endif %}
I modelli vengono eseguiti in una sandbox sicura. Sono disponibili le condizioni if, i cicli for, set, le funzioni date, min, max e i filtri default, date, upper, lower, capitalize, number_format, round, join, replace, striptags e altri. Se una variabile manca, viene inserita una stringa vuota, quindi nei punti importanti imposti default. Se si usa un costrutto vietato, al salvataggio compare l'errore «Il modello usa un costrutto non consentito». Il messaggio finale non può superare i 512 KB.
Anteprima e invio di prova
- Nel pannello Anteprima inserisca l'ID del profilo, l'email o lo user_id e faccia clic sull'icona dell'occhio. Se il campo resta vuoto, i dati vengono presi dal profilo con l'attività più recente.
- Per un'email passi tra le modalità Desktop, Telefono e Modalità scura.
- Nel pannello Invio di prova scelga l'integrazione. Indichi il Suo indirizzo o chat id, altrimenti il messaggio verrà inviato all'indirizzo del profilo. Faccia clic su Invia prova: sotto il pulsante compare lo stato del messaggio.
L'invio di prova è disponibile per il ruolo «Manager» e quelli superiori. Iscrizione, frequenza e ore di silenzio non vengono verificate. Nell'anteprima non c'è un evento trigger, quindi le variabili event.* restano vuote. Se non ha il permesso di vedere i dati personali, email e telefono saranno mascherati.
Editor email
In un modello email faccia clic su Apri l'editor nel campo «Editor email». Se il modello contiene già dell'HTML, l'editor ricomincia l'email da capo e il codice precedente viene sostituito al salvataggio. Il codice per i client di posta, inclusi Outlook e i telefoni, viene generato da OneTrace.pro al salvataggio.
A destra dell'area di lavoro ci sono tre schede:
- Blocchi: aggiunge un blocco, che verrà inserito dopo il blocco selezionato o alla fine dell'email, prima del piè di pagina.
- Blocco: impostazioni del blocco selezionato nell'area di lavoro. I blocchi si possono spostare in alto e in basso, trascinare, duplicare ed eliminare.
- Email: sfondo, sfondo dell'email, colori di testo e link, carattere, larghezza dell'email (480–800 px), margini e modalità di consegna delle immagini.
| Blocco | Funzione |
|---|---|
| Titolo, Testo | Testo con formattazione e variabili, ad esempio {{ traits.first_name }} |
| Immagine | Un'immagine dalla mediateca: testo alternativo, link, larghezza 10–100 % |
| Pulsante | Testo, link, colori e raggio degli angoli |
| Divisore, Spaziatore | Una linea e uno spazio vuoto |
| Colonne | 2–3 colonne con titoli, testo, immagini, pulsanti e spaziatori. Sul telefono le colonne si dispongono una sotto l'altra |
| Prodotti | Una selezione dalle raccomandazioni: personali, popolari, «Visti insieme», «Simili» e così via. Si possono mostrare da 1 a 12 prodotti in 1–4 colonne, con prezzo e pulsante. Se non ci sono prodotti adatti, il blocco non viene incluso nell'email |
| HTML | Codice proprio, così com'è |
| Piè di pagina | Testo e link di disiscrizione |
Il pulsante Passa all'HTML nella scheda «Email» trasforma l'email in codice normale. Dopo non è più possibile tornare all'editor.
Link o allegato
| Link (CDN) | Allegato all'email | |
|---|---|---|
| Peso dell'email | Leggera | Più pesante della dimensione delle immagini |
| Visualizzazione | L'immagine viene caricata all'apertura. Se il client di posta blocca le immagini, è visibile solo la didascalia | L'immagine è visibile subito |
La modalità predefinita si imposta nel campo Consegna predefinita delle immagini nella scheda «Email». Per una singola immagine si può cambiare nel campo Consegna. Tutti gli allegati di un'email insieme non possono superare 1 MB. Se nell'installazione non sono configurati i link pubblici, sono disponibili solo gli allegati.
Mediateca
La mediateca si apre quando si aggiunge un blocco «Immagine» o si fa clic su Scegli immagine.
- Carica accetta JPEG, PNG, GIF, WebP e AVIF fino a 10 MB. Le immagini larghe vengono ridotte a 1200 px. WebP e AVIF vengono ricodificati, perché non tutti i client di posta li mostrano. Le GIF restano invariate, animazione inclusa.
- Se si carica di nuovo lo stesso file, non viene creata una copia.
- Un'immagine usata in un modello non può essere eliminata finché non la si rimuove dal modello.
- Lo spazio occupato dalle immagini rientra nel limite del piano.
