DocumentazioneJourney OptimizerGuida di Journey Optimizer

Caso di utilizzo di Personalization: e-mail di abbandono del carrello personalization-use-case-helper-functions

Ultimo aggiornamento: 13 settembre 2026

Creato per:

  • Intermedio
  • Sviluppatore

In questa pagina: segui un caso di utilizzo di abbandono del carrello che personalizza un corpo dell’e-mail utilizzando le funzioni upperCase, each e if helper in Adobe Journey Optimizer.

style
shade-box

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:

➡️ Scopri come utilizzare le funzioni di assistenza in questo video

Prima di iniziare, assicurati di sapere come configurare questi elementi:

Segui questi passaggi:

  1. Creare l’evento iniziale e il percorso.
  2. Crea un messaggio e-mail.
  3. Inserire il nome del cliente in lettere maiuscole.
  4. Aggiungi il contenuto del carrello all’e-mail.
  5. Inserire una nota specifica per il prodotto.
  6. Verifica e pubblica il percorso.

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.

  1. Creare un evento il cui schema include l’array productListItems.

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

  3. Crea un percorso che inizia con questo evento.

  4. Aggiungi un’attività E-mail al percorso.

    Area di lavoro Percorso con un evento e un'attività e-mail nel flusso

Passaggio 2: creare l’e-mail configure-email

  1. Nell’attività E-mail, fai clic su Modifica contenuto, quindi su E-mail Designer.

    Attività e-mail con le opzioni Modifica contenuto e Invia e-mail a Designer

  2. Dalla palette a sinistra della home page di E-mail Designer, trascina e rilascia tre componenti struttura sul corpo del messaggio.

  3. Trascina e rilascia un componente di contenuto HTML su ciascun nuovo componente struttura.

    Invia un'e-mail a Designer con tre componenti struttura e componenti contenuto HTML nel corpo

Passaggio 3: inserire il nome del cliente in lettere maiuscole uppercase-function

  1. Nella home page di E-mail Designer, fai clic sul componente HTML in cui desideri aggiungere il nome del cliente.

  2. Sulla barra degli strumenti contestuale fare clic su Mostra codice sorgente.

    Barra degli strumenti contestuale con opzione Mostra codice sorgente

  3. Nella finestra Modifica HTML, aggiungi la funzione stringa upperCase:

    1. Nel menu a sinistra, seleziona Funzioni helper.

    2. Utilizza il campo di ricerca per trovare “maiuscolo”.

    3. 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) %}

      Editor espressioni con funzione upperCase selezionata nelle funzioni helper

  4. Rimuovi il segnaposto “stringa” dall’espressione.

  5. Aggiungi il token di nome:

    1. Nel menu a sinistra, seleziona Attributi del profilo.

    2. Selezionare Persona > Nome completo.

    3. Aggiungi il token First name all’espressione.

      L’editor espressioni mostra questa espressione:

      code language-handlebars 
      {%= upperCase(profile.person.name.firstName) %}

      L'editor espressioni mostra upperCase con token nome profilo

      Ulteriori informazioni sul tipo di dati del nome della persona nella documentazione di Adobe Experience Platform.

  6. Fai clic su Convalida, quindi su Salva.

    Modifica finestra di HTML con i pulsanti Convalida e Salva

  7. Salva il messaggio.

Passaggio 4: inserire l’elenco degli articoli dal carrello each-helper

