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

1. 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.
2. Compili i campi generali (vedi la tabella sotto).
3. 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.
4. Faccia clic su Salva. A ogni salvataggio il numero di versione aumenta («Versione 3»).

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.

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

1. 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.
2. Per un'email passi tra le modalità Desktop, Telefono e Modalità scura.
3. 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.

Versioni linguistiche

Un modello può contenere versioni in più lingue. Ogni destinatario riceve la versione nella lingua del suo profilo (l'attributo language) o, se non esiste, quella principale. Le lingue disponibili si impostano nelle impostazioni del progetto.

1. Sopra il blocco Contenuto, clicchi su Aggiungi lingua e scelga una lingua. La nuova versione nasce come copia di quella aperta: layout, immagini e link sono già al loro posto, resta da tradurre i testi.
2. Passi da una versione all'altra con i pulsanti delle lingue. La versione principale è contrassegnata come «principale».
3. Perché i destinatari senza una versione propria ricevano un'altra lingua, apra quella versione e clicchi su Rendi principale. Elimina versione rimuove la versione aperta.
4. Clicchi su Salva. Ogni versione viene verificata separatamente; una versione con errori è segnalata da un'icona di avviso.

Bozza di traduzione

Per non tradurre una versione da zero a mano, la apra e clicchi su Bozza di traduzione. OneTrace.ru traduce la versione principale nella lingua della scheda aperta: oggetto, preheader, testi dei blocchi dell'editor, versione in testo semplice, testi di SMS, push e messenger. Variabili come {{ traits.first_name }}, link, immagini e formattazione non cambiano.

La bozza viene soltanto inserita nel modulo. La legga, corregga le formulazioni e clicchi su Salva. Se un campo non è stato possibile tradurlo senza perdere le variabili, resta nella lingua di origine e OneTrace.ru mostra quanti sono questi campi. Se la versione è già diversa da quella principale, prima della sostituzione compare una richiesta di conferma.

Il numero di bozze al mese è limitato dal piano: vedere Piani. Il pulsante non compare se la traduzione non è collegata nella Sua installazione.

La versione viene scelta così: prima la lingua esatta, poi la lingua senza regione (un cliente con pt-BR riceve la versione pt), poi un'altra variante della stessa lingua. L'anteprima e l'invio di prova mostrano la versione aperta, e la variabile {{ language }} contiene la lingua della versione inviata.

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.ru 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.

Il pulsante Passa all'HTML nella scheda «Email» trasforma l'email in codice normale. Dopo non è più possibile tornare all'editor.

Link o allegato

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.

Importare un'email già pronta

Se l'email è già stata realizzata in un altro servizio, non serve ricostruirla. Nella pagina Modelli prema Importa email (IA):

1. Scelga File e carichi un'email salvata dal programma di posta (.eml) o una pagina .html. Oppure scelga Codice HTML e incolli il codice dell'email.
2. Prema Importa. Di solito l'IA elabora l'email entro un minuto.
3. Si apre l'editor con un nuovo modello email: l'email è suddivisa in blocchi dell'editor, le immagini sono copiate nella mediateca, il nome del destinatario è sostituito dalla variabile {{ traits.first_name }} e il link di disiscrizione è nel blocco «Piè di pagina». Testi e link restano come nell'email.
4. Controlli il modello e prema Salva. Finché non lo salva, il modello non esiste.

Se una parte dell'email non è stata trasferita, sopra il modulo compare un elenco: quali immagini non sono state copiate o quali blocchi sono stati saltati. Se l'email non si può suddividere in blocchi, viene importata come un unico blocco «HTML». I pixel di tracciamento e il link «Apri nel browser» non vengono importati.

L'importazione è disponibile nei piani «Crescita» ed «Enterprise»; il numero di importazioni al mese dipende dal piano: veda Piani. Nel piano «Start» il pulsante indica da quale piano la funzione è disponibile.

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.