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:
- Een eenheidsgebeurtenis. Meer informatie.
- Een reis die begint met een evenement. Meer informatie.
- Een e-mailbericht op reis. Meer informatie
- De hoofdtekst van een e-mail. Meer informatie.
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.
-
Maak een gebeurtenis waarvan het schema de
productListItems
array. -
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.
-
Maak een reis die met deze gebeurtenis begint.
-
Een E-mail activiteit van de reis.
Stap 2: Maak de e-mail configure-email
-
In de E-mail activiteit, klik Edit content en klik vervolgens op Email Designer.
-
Sleep in het linkerpalet van de introductiepagina E-mail Designer drie structuurcomponenten naar de hoofdtekst van het bericht.
-
Sleep een HTML-inhoudscomponent naar elke nieuwe structuurcomponent.
Stap 3: De voornaam van de klant invoegen in hoofdletters uppercase-function
-
Klik op de introductiepagina van E-mail Designer op de HTML-component waar u de voornaam van de klant wilt toevoegen.
-
Klik op de contextwerkbalk op Show the source code.
-
In de Edit HTML venster, voegt de
upperCase
string functie:-
Selecteer in het linkermenu de optie Helper functions.
-
Gebruik het zoekveld om naar hoofdletters en kleine letters te zoeken.
-
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) %}
-
-
Verwijder de tijdelijke aanduiding "tekenreeks" uit de expressie.
-
Voeg de token voor de voornaam toe:
-
Selecteer in het linkermenu de optie Profile attributes.
-
Selecteren Person > Full name.
-
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.
-
-
Klikken Validate en klik vervolgens op Save.
-
Sla het bericht op.
Stap 4: De lijst met artikelen uit het winkelwagentje invoegen each-helper
-
Open de inhoud van het bericht opnieuw.
-
Klik op de introductiepagina van E-mail Designer op de HTML-component waar u de inhoud van het winkelwagentje wilt weergeven.
-
Klik op de contextwerkbalk op Show the source code.
-
In de Edit HTML venster, voegt de
each
helper:-
Selecteer in het linkermenu de optie Helper functions.
-
Gebruik het zoekveld om "elk" te zoeken.
-
Voeg in de zoekresultaten de
each
helper.De redacteur van de Uitdrukking toont deze uitdrukking:
code language-handlebars {{#each someArray as |variable|}} {{/each}}
-
-
Voeg de
productListItems
array naar de expressie:-
Verwijder de tijdelijke aanduiding "someArray" uit de expressie.
-
Selecteer in het linkermenu de optie Contextual attributes.
Contextual attributes zijn pas beschikbaar nadat de reiscontext aan het bericht is doorgegeven.
-
Selecteren Journey Optimizer > Events > event_name, breid dan uit productListItems knooppunt.
In dit voorbeeld: event_name vertegenwoordigt de naam van uw gebeurtenis.
-
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.
-
De expressie wijzigen:
- Verwijder de tekenreeks ".product".
- 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|}}
-
-
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>
-
Voeg de personalisatietokens voor de puntnaam, het aantal, en de prijs toe:
- Verwijder de tijdelijke aanduiding "#name" uit de tabel HTML.
- 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}}
-
Klikken Validate en klik vervolgens op Save.
Stap 5: Een productspecifieke notitie invoegen if-helper
-
Klik op de startpagina van E-mailontwerper op de HTML-component waar u de notitie wilt invoegen.
-
Klik op de contextwerkbalk op Show the source code.
-
In de Edit HTML venster, voegt de
if
helper:-
Selecteer in het linkermenu de optie Helper functions.
-
Gebruik het zoekveld om te zoeken naar "if".
-
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%}
-
-
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%}
-
Voeg de token voor de productnaam toe aan de voorwaarde:
-
Verwijder de tijdelijke aanduiding "condition1" uit de expressie.
-
Selecteer in het linkermenu de optie Contextual attributes.
-
Selecteren Journey Orchestration > Events > event_name, breid dan uit productListItems knooppunt.
In dit voorbeeld: event_name vertegenwoordigt de naam van uw gebeurtenis.
-
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%}
-
-
De expressie wijzigen:
-
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%}
-
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%}
-
Verwijder de tijdelijke aanduiding "default_render" uit de expressie.
-
-
Klikken Validate en klik vervolgens op Save.
-
Sla het bericht op.
Stap 6: De reis testen en publiceren test-and-publish
-
De knop Test schakelen en vervolgens klikken Trigger an event.
-
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:
-
Controleer of er geen fout is en publiceer de reis.
Verwante onderwerpen related-topics
Handbalken, functies handlebars
Gebruik hoofdletters use-case
Hoe kan ik-video video
Leer hoe u hulpfuncties kunt gebruiken.