Questo passaggio illustra l’iterazione dei dati dell’evento. Per esempi completi di iterazione su diverse origini dati (eventi, risposte alle azioni personalizzate e altri dati contestuali), vedere Iterare dati contestuali con Handlebars.

  1. Riapri il contenuto del messaggio.

  2. Nella pagina Home di E-mail Designer, fai clic sul componente HTML in cui desideri elencare il contenuto del carrello.

  3. Sulla barra degli strumenti contestuale fare clic su Mostra codice sorgente.

    Barra degli strumenti contestuale con opzione Mostra codice sorgente

  4. Nella finestra Modifica HTML, aggiungi l’helper each:

    1. Nel menu a sinistra, seleziona Funzioni helper.

    2. Utilizza il campo di ricerca per trovare “ciascuno”.

    3. Aggiungere l’helper each dai risultati della ricerca.

      L’editor espressioni mostra questa espressione:

      code language-handlebars 
      {{#each someArray as |variable|}} {{/each}}

      Editor espressioni con ogni modello helper

  5. Aggiungere l’array productListItems all’espressione:

    1. Rimuovi il segnaposto “someArray” dall’espressione.

    2. Nel menu a sinistra, seleziona Attributi contestuali.

      Gli attributi contestuali sono disponibili solo dopo che il contesto di percorso è stato passato al messaggio.

    3. Seleziona Journey Optimizer > Events > event_name, quindi espandi il nodo productListItems.

      In questo esempio, nome_evento rappresenta il nome dell’evento.

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

      Editor espressioni con productListItems negli attributi contestuali

    5. Modifica l’espressione:

      1. Rimuovi la stringa “.product”.
      2. Sostituisci il segnaposto “variable” con “product”.

      Questo esempio mostra l’espressione modificata:

      code language-handlebars 
      {{#each context.journey.events.event_ID.productListItems as |product|}}

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

  7. Aggiungi i token di personalizzazione per il nome dell’articolo, la quantità e il prezzo:

    1. Rimuovi il segnaposto “#name” dalla tabella HTML.
    2. 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}}

  8. Fai clic su Convalida, quindi su Salva.

    Editor espressioni con convalida e salvataggio dopo la configurazione di ogni blocco

Passaggio 5: inserire una nota specifica per il prodotto if-helper

  1. Nella home page di E-mail Designer, fai clic sul componente HTML in cui desideri inserire la nota.

  2. Sulla barra degli strumenti contestuale fare clic su Mostra codice sorgente.

    Barra degli strumenti contestuale con opzione Mostra codice sorgente

  3. Nella finestra Modifica HTML, aggiungi l’helper if:

    1. Nel menu a sinistra, seleziona Funzioni helper.

    2. Utilizza il campo di ricerca per trovare “if”.

    3. 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%}

      Editor espressioni con il modello helper if

  4. 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%}

  5. Aggiungi il token del nome del prodotto alla condizione:

    1. Rimuovi il segnaposto “condition1” dall’espressione.

    2. Nel menu a sinistra, seleziona Attributi contestuali.

    3. Seleziona Journey Orchestration > Events > event_name, quindi espandi il nodo productListItems.

      In questo esempio, nome_evento rappresenta il nome dell’evento.

    4. 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%}

      Editor espressioni con token di nome productListItems nella condizione if

  6. Modifica l’espressione:

    1. 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%}

    2. 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%}

    3. Rimuovi il segnaposto “default_render” dall’espressione.

  7. Fai clic su Convalida, quindi su Salva.

    Modifica la finestra di HTML con Convalida e salva dopo la configurazione del blocco if

  8. Salva il messaggio.

Passaggio 6: testare e pubblicare il percorso test-and-publish

  1. Attiva il Test, quindi fai clic su Attiva un evento.

    Percorso con attivazione test e attivazione pulsante evento

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

    Finestra di configurazione evento con valori di input e pulsante Invia

    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:

    E-mail di esempio che mostra la nota di spedizione della Giunone Jacket nel corpo del messaggio

  3. Verifica che non vi sia alcun errore, quindi pubblica il percorso.

Funzioni Handlebars handlebars

Casi d’uso use-case

Video introduttivo video

Scopri come utilizzare le funzioni di assistenza.

https://video.tv.adobe.com/v/3416645?captions=ita&quality=12&learn=on
AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page walks through a cart abandonment email use case using three helper functions — upperCase, each, and if — to display a customer’s first name in capitals, list cart items, and insert a product-specific shipping note conditionally.

Intents:

  • Create a journey event whose schema includes the productListItems array
  • Insert a customer’s first name in uppercase using {%= upperCase(profile.person.name.firstName) %}
  • List cart items by iterating over context.journey.events.event_ID.productListItems with {{#each}}
  • Display a product-specific note conditionally using {%#if context.journey.events.\event_ID`.productListItems.name = “product_name” %}`
  • Test the journey in test mode using a test profile with event payload, then publish

Glossary:

  • upperCase: A PQL string function that converts a string to uppercase; called with {%= upperCase(string) %}. (product-specific)
  • each helper: A Handlebars block helper ({{#each array as |alias|}} ... {{/each}}) that iterates over an array such as productListItems. (product-specific)
  • if helper: A conditional block helper ({%#if condition%} ... {%else%} ... {%/if%}) that renders content only when the specified condition is true.
  • productListItems: A standard XDM array representing cart contents, with fields including name, quantity, and priceTotal. (product-specific)
  • Test mode: A journey feature that enables sending test messages to test profile addresses to verify journey and message behavior before publication. (product-specific)

Guardrails:

  • Contextual attributes (including journey event data) are available in the personalization editor only after the message has been placed inside a journey that includes the relevant event.
  • Test mode works only with test profiles.

Terminology:

  • Canonical name: cart abandonment email — variants: cart abandonment use case
  • Do not confuse: context.journey.events.event_ID.productListItems (event-sourced array, accessed via Contextual attributes) ≠ profile.* attributes (profile-sourced, always available)

FAQ:

  • Q: What helper functions are used in this use case? — Three: upperCase (renders first name in capitals), each (iterates over the cart items array), and if (conditionally displays a product-specific shipping note).
  • Q: Where does the cart item data come from in the personalization expression? — From the journey event’s productListItems array, accessed via Contextual attributes at context.journey.events.event_ID.productListItems.
  • Q: Can contextual attributes be used before placing the message inside a journey? — No. Contextual attributes are available in the personalization editor only after the message is placed inside a journey that includes the relevant event.
  • Q: How do I test the email with cart data? — Turn on the Test toggle in the journey, click Trigger an event, and enter the input values in the Event configuration window, then click Send. The email is sent to the test profile’s address.
recommendation-more-help
journey-optimizer-help