OneTrace.pro Centro assistenza

Modelli ed editor email

Un modello è un messaggio pronto per un singolo canale: email, messaggio Telegram, SMS, Web Push, push mobile, messaggio in-app, 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, faccia clic su Nuovo modello in alto a destra e scelga il canale nell'elenco: contiene tutti i canali attivi nel progetto, ad esempio Email o Telegram.
  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»).
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 Un argomento dall'elenco, ad esempio marketing o news, oppure una nuova chiave, che comparirà nell'elenco. Il cliente può disiscriversi solo da questo argomento
Messaggio transazionale Viene inviato senza verificare iscrizione, frequenza e ore di silenzio, ma non su un canale chiuso per il destinatario: la casella o il numero non esistono, il bot è bloccato. Lo usi solo per conferme d'ordine, reimpostazione della password e messaggi simili, veda Messaggi transazionali e cascate

Elenco dei modelli

Nella tabella sono visibili il canale, le versioni linguistiche del modello (la lingua principale è evidenziata a colori), la valutazione della recapitabilità, l'argomento di iscrizione e l'ora della modifica con il numero di versione.

Recapitabilità è l'esito complessivo della verifica della recapitabilità di un modello email su tutte le sue versioni linguistiche: la valutazione peggiore tra le versioni («Buono», «Ci sono osservazioni», «Scarso») e il punteggio più alto del filtro antispam (spam da 6 in su). I dettagli per ciascuna lingua e l'ora della verifica compaiono nel tooltip del badge. Il modello viene verificato in background dopo ogni modifica dell'email; mentre la verifica è in corso, il badge indica «In verifica». La modifica del solo nome o dell'argomento di iscrizione non avvia una nuova verifica. Se la valutazione è «Ci sono osservazioni» o «Scarso», apra il modello e avvii lì la verifica per vedere le osservazioni.

Sopra la tabella ci sono la ricerca per nome e i filtri per canale, lingua e valutazione della recapitabilità, ad esempio tutti i modelli con valutazione «Scarso» o tutti i modelli con una versione in tedesco. Un clic sull'intestazione di una colonna ordina la tabella, un secondo clic inverte l'ordine. Filtri e ordinamento vengono ricordati: dopo aver eliminato un modello o essere tornato dall’editor, l’elenco resta lo stesso.

Elenco dei modelli con lingue e valutazione della recapitabilità

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, preferences_url Nome del progetto, link di disiscrizione e link al centro preferenze
project.legal_address Indirizzo legale dell'azienda dalle impostazioni del progetto; comodo per il piè di pagina dell'e-mail. Vuoto se l'indirizzo non è impostato
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url Conto nel programma fedeltà: saldo, livello, punti in scadenza e relativa data, link di invito
wallet_url Link alla carta fedeltà in Wallet: il cliente aggiunge la carta ad Apple Wallet o Google Wallet. Valido 90 giorni; vuoto se le carte Wallet non sono collegate
promo_code('welcome') Codice promozionale del cliente dal gruppo welcome: viene assegnato all'invio, nell'anteprima compare un esempio
order.number, order.amount, order.tracking_url Ordine di un'e-mail del negozio: numero, importo, link di tracciamento; importo con valuta: {{ order.amount|money(order.currency) }}
product('SKU-1') Prodotto del catalogo nella lingua dell'email: name, url, image, price, old_price, currency, available, stock, al momento dell'invio (prezzi e disponibilità dei prodotti)
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. L'ereditarietà dei modelli (extends, block) non è disponibile e i cicli e le chiamate a prodotti, raccomandazioni e codici promozionali hanno un limite: un modello che esegue troppe operazioni non verrà salvato.

Se il modello contiene una variabile che la piattaforma non conosce — un segnaposto di un altro layout come {{ COMPANY_ADDRESS }} o un errore di battitura come {{ first_name }} al posto di {{ traits.first_name }} — sopra il contenuto compare un avviso con l'elenco di queste variabili. Nel messaggio saranno vuote. L'avviso si aggiorna quando apre il modello, lo salva, ne vede l'anteprima e invia un test.

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, Modalità scura e Senza immagini. In quest'ultima le immagini sono sostituite dalle descrizioni alt: così vedranno l'email i destinatari le cui immagini non si caricano.
  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.

Editor del modello con anteprima su un profilo

Sotto l'email, nell'anteprima, si trova il blocco Nella posta in arrivo. Mostra come mittente, oggetto e preheader appaiono nell'elenco delle email di Gmail, computer, Outlook e iPhone, Mail. Un oggetto o un preheader lunghi vengono troncati più o meno come in questi client. Il nome del mittente viene preso dall'integrazione scelta nel blocco di verifica della recapitabilità.

