Come aggiungere logica condizionale ai modelli di e-mail usando il builder di logica

Cosa imparerai

Scopri come usare il generatore di logica per aggiungere una logica condizionale dinamica, come istruzioni if/else e cicli for, direttamente ai blocchi di testo nei modelli di e-mail. Questo ti consente di mostrare contenuti personalizzati a destinatari diversi in base al loro profilo o a proprietà personalizzate, senza scrivere codice.

Prima di iniziare

Il generatore di logica è disponibile in:

• Editor drag-and-drop per e-mail — blocchi di testo, blocchi tabella e blocchi split
• Editor e-mail solo testo — tramite una modale anziché un pannello laterale

Per usare il generatore di logica, ti serve almeno un profilo nel tuo account che abbia la proprietà che vuoi valutare. Il profilo e le proprietà personalizzate possono essere aggiunti tramite il modulo d’iscrizione, i caricamenti CSV, le integrazioni e-commerce e altri strumenti per far crescere le liste.

Nota: Il generatore di logica supporta il profilo e le proprietà personalizzate. Non supporta i dati degli eventi. Per usare i dati degli eventi nella tua logica, usa l'opzione Converti in codice e scrivi direttamente i tag Django.

Aggiungi un’istruzione if/else

Usa un'istruzione if/else per mostrare contenuti diversi ai destinatari in base a un profilo o a una proprietà personalizzata. Ad esempio, potresti mostrare un blocco sconto VIP solo ai clienti con più di 500 punti fedeltà e un incentivo all'iscrizione a tutti gli altri.

Nell'editor drag and drop

1. Fai doppio clic su un blocco di testo, un blocco tabella o un blocco split per entrare in modalità di modifica.
2. Fai clic sul pulsante Inserisci nella barra degli strumenti nella parte superiore della pagina.
3. Seleziona If/else dal menu a discesa.
   • Si aprirà un pannello laterale a sinistra e l’area di lavoro si sposterà verso destra.
4. Configura l’istruzione if:
   • Usa il primo menu a discesa per scegliere un profilo o una proprietà personalizzata da valutare.
   • Usa il secondo menu a discesa per selezionare un operatore (ad es. uguale a, maggiore di, è impostato).
   • Inserisci o seleziona un valore da confrontare, a seconda dell’operatore scelto.
5. Facoltativamente, fai clic su Aggiungi condizione per aggiungere ulteriori criteri all'istruzione if.
   • Usa AND o OR per collegare le condizioni. Per impostazione predefinita è selezionato OR.
   • Fai clic sul pulsante clona in una condizione per duplicarla come nuova condizione OR.
6. Per aggiungere un ramo else if, fai clic su Aggiungi else if e configura le condizioni nello stesso modo. I destinatari che soddisfano queste condizioni, ma non l’istruzione if, vedranno questo contenuto.
7. Per aggiungere un ramo else, seleziona la casella di controllo Else (selezionata per impostazione predefinita). Modifica il contenuto nel canvas per definire cosa vedranno i destinatari che non soddisfano alcuna condizione. Deseleziona la casella per rimuovere completamente il ramo else.
8. Modifica il contenuto nell’area di lavoro per ogni condizione. Ogni condizione appare come un riquadro blu durante la configurazione.
9. Al termine, fai clic sulla freccia indietro per chiudere il pannello e salvare la logica.

Suggerimento: per rimuovere tutta la logica configurata da un blocco, fai clic su Rimuovi logica nel pannello laterale.

Nota: facendo clic su Elimina nell'istruzione if iniziale, i suoi valori verranno reimpostati anziché rimuovere completamente l'istruzione. Facendo clic su Elimina in un ramo else if o else, quel ramo verrà rimosso.

Nell'editor di solo testo

Segui gli stessi passaggi sopra, ma seleziona Inserisci dalla barra degli strumenti di modifica del testo. Il generatore di logica si aprirà in una finestra modale anziché in un pannello laterale. Sono disponibili tutte le stesse opzioni di configurazione.

Aggiungi un ciclo for

Usa un ciclo for per scorrere un elenco di elementi e mostrare contenuti ripetuti per ciascuno. Ad esempio, potresti scorrere i prodotti visualizzati di recente da un cliente per mostrarli nell’e-mail.

Nell'editor drag and drop

1. Fai doppio clic su un blocco di testo, un blocco tabella o un blocco split.
2. Fai clic sul pulsante Inserisci nella barra degli strumenti.
3. Seleziona ciclo for dal menu a discesa.
   • Si aprirà un pannello laterale a sinistra.
