Personalization-exempel: e-post om att kunden överger en varukorg personalization-use-case-helper-functions

I det här exemplet anpassar du brödtexten i ett e-postmeddelande. Det här meddelandet riktar sig till kunder som har lämnat artiklar i kundvagnen men inte slutfört köpet.

Du använder följande typer av hjälpfunktioner:

  • Strängfunktionen upperCase som infogar kundens förnamn med versaler. Läs mer.
  • Hjälpprogrammet each som visar vilka objekt som finns i kundvagnen. Läs mer.
  • Hjälp if om du vill infoga en produktspecifik anteckning om den relaterade produkten finns i kundvagnen. Läs mer.

➡️ Lär dig använda hjälpfunktioner i den här videon

Innan du börjar bör du kontrollera hur du konfigurerar de här elementen:

  • En enastående händelse. Läs mer.
  • En resa som börjar med ett evenemang. Läs mer.
  • Ett e-postmeddelande under din resa. Läs mer
  • Innehållet i ett e-postmeddelande. Läs mer.

Följ de här stegen:

Steg 1: Skapa den inledande händelsen och den relaterade resan create-context

Kundvagnens innehåll är sammanhangsberoende information från resan. Därför måste du lägga till en första händelse och e-postmeddelandet till en resa innan du kan lägga till kundspecifik information i e-postmeddelandet.

  1. Skapa en händelse vars schema innehåller arrayen productListItems.

  2. Definiera alla fält från den här arrayen som nyttolastfält för den här händelsen.

    Läs mer om datatypen för produktlisteobjektet i Adobe Experience Platform-dokumentationen.

  3. Skapa en resa som börjar med det här evenemanget.

  4. Lägg till en e-postaktivitet på resan.

Steg 2: Skapa e-postmeddelandet configure-email

  1. Klicka på Edit content i aktiviteten E-post och sedan på Email Designer.

  2. Dra och släpp tre strukturkomponenter på meddelandets brödtext från den vänstra paletten på e-post-Designer hemsida.

  3. Dra och släpp en HTML-innehållskomponent på varje ny strukturkomponent.

Steg 3: Ange kundens förnamn med versaler uppercase-function

  1. Klicka på den HTML-komponent på Designer webbplats där du vill lägga till kundens förnamn.

  2. Klicka på Show the source code i det sammanhangsberoende verktygsfältet.

  3. Lägg till strängfunktionen upperCase i fönstret Edit HTML:

    1. Välj Helper functions på den vänstra menyn.

    2. Använd sökfältet för att hitta "versal case".

    3. Lägg till funktionen upperCase från sökresultaten. Det gör du genom att klicka på plustecknet (+) bredvid {%= upperCase(string) %}: string.

      Uttrycksredigeraren visar följande uttryck:

      code language-handlebars
      {%= upperCase(string) %}
      

  4. Ta bort platshållaren för strängen från uttrycket.

  5. Lägg till token för förnamn:

    1. Välj Profile attributes på den vänstra menyn.

    2. Välj Person > Full name.

    3. Lägg till First name-token i uttrycket.

      Uttrycksredigeraren visar följande uttryck:

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

      Läs mer om personnamnets datatyp i Adobe Experience Platform-dokumentationen.

  6. Klicka på Validate och sedan på Save.

  7. Spara meddelandet.