Email nella posta in arrivo dei client di posta

Verifica della recapitabilità

Prima dell'invio è possibile verificare un modello email: finirà nella posta in arrivo o nello spam? Nel blocco Verifica della recapitabilità scelga l'integrazione tramite cui partirà l'email e faccia clic su Verifica. L'email viene composta come all'invio: con il tracciamento di aperture e clic e il link di disiscrizione. Viene verificata la versione linguistica aperta e i dati vengono inseriti dal profilo indicato nell'anteprima.

La verifica considera tre aspetti:

  • Mittente. Per il servizio di posta di OneTrace.pro il dominio dell'indirizzo del mittente deve essere aggiunto e verificato nella sezione Domini di invio, possibilmente con un record DMARC. Per un server SMTP proprio vengono verificati i record SPF e DMARC del dominio; la firma DKIM si configura presso il Suo provider di posta e da qui non può essere verificata.
  • Contenuto. L'oggetto (vuoto, tutto in maiuscolo, con !! o $$, troppo lungo), il preheader, la dimensione dell'email (Gmail tronca l'HTML oltre 102 KB), un'email composta solo da immagini, immagini senza alt, link abbreviati, link a indirizzi IP e link il cui testo è l'indirizzo di un altro sito, il link di disiscrizione visibile nelle email di marketing, gli elementi che i client di posta rimuovono (script, moduli, frame).
  • Punteggio del filtro antispam. L'intera email viene verificata dal filtro antispam Rspamd. Un punteggio inferiore alla soglia «sospetto» è buono; superiore alla soglia «spam», l'email con ogni probabilità finirà nello spam. Nell'elenco Cosa ha influito sul punteggio compaiono le regole del filtro e il loro peso.

L'esito è una di queste valutazioni: Buono (nessun motivo evidente per finire nello spam), Ci sono osservazioni (l'email arriverà, ma è meglio correggere le osservazioni) o Scarso (rischio di spam elevato o errore del mittente). Ogni osservazione spiega che cosa non va e come correggerlo.

Più sotto si trova Compatibilità con i client di posta: accorgimenti di layout che non funzionano in Outlook per Windows, Gmail, Yandex Mail o Mail.ru, ad esempio angoli arrotondati, ombre, media query, font personalizzati, SVG e video. In questi client l'email arriverà, ma apparirà diversa, perciò la valutazione non ne risente.

Verifica della recapitabilità dell'email

Le campagne verificano allo stesso modo le email delle proprie varianti: vedere Verifica delle email prima dell'avvio.

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. Poi scelga come creare la versione:

    • Copia della versione aperta — layout, immagini e link sono già al loro posto, resta da tradurre i testi;
    • Traduzione con IA — una bozza di traduzione della versione principale, veda più sotto;
    • Importa un’email con l’IA — un'email già pronta in questa lingua, veda Importare in una versione linguistica.

    Scelta del modo di creare la nuova versione

  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.pro 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.pro 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.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. I prodotti personali, popolari e di tendenza si possono limitare a una categoria del catalogo. La fonte Prodotti selezionati mostra fino a 12 prodotti del catalogo nell'ordine indicato: li cerchi per nome, nell'email finiscono solo quelli disponibili. Si possono mostrare da 1 a 12 prodotti in 1–4 colonne, con prezzo e pulsante. Per i prodotti con recensioni sotto il nome compare la valutazione. Se non ci sono prodotti adatti, il blocco non viene incluso nell'email
Ordine Ordine di un'e-mail del negozio: prodotti, importi, tracciamento della spedizione e indirizzi. Nelle e-mail senza ordine il blocco non c'è
Sondaggio La domanda principale del sondaggio: pulsanti NPS 0–10 o cinque stelle. Il cliente dà la valutazione direttamente nell'e-mail, la pagina del sondaggio la salva e propone le altre domande
HTML Codice proprio, così com'è
Piè di pagina Testo, link di disiscrizione e link «Gestisci iscrizioni»

Editor email con un blocco selezionato

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

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.

IA nell'editor delle email

L'IA aiuta con i testi del modello email: propone gli oggetti, modifica il testo dei blocchi e crea l'email completa a partire da una descrizione. Il risultato dell'IA è una bozza: finisce nel modulo o nell'editor, e il modello lo salva Lei. L'IA conosce il nome del progetto, il settore del negozio, la valuta, la lingua della versione aperta e il tono e le regole del brand. I dati dei clienti non le vengono trasmessi.