4. Nel campo Variabile, inserisci l'elenco su cui vuoi eseguire il loop (ad esempio, event.items).
5. Nel campo Alias elemento, inserisci un nome per fare riferimento a ciascun elemento singolo all’interno del ciclo (ad es. item).
6. Modifica il contenuto nell’area di lavoro per definire cosa verrà mostrato per ogni elemento.
7. Fai clic sulla freccia indietro per chiudere il pannello e salvare la logica.

Suggerimento: per rimuovere completamente il loop, fai clic su Rimuovi logica nel pannello laterale.

Aggiungi un tag configurabile

Usa un tag configurabile per inserire tag Django che non sono inclusi nei builder di if/else o del ciclo for, ad esempio per le istruzioni with o i tag del catalogo.

1. Fai doppio clic su un blocco di testo, un blocco tabella o un blocco split.
2. Fai clic sul pulsante Inserisci nella barra degli strumenti.
3. Seleziona tag configurabile dal menu a discesa.
   • Si aprirà un pannello laterale a sinistra.
4. Nel campo Nome tag, inserisci il tag che aprirà e chiuderà il blocco (ad es. with).
5. Nell’area di testo Codice, aggiungi il codice del tuo tag Django personalizzato.
6. Per aggiungere un ramo, fai clic su Aggiungi ramo. In questo modo viene creata una sezione aggiuntiva in cui puoi configurare un altro nome del tag e un blocco di codice.
7. Fai clic sulla freccia indietro per chiudere il pannello e salvare la logica.

Lavora con la logica nidificata

Puoi annidare le istruzioni logiche una dentro l’altra, ad esempio un’istruzione if/else all’interno di un ciclo for. Questo ti consente di creare sequenze di contenuti altamente mirate.

Quando la logica è nidificata:

• Le icone a linea verticale indicano il livello di annidamento di ciascuna istruzione logica.
• Passando il mouse su un’istruzione principale viene evidenziato l’intero blocco nidificato.
• Passando il mouse su un’istruzione figlia viene evidenziata solo quell’istruzione figlia.
• Puoi comprimere ed espandere le istruzioni figlie in modo indipendente rispetto al genitore.
• Se sono annidati più di tre livelli di logica, viene visualizzato un indicatore +[numero] per mostrare l’ulteriore profondità di annidamento.

Converti la logica in codice

Se hai bisogno di un maggiore controllo sulla logica o vuoi utilizzare funzionalità non supportate, come i dati degli eventi o i confronti tra date, puoi convertire la configurazione del generatore di logica in codice Django non elaborato.

Avviso: la conversione della logica in codice è un'azione unidirezionale e non può essere annullata. Non potrai tornare al generatore di logica dopo la conversione.

Per convertire:

1. Apri il pannello laterale del generatore di logica per il blocco che vuoi aggiornare.
2. Per le istruzioni if/else, ogni singolo segmento (if, else if) ha il proprio pulsante Converti in codice. Fai clic su quello del segmento che vuoi convertire.
3. Per i loop for, fai clic sull'unico pulsante Converti in codice per l'intero loop.
4. Verrà visualizzata una finestra modale di avviso. Conferma di voler procedere.
5. Dopo la conversione, il codice convertito verrà visualizzato in un editor di codice nel pannello laterale. Puoi modificarlo direttamente da lì.

Questo stato convertito è permanente: persisterà anche dopo che chiudi il pannello o esci dal modello.

Differenze nell'editor di solo testo

Il generatore di logica nell’editor solo testo funziona allo stesso modo che nell’editor drag and drop, con una differenza fondamentale: la logica viene configurata in una finestra modale anziché in un pannello laterale. Sono disponibili le stesse opzioni per if/else, cicli for, tag configurabili, annidamento e conversione in codice.

Dopo la configurazione della logica, questa viene visualizzata nel canvas nello stesso modo che nell’editor drag and drop. Facendo clic su Modifica in una condizione configurata, si apre la finestra modale per consentire ulteriori modifiche.

Risorse aggiuntive

• Riferimento sulla logica condizionale
• Come mostrare o nascondere blocchi e sezioni del modello in base a variabili dinamiche
• Riferimento alla personalizzazione del messaggio
• Informazioni sulle proprietà personalizzate
• Corso: Applica i concetti di logica di programmazione per creare messaggi più personalizzati