Steg 4: Infoga listan med artiklar från vagnen each-helper

  1. Öppna meddelandeinnehållet igen.

  2. På hemsidan för e-post till Designer klickar du på komponenten HTML där du vill visa kundvagnens innehåll.

  3. Klicka på Show the source code i det sammanhangsberoende verktygsfältet.

  4. Lägg till hjälpen för each i fönstret Edit HTML:

    1. Välj Helper functions på den vänstra menyn.

    2. Använd sökfältet för att hitta "each".

    3. Lägg till hjälpen för each från sökresultaten.

      Uttrycksredigeraren visar följande uttryck:

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

  5. Lägg till productListItems-arrayen i uttrycket:

    1. Ta bort platshållaren "someArray" från uttrycket.

    2. Välj Contextual attributes på den vänstra menyn.

      Contextual attributes är bara tillgängliga efter att resekontexten har skickats till meddelandet.

    3. Välj Journey Optimizer > Events > event_name och expandera sedan noden productListItems.

      I det här exemplet representerar event_name namnet på din händelse.

    4. Lägg till Product-token i uttrycket.

      Uttrycksredigeraren visar följande uttryck:

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

      I det här exemplet representerar event_ID händelsens ID.

    5. Ändra uttrycket:

      1. Ta bort strängen ".product".
      2. Ersätt platshållaren "variable" med "product".

      I det här exemplet visas det ändrade uttrycket:

      code language-handlebars
      {{#each context.journey.events.event_ID.productListItems as |product|}}
      
  6. Klistra in koden mellan den inledande {{#each}}-taggen och den avslutande {/each}}-taggen:

    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. Lägg till personaliseringstoken för artikelnamn, kvantitet och pris:

    1. Ta bort platshållaren "#name" från tabellen HTML.
    2. Lägg till Name-token i uttrycket från föregående sökresultat.

    Upprepa dessa steg två gånger:

    • Ersätt platshållaren #quantity med token Quantity.
    • Ersätt platshållaren #priceTotal med token Total price.

    I det här exemplet visas det ändrade uttrycket:

    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. Klicka på Validate och sedan på Save.

Steg 5: Infoga en produktspecifik anteckning if-helper

  1. Klicka på den HTML-komponent på Designer hemsida för e-post där du vill infoga anteckningen.

  2. Klicka på Show the source code i det sammanhangsberoende verktygsfältet.

  3. Lägg till hjälpen för if i fönstret Edit HTML:

    1. Välj Helper functions på den vänstra menyn.

    2. Använd sökfältet för att hitta "if".

    3. Lägg till hjälpen för if från sökresultaten.

      Uttrycksredigeraren visar följande uttryck:

      code language-handlebars
      {%#if condition1%} render_1
         {%else if condition2%} render_2
         {%else%} default_render
      {%/if%}
      

  4. Ta bort det här villkoret från uttrycket:

    code language-handlebars
    {%else if condition2%} render_2
    

    I det här exemplet visas det ändrade uttrycket:

    code language-handlebars
    {%#if condition1%} render_1
       {%else%} default_render
    {%/if%}
    
  5. Lägg till produktnamnstoken i villkoret:

    1. Ta bort platshållaren "condition1" från uttrycket.

    2. Välj Contextual attributes på den vänstra menyn.

    3. Välj Journey Orchestration > Events > event_name och expandera sedan noden productListItems.

      I det här exemplet representerar event_name namnet på din händelse.

    4. Lägg till Name-token i uttrycket.

      Uttrycksredigeraren visar följande uttryck:

      code language-handlebars
      {%#if context.journey.events.`event_ID`.productListItems.name%}
         render_1
         {%else%} default_render
      {%/if%}
      

  6. Ändra uttrycket:

    1. Ange produktnamnet efter name-token i uttrycksredigeraren.

      Använd den här syntaxen, där product_name representerar namnet på din produkt:

      code language-javascript
      = "product_name"
      

      I det här exemplet är produktnamnet"Juno Jacket":

      code language-handlebars
      {%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
         render_1
         {%else%} default_render
      {%/if%}
      
    2. Ersätt platshållaren "render_1" med texten i anteckningen.

      Exempel:

      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. Ta bort platshållaren "default_render" från uttrycket.

  7. Klicka på Validate och sedan på Save.

  8. Spara meddelandet.

Steg 6: Testa och publicera resan test-and-publish

  1. Aktivera växlingsknappen Test och klicka sedan på Trigger an event.

  2. I fönstret Event configuration anger du indatavärdena och klickar sedan på Send.

    Testläget fungerar bara med testprofiler.

    E-postadressen skickas till testprofilens adress.

    I det här exemplet innehåller e-postmeddelandet en anteckning om Juno Jacket eftersom den här produkten finns i varukorgen:

  3. Kontrollera att det inte finns något fel och publicera sedan resan.

Relaterade ämnen related-topics

Handtag, funktioner handlebars

Användningsfall use-case

Instruktionsvideo video

Lär dig hur du använder hjälpfunktioner.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76