L'IA è disponibile con un piano a pagamento e viene addebitata sul saldo del progetto in base al consumo. Se al momento l'IA non è disponibile (periodo di prova, saldo esaurito o limite di spesa raggiunto), i pulsanti sono visibili e accanto compare il motivo.

Idee per l'oggetto

Il pulsante Idee per l'oggetto si trova sopra i campi «Oggetto» e «Preheader». Scelga il Punto di forza (approcci diversi, curiosità e chiarezza, urgenza, tono personale o vantaggio per il lettore) e, se vuole, scriva le Preferenze, ad esempio «senza emoji». Prema Proponi: l'IA propone cinque coppie «oggetto + preheader» in base al testo della versione aperta dell'email.

Nell'elenco l'oggetto appare come lo vedrà il destinatario, con un nome di esempio. L'indicazione Con il nome del destinatario significa che nell'oggetto c'è la variabile del nome. Il pulsante Usa inserisce la coppia nel modulo.

Idee per oggetto e preheader

Modifica del testo di un blocco

Selezioni nell'area di lavoro dell'editor un titolo, un testo o un pulsante. Nel pannello del blocco, nella sezione IA: modifica del testo, ci sono i pulsanti Accorcia, Più cordiale, Più formale, Correggi gli errori e Riscrivi…, quest'ultimo con una Sua indicazione. La proposta dell'IA compare sotto i pulsanti: Sostituisci la inserisce nel blocco, Annulla lascia il testo com'era.

L'IA non modifica le variabili del modello e i link. Se nella risposta manca una variabile o un link è cambiato, il testo non viene sostituito e Lei vede una spiegazione.

Modifica del testo di un blocco con l'IA

Email da una descrizione

Il pulsante Email con l'IA si trova sopra l'editor, accanto al pulsante «Apri l'editor». Descriva di cosa parla l'email e cosa si aspetta dal lettore, e indichi i link, ad esempio «saldi sui cappotti fino a domenica, sconti fino al 30%, link https://…». Attivi Prodotti del catalogo se nell'email servono dei prodotti: l'IA guarda le categorie del catalogo e trova i prodotti disponibili. Prema Crea l'email: di solito ci vuole fino a un minuto.

Perché la nuova email somigli alle Sue altre email, scelga un'Email di esempio: un modello email del progetto creato nell'editor. L'IA ne riprende grafica e struttura: colori e carattere, logo e altre immagini, pulsanti, blocchi HTML come un riquadro con codice promozionale e il piè di pagina con le sue variabili. I testi li scrive in base alla descrizione: offerte, codici promozionali e link dell'esempio non passano nella nuova email, a meno che non li indichi nella descrizione.

L'email viene creata con i blocchi dell'editor: titolo, testo, pulsante, prodotti e piè di pagina con il link di disiscrizione. Se nell'editor c'è già un'email, OneTrace.pro chiede se sostituirla. Oggetto e preheader vengono inseriti solo se i campi sono vuoti. Se c'è qualcosa da correggere, sopra l'editor compaiono degli avvisi, ad esempio di indicare i link dei pulsanti che non erano nella descrizione.

Email creata dall'IA da una descrizione

Le varianti dell'email per il test A/B l'IA le crea direttamente nella campagna.

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.

Finestra di importazione dell'email

Modello creato da un'email con l'IA

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.

OneTrace.pro riconosce la lingua dell'email dall'attributo lang e dall'intestazione Content-Language e, se non corrispondono al testo, dal testo stesso dell'email. La lingua dell'email diventa la lingua principale del nuovo modello.

Importare in una versione linguistica

Se ha già l'email in un'altra lingua, non serve tradurla: in un modello email aperto prema Aggiungi lingua, scelga la lingua e poi Importa un’email con l’IA. L'email si carica come quando si crea un modello e finisce nella versione della lingua scelta, con i propri blocchi, immagini e oggetto. Controlli la versione e prema Salva.

Se la lingua dell'email non corrisponde a quella scelta, sopra la versione compare un suggerimento, per esempio «Sembra che l’email sia in francese», e il pulsante Usala come versione «francese». Se quella versione esiste già, OneTrace.pro Le chiede se sostituirla.

L'importazione è disponibile nei piani «Crescita» ed «Enterprise»; il numero di importazioni al mese, sia di nuovi modelli sia di versioni, 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.

Mediateca con le immagini caricate