Caso di utilizzo di Personalization: e-mail di abbandono del carrello personalization-use-case-helper-functions
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:
- La funzione stringa
upperCase
, per inserire il nome del cliente in lettere maiuscole. Ulteriori informazioni. - Helper
each
, per elencare gli elementi presenti nel carrello. Ulteriori informazioni. - Helper
if
, per inserire una nota specifica per il prodotto se il prodotto correlato è nel carrello. Ulteriori informazioni.
➡️ Scopri come utilizzare le funzioni di assistenza in questo video
Prima di iniziare, assicurati di sapere come configurare questi elementi:
- Un evento unitario. Ulteriori informazioni.
- Un percorso che inizia con un evento. Ulteriori informazioni.
- Un messaggio e-mail nel percorso. Ulteriori informazioni
- Corpo di un’e-mail. Ulteriori informazioni.
Segui questi passaggi:
Passaggio 1: creare l’evento iniziale e il percorso correlato create-context
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.
-
Creare un evento il cui schema include l'array
productListItems
. -
Definisci tutti i campi di questo array come campi payload per questo evento.
Ulteriori informazioni sul tipo di dati dell'elemento dell'elenco prodotti nella documentazione di Adobe Experience Platform.
-
Crea un percorso che inizia con questo evento.
-
Aggiungi un'attività E-mail al percorso.
Passaggio 2: creare l’e-mail configure-email
-
Nell'attività E-mail, fai clic su Modifica contenuto, quindi 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.
Passaggio 3: inserire il nome del cliente in lettere maiuscole uppercase-function
-
Nella home page di E-mail Designer, fai clic sul componente HTML in cui desideri aggiungere il nome del cliente.
-
Sulla barra degli strumenti contestuale fare clic su Mostra codice sorgente.
-
Nella finestra Modifica HTML, aggiungi la funzione stringa
upperCase
:-
Nel menu a sinistra, seleziona Funzioni helper.
-
Utilizza il campo di ricerca per trovare "maiuscolo".
-
Aggiungere la funzione
upperCase
dai risultati della ricerca. A tale scopo, fare clic sul segno più (+) accanto a{%= upperCase(string) %}: string
.L’editor espressioni mostra questa espressione:
code language-handlebars {%= upperCase(string) %}
-
-
Rimuovi il segnaposto "stringa" dall’espressione.
-
Aggiungi il token di nome:
-
Nel menu a sinistra, seleziona Attributi del profilo.
-
Selezionare Persona > Nome completo.
-
Aggiungi il token First name all'espressione.
L’editor espressioni mostra questa espressione:
code language-handlebars {%= upperCase(profile.person.name.firstName) %}
Ulteriori informazioni sul tipo di dati del nome della persona nella documentazione di Adobe Experience Platform.
-
-
Fai clic su Convalida, quindi su Salva.
-
Salva il messaggio.
Passaggio 4: inserire l’elenco degli articoli dal carrello each-helper
-
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 fare clic su Mostra codice sorgente.
-
Nella finestra Modifica HTML, aggiungi l'helper
each
:-
Nel menu a sinistra, seleziona Funzioni helper.
-
Utilizza il campo di ricerca per trovare "ciascuno".
-
Aggiungere l'helper
each
dai risultati della ricerca.L’editor espressioni mostra questa espressione:
code language-handlebars {{#each someArray as |variable|}} {{/each}}
-
-
Aggiungere l'array
productListItems
all'espressione:-
Rimuovi il segnaposto "someArray" dall’espressione.
-
Nel menu a sinistra, seleziona Attributi contestuali.
Gli attributi contestuali sono disponibili solo dopo che il contesto di percorso è stato passato al messaggio.
-
Seleziona Journey Optimizer > Events > event_name, quindi espandi il nodo productListItems.
In questo esempio, nome_evento rappresenta il nome dell'evento.
-
Aggiungi il token Product all'espressione.
L’editor espressioni mostra questa espressione:
code language-handlebars {{#each context.journey.events.event_ID.productListItems.product as |variable|}} {{/each}}
In questo esempio, event_ID rappresenta l'ID dell'evento.
-
Modifica l’espressione:
- Rimuovi la stringa ".product".
- Sostituisci il segnaposto "variable" con "product".
Questo esempio mostra l’espressione modificata:
code language-handlebars {{#each context.journey.events.event_ID.productListItems as |product|}}
-
-
Incolla questo codice tra il tag di apertura
{{#each}}
e il tag di chiusura{/each}}
:code language-html <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:
- Rimuovere il segnaposto "#name" dalla tabella HTML.
- Dai risultati della ricerca precedente, aggiungi il token Name all'espressione.
Ripeti questi passaggi due volte:
- Sostituisci il segnaposto "#quantity" con il token Quantity.
- Sostituisci il segnaposto "#priceTotal" con il token Total price.
Questo esempio mostra l’espressione modificata:
code language-handlebars {{#each context.journey.events.event_ID.productListItems as |product|}} <table> <tbody> <tr> <td><b>{{product.name}}</b></td> <td><b>{{product.quantity}}</b></td> <td><b>${{product.priceTotal}}</b></td> </tr> </tbody> </table> {{/each}}
-
Fai clic su Convalida, quindi su Salva.
Passaggio 5: inserire una nota specifica per il prodotto if-helper
-
Nella home page di E-mail Designer, fai clic sul componente HTML in cui desideri inserire la nota.
-
Sulla barra degli strumenti contestuale fare clic su Mostra codice sorgente.
-
Nella finestra Modifica HTML, aggiungi l'helper
if
:-
Nel menu a sinistra, seleziona Funzioni helper.
-
Utilizza il campo di ricerca per trovare "if".
-
Aggiungere l'helper
if
dai risultati della ricerca.L’editor espressioni mostra questa espressione:
code language-handlebars {%#if condition1%} render_1 {%else if condition2%} render_2 {%else%} default_render {%/if%}
-
-
Rimuovi questa condizione dall’espressione:
code language-handlebars {%else if condition2%} render_2
Questo esempio mostra l’espressione modificata:
code language-handlebars {%#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 il nodo productListItems.
In questo esempio, nome_evento rappresenta il nome dell'evento.
-
Aggiungi il token Name all'espressione.
L’editor espressioni mostra questa espressione:
code language-handlebars {%#if context.journey.events.`event_ID`.productListItems.name%} render_1 {%else%} default_render {%/if%}
-
-
Modifica l’espressione:
-
Nell'editor espressioni specificare il nome del prodotto dopo il token
name
.Utilizza questa sintassi, in cui product_name rappresenta il nome del prodotto:
code language-javascript = "product_name"
In questo esempio, il nome del prodotto è "Juno Jacket":
code language-handlebars {%#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:
code language-handlebars {%#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.
-
-
Fai clic su Convalida, quindi su Salva.
-
Salva il messaggio.
Passaggio 6: testare e pubblicare il percorso test-and-publish
-
Attiva il Test, quindi fai clic su Attiva un evento.
-
Nella finestra Configurazione evento, immetti i valori di input, quindi fai 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.
Argomenti correlati related-topics
Funzioni Handlebars handlebars
Casi d’uso use-case
Video introduttivo video
Scopri come utilizzare le funzioni di assistenza.