In questo esempio personalizzerai il corpo di un messaggio e-mail. Questo messaggio è destinato ai clienti che hanno lasciato articoli nel carrello ma non hanno completato l’acquisto.
Puoi utilizzare i seguenti tipi di funzioni di assistenza:
upperCase
funzione stringa, per inserire il nome del cliente in lettere maiuscole. Maggiori informazioni.each
helper, per elencare gli elementi presenti nel carrello. Maggiori informazioni.if
helper, per inserire una nota specifica per il prodotto se il prodotto correlato si trova nel carrello. Maggiori informazioni.➡️ Scopri come utilizzare le funzioni di assistenza in questo video
Prima di iniziare, assicurati di sapere come configurare questi elementi:
Segui questi passaggi:
Il contenuto del carrello è un’informazione contestuale proveniente dal percorso. Pertanto, è necessario aggiungere un evento iniziale e l’e-mail a un percorso prima di poter aggiungere all’e-mail informazioni specifiche per il carrello.
Crea un evento il cui schema include productListItems
array.
Definisci tutti i campi di questo array come campi payload per questo evento.
Ulteriori informazioni sul tipo di dati delle voci dell’elenco dei prodotti Documentazione di Adobe Experience Platform.
Crea un percorso che inizia con questo evento.
Aggiungi un E-mail al percorso.
In E-mail attività, fai clic su Modifica contenuto, quindi fai clic su E-mail Designer.
Dalla palette a sinistra della home page di E-mail Designer, trascina e rilascia tre componenti struttura sul corpo del messaggio.
Trascina e rilascia un componente di contenuto HTML su ciascun nuovo componente struttura.
Nella pagina Home di E-mail designer, fai clic sul componente HTML in cui desideri aggiungere il nome del cliente.
Sulla barra degli strumenti contestuale, fai clic su Mostra il codice sorgente.
In Modifica HTML , aggiungi il upperCase
funzione stringa:
Nel menu a sinistra, seleziona Funzioni di supporto.
Utilizza il campo di ricerca per trovare "maiuscolo".
Dai risultati della ricerca, aggiungi upperCase
funzione. A tale scopo, fare clic sul segno più (+) accanto a {%= upperCase(string) %}: string
.
L’editor espressioni mostra questa espressione:
{%= upperCase(string) %}
Rimuovi il segnaposto "stringa" dall’espressione.
Aggiungi il token di nome:
Nel menu a sinistra, seleziona Attributi del profilo.
Seleziona Persona > Nome e cognome.
Aggiungi il Nome token per l’espressione.
L’editor espressioni mostra questa espressione:
{%= upperCase(profile.person.name.firstName) %}
Ulteriori informazioni sul tipo di dati Nome persona in Documentazione di Adobe Experience Platform.
Clic Convalida, quindi fai clic su Salva.
Salva il messaggio.
Riapri il contenuto del messaggio.
Nella pagina Home di E-mail designer, fai clic sul componente HTML in cui desideri elencare il contenuto del carrello.
Sulla barra degli strumenti contestuale, fai clic su Mostra il codice sorgente.
In Modifica HTML , aggiungi il each
helper:
Nel menu a sinistra, seleziona Funzioni di supporto.
Utilizza il campo di ricerca per trovare "ciascuno".
Dai risultati della ricerca, aggiungi each
aiutante.
L’editor espressioni mostra questa espressione:
{{#each someArray as |variable|}} {{/each}}
Aggiungi il productListItems
array all’espressione:
Rimuovi il segnaposto "someArray" dall’espressione.
Nel menu a sinistra, seleziona Attributi contestuali.
Attributi contestuali sono disponibili solo dopo che il contesto del percorso è stato passato al messaggio.
Seleziona Journey Optimizer > Eventi > nome_evento, quindi espandi productListItems nodo.
In questo esempio, nome_evento rappresenta il nome dell’evento.
Aggiungi il Prodotto token per l’espressione.
L’editor espressioni mostra questa espressione:
{{#each context.journey.events.event_ID.productListItems.product as |variable|}} {{/each}}
In questo esempio, event_ID rappresenta l’ID dell’evento.
Modifica l’espressione:
Questo esempio mostra l’espressione modificata:
{{#each context.journey.events.event_ID.productListItems as |product|}}
Incolla questo codice tra le aperture {{#each}}
tag e chiusura {/each}}
tag:
<table>
<tbody>
<tr>
<td><b>#name</b></td>
<td><b>#quantity</b></td>
<td><b>$#priceTotal</b></td>
</tr>
</tbody>
</table>
Aggiungi i token di personalizzazione per il nome dell’articolo, la quantità e il prezzo:
Ripeti questi passaggi due volte:
Questo esempio mostra l’espressione modificata:
{{#each context.journey.events.event_ID.productListItems as |product|}}
<table>
<tbody>
<tr>
<td><b>{{context.journey.events.event_ID.productListItems.name}}</b></td>
<td><b>{{context.journey.events.event_ID.productListItems.quantity}}</b></td>
<td><b>${{context.journey.events.event_ID.productListItems.priceTotal}}</b></td>
</tr>
</tbody>
</table>
{{/each}}
Clic Convalida, quindi fai clic su Salva.
Nella pagina Home di E-mail designer, fai clic sul componente HTML in cui desideri inserire la nota.
Sulla barra degli strumenti contestuale, fai clic su Mostra il codice sorgente.
In Modifica HTML , aggiungi il if
helper:
Nel menu a sinistra, seleziona Funzioni di supporto.
Utilizza il campo di ricerca per trovare "if".
Dai risultati della ricerca, aggiungi if
aiutante.
L’editor espressioni mostra questa espressione:
{%#if condition1%} render_1
{%else if condition2%} render_2
{%else%} default_render
{%/if%}
Rimuovi questa condizione dall’espressione:
{%else if condition2%} render_2
Questo esempio mostra l’espressione modificata:
{%#if condition1%} render_1
{%else%} default_render
{%/if%}
Aggiungi il token del nome del prodotto alla condizione:
Rimuovi il segnaposto "condition1" dall’espressione.
Nel menu a sinistra, seleziona Attributi contestuali.
Seleziona Journey Orchestration > Eventi > nome_evento, quindi espandi productListItems nodo.
In questo esempio, nome_evento rappresenta il nome dell’evento.
Aggiungi il Nome token per l’espressione.
L’editor espressioni mostra questa espressione:
{%#if context.journey.events.`event_ID`.productListItems.name%}
render_1
{%else%} default_render
{%/if%}
Modifica l’espressione:
Nell’editor espressioni, specifica il nome del prodotto dopo name
token.
Utilizza questa sintassi, dove product_name rappresenta il nome del prodotto:
= "product_name"
In questo esempio, il nome del prodotto è "Juno Jacket":
{%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
render_1
{%else%} default_render
{%/if%}
Sostituite il segnaposto "render_1" con il testo della nota.
Esempio:
{%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
Due to longer than usual lead times on the Juno Jacket, please expect item to ship two weeks after purchase.
{%else%} default_render
{%/if%}
Rimuovi il segnaposto "default_render" dall’espressione.
Clic Convalida, quindi fai clic su Salva.
Salva il messaggio.
Attiva Test , quindi fai clic su Attivare un evento.
In Configurazione evento immettere i valori di input, quindi fare clic su Invia.
La modalità di test funziona solo con i profili di test.
L’e-mail viene inviata all’indirizzo del profilo di test.
In questo esempio, l’e-mail contiene la nota sulla Giacca Juno, perché questo prodotto si trova nel carrello:
Verifica che non vi sia alcun errore, quindi pubblica il percorso.
Scopri come utilizzare le funzioni di assistenza.