Gebruiksscenario voor persoonlijke voorkeur: e-mail met afstand van winkelwagentje personalization-use-case-helper-functions

In dit voorbeeld past u de hoofdtekst van een e-mailbericht aan. Dit bericht is bedoeld voor klanten die objecten in hun winkelwagentje hebben verlaten, maar hun aankoop niet hebben voltooid.

U gebruikt de volgende typen hulpfuncties:

  • De upperCase tekenreeksfunctie, om de voornaam van de klant in hoofdletters in te voegen. Meer informatie.
  • De each helper, om de punten te vermelden die in de kar zijn. Meer informatie.
  • De if helper, om een productspecifieke nota in te voegen als het verwante product in de kar is. Meer informatie.

➡️ Leer hoe u in deze video hulpfuncties kunt gebruiken

Alvorens u begint, zorg ervoor u weet hoe te om deze elementen te vormen:

Voer de volgende stappen uit:

Stap 1: Maak de eerste gebeurtenis en de bijbehorende reis create-context

De inhoud van het winkelwagentje is contextuele informatie van de reis. Daarom moet u een eerste gebeurtenis en de e-mail aan een reis toevoegen alvorens u kartspecifieke informatie aan e-mail kunt toevoegen.

  1. Maak een gebeurtenis waarvan het schema de productListItems array.

  2. Definieer alle velden in deze array als payload-velden voor deze gebeurtenis.

    Meer informatie over het gegevenstype van de productlijst vindt u in Adobe Experience Platform-documentatie.

  3. Maak een reis die met deze gebeurtenis begint.

  4. Een E-mail activiteit van de reis.

Stap 2: Maak de e-mail configure-email

  1. In de E-mail activiteit, klik Edit content en klik vervolgens op Email Designer.

  2. Sleep in het linkerpalet van de introductiepagina E-mail Designer drie structuurcomponenten naar de hoofdtekst van het bericht.

  3. Sleep een HTML-inhoudscomponent naar elke nieuwe structuurcomponent.

Stap 3: De voornaam van de klant invoegen in hoofdletters uppercase-function

  1. Klik op de introductiepagina van E-mail Designer op de HTML-component waar u de voornaam van de klant wilt toevoegen.

  2. Klik op de contextwerkbalk op Show the source code.

  3. In de Edit HTML venster, voegt de upperCase string functie:

    1. Selecteer in het linkermenu de optie Helper functions.

    2. Gebruik het zoekveld om naar hoofdletters en kleine letters te zoeken.

    3. Voeg in de zoekresultaten de upperCase functie. Klik hiertoe op het plusteken (+) naast {%= upperCase(string) %}: string.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

  4. Verwijder de tijdelijke aanduiding "tekenreeks" uit de expressie.

  5. Voeg de token voor de voornaam toe:

    1. Selecteer in het linkermenu de optie Profile attributes.

    2. Selecteren Person > Full name.

    3. Voeg de First name gebruiken voor de expressie.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

      Meer informatie over het gegevenstype Personen in Documentatie over de Adobe Experience Platform.

  6. Klikken Validate en klik vervolgens op Save.

  7. Sla het bericht op.

Stap 4: De lijst met artikelen uit het winkelwagentje invoegen each-helper

  1. Open de inhoud van het bericht opnieuw.

  2. Klik op de introductiepagina van E-mail Designer op de HTML-component waar u de inhoud van het winkelwagentje wilt weergeven.

  3. Klik op de contextwerkbalk op Show the source code.

  4. In de Edit HTML venster, voegt de each helper:

    1. Selecteer in het linkermenu de optie Helper functions.

    2. Gebruik het zoekveld om "elk" te zoeken.

    3. Voeg in de zoekresultaten de each helper.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

  5. Voeg de productListItems array naar de expressie:

    1. Verwijder de tijdelijke aanduiding "someArray" uit de expressie.

    2. Selecteer in het linkermenu de optie Contextual attributes.

      Contextual attributes zijn pas beschikbaar nadat de reiscontext aan het bericht is doorgegeven.

    3. Selecteren Journey Optimizer > Events > event_name, breid dan uit productListItems knooppunt.

      In dit voorbeeld: event_name vertegenwoordigt de naam van uw gebeurtenis.

    4. Voeg de Product gebruiken voor de expressie.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

      In dit voorbeeld: event_ID vertegenwoordigt de id van uw gebeurtenis.

    5. De expressie wijzigen:

      1. Verwijder de tekenreeks ".product".
      2. Vervang de tijdelijke aanduiding "variabele" door "product".

      In dit voorbeeld wordt de gewijzigde expressie getoond:

      code language-handlebars
      {{#each context.journey.events.event_ID.productListItems as |product|}}
      
  6. Deze code plakken tussen het openen {{#each}} en het sluiten {/each}} tag:

    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. Voeg de personalisatietokens voor de puntnaam, het aantal, en de prijs toe:

    1. Verwijder de tijdelijke aanduiding "#name" uit de tabel HTML.
    2. Voeg uit de vorige zoekresultaten de Name gebruiken voor de expressie.

    Herhaal deze stappen tweemaal:

    • Vervang de tijdelijke aanduiding "#quantity" door de Quantity token.
    • Vervang de tijdelijke aanduiding "#priceTotal" door de Total price token.

    In dit voorbeeld wordt de gewijzigde expressie getoond:

    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. Klikken Validate en klik vervolgens op Save.

Stap 5: Een productspecifieke notitie invoegen if-helper

  1. Klik op de startpagina van E-mailontwerper op de HTML-component waar u de notitie wilt invoegen.

  2. Klik op de contextwerkbalk op Show the source code.

  3. In de Edit HTML venster, voegt de if helper:

    1. Selecteer in het linkermenu de optie Helper functions.

    2. Gebruik het zoekveld om te zoeken naar "if".

    3. Voeg in de zoekresultaten de if helper.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

  4. Deze voorwaarde verwijderen uit de expressie:

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

    In dit voorbeeld wordt de gewijzigde expressie getoond:

    code language-handlebars
    {%#if condition1%} render_1
       {%else%} default_render
    {%/if%}
    
  5. Voeg de token voor de productnaam toe aan de voorwaarde:

    1. Verwijder de tijdelijke aanduiding "condition1" uit de expressie.

    2. Selecteer in het linkermenu de optie Contextual attributes.

    3. Selecteren Journey Orchestration > Events > event_name, breid dan uit productListItems knooppunt.

      In dit voorbeeld: event_name vertegenwoordigt de naam van uw gebeurtenis.

    4. Voeg de Name gebruiken voor de expressie.

      De redacteur van de Uitdrukking toont deze uitdrukking:

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

  6. De expressie wijzigen:

    1. Geef in de Expressieeditor de productnaam op na de naam name token.

      Gebruik deze syntaxis, waarbij product_name staat voor de naam van het product:

      code language-javascript
      = "product_name"
      

      In dit voorbeeld is de productnaam "Juno Jacket":

      code language-handlebars
      {%#if context.journey.events.`event_ID`.productListItems.name = "Juno Jacket" %}
         render_1
         {%else%} default_render
      {%/if%}
      
    2. Vervang de tijdelijke aanduiding "render_1" door de tekst van de notitie.

      Voorbeeld:

      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. Verwijder de tijdelijke aanduiding "default_render" uit de expressie.

  7. Klikken Validate en klik vervolgens op Save.

  8. Sla het bericht op.

Stap 6: De reis testen en publiceren test-and-publish

  1. De knop Test schakelen en vervolgens klikken Trigger an event.

  2. In de Event configuration -venster, voert u de invoerwaarden in en klikt u op Send.

    De testmodus werkt alleen met testprofielen.

    De e-mail wordt verzonden naar het adres van het testprofiel.

    In dit voorbeeld bevat de e-mail de opmerking over de Juno-jasje, omdat dit product zich in de kar bevindt:

  3. Controleer of er geen fout is en publiceer de reis.

Handbalken, functies handlebars

Gebruik hoofdletters use-case

Hoe kan ik-video video

Leer hoe u hulpfuncties kunt gebruiken.

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