Doorlopen van contextafhankelijke gegevens personalization-contexts

Leer hoe u de iteratiesyntaxis van Handlebars gebruikt om dynamische lijsten van gegevens uit diverse bronnen in uw berichten, met inbegrip van gebeurtenissen, de reacties van de douaneactie, en andere contextafhankelijke gegevens te tonen.

Overzicht overview

Journey Optimizer verleent toegang tot contextafhankelijke gegevens van veelvoudige bronnen tijdens ​ berichtverpersoonlijking ​. U kunt over series van deze bronnen herhalen gebruikend de syntaxis van Handlebars in inheemse kanalen (​ e-mail ​, ​ duw ​, ​ SMS ​) om dynamische inhoud zoals productlijsten, aanbevelingen, of andere herhalende elementen te tonen.

Beschikbare contextbronnen:

Deze gids toont u hoe te over series van elk van deze bronnen in uw berichten herhalen, en hoe te met series te werken wanneer het vormen van reisactiviteiten. Begin met ​ de iteratiesyntaxis van Handels ​ om de grondbeginselen van de berichtverpersoonlijking te begrijpen, of aan ​ het Werk met series in de uitdrukkingen van de Reis ​ te leren hoe te om seriegegevens tot douaneacties en datasetraadplegingen over te gaan.

Titeratiesyntaxis van werkbalken syntax

Handlebars verstrekt {{#each}} ​ helper ​ om over series te herhalen. De basissyntaxis is:

{{#each arrayPath as |item|}}
  <!-- Access item properties here -->
  {{item.property}}
{{/each}}

Zeer belangrijke punten:

Gegevens herhalen over gebeurtenissen event-data

De gegevens van de gebeurtenis zijn beschikbaar wanneer uw reis door een ​ gebeurtenis ​ wordt teweeggebracht. Dit is handig voor het weergeven van gegevens die zijn vastgelegd op het moment dat de reis werd gestart, zoals inhoud van het winkelwagentje, orderitems of formulierverzendingen.

Contextpad voor gebeurtenissen

context.journey.events.<event_ID>.<fieldPath>

context.journey.events.`1697323153`.fieldName

Voorbeeld: Items van een gebeurtenis starten

Als uw ​ gebeurtenisschema ​ a productListItems serie (standaard ​ formaat XDM ​) omvat, kunt u wortelinhoud zoals die in de steekproef hieronder wordt gedetailleerd tonen.

{{#each context.journey.events.event_ID.productListItems as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Quantity: {{product.quantity}}</p>
    <p>Price: ${{product.priceTotal}}</p>
  </div>
{{/each}}

Voorbeeld: Geneste arrays in gebeurtenissen

Gebruik geneste {{#each}} -blokken voor geneste structuren.

{{#each context.journey.events.event_ID.categories as |category|}}
  <h2>{{category.name}}</h2>
  <ul>
    {{#each category.items as |item|}}
      <li>{{item.title}}</li>
    {{/each}}
  </ul>
{{/each}}

Leer meer over het nesten in ​ Beste praktijken ​.

Doorlopen van aangepaste handelingsreacties custom-action-responses

​ de actie van de Douane ​ reacties bevatten gegevens die van externe API vraag zijn teruggekeerd. Dit is nuttig om informatie in real time van uw systemen, zoals loyaliteitspunten, productaanbevelingen, inventarisstatus, of gepersonaliseerde aanbiedingen te tonen.

Contextpad voor aangepaste handelingen

context.journey.actions.<actionName>.<fieldPath>

Voorbeeld: Productaanbevelingen van een API

Zie het onderstaande voorbeeld voor een herhaling over een array met productaanbevelingen die door een aangepaste handeling worden geretourneerd en om deze als afzonderlijke kaarten in uw bericht weer te geven.

{
  "recommendations": [
    {
      "productId": "12345",
      "productName": "Summer Jacket",
      "price": 89.99,
      "imageUrl": "https://example.com/jacket.jpg"
    },
    {
      "productId": "67890",
      "productName": "Running Shoes",
      "price": 129.99,
      "imageUrl": "https://example.com/shoes.jpg"
    }
  ]
}

<h2>Recommended for You</h2>
<div class="recommendations">
  {{#each context.journey.actions.GetRecommendations.recommendations as |item|}}
    <div class="product-card">
      <img src="{{item.imageUrl}}" alt="{{item.productName}}" />
      <h3>{{item.productName}}</h3>
      <p class="price">${{item.price}}</p>
    </div>
  {{/each}}
</div>

Voorbeeld: Geneste arrays van aangepaste handelingen

Zie het onderstaande voorbeeld voor herhaling over een aangepaste actierespons met geneste arrays (een array met objecten waarin elk object een andere array bevat). Dit demonstreert het gebruik van geneste {{#each}} lussen voor toegang tot meerdere gegevensniveaus.

{
  "id": "84632848268632",
  "responses": [
    { "productIDs": [1111, 2222, 3333] },
    { "productIDs": [4444, 5555, 6666] },
    { "productIDs": [7777, 8888, 9999] }
  ]
}

<h2>Product Groups</h2>
{{#each context.journey.actions.GetProducts.responses as |response|}}
  <div class="product-group">
    <ul>
      {{#each response.productIDs as |productID|}}
        <li>Product ID: {{productID}}</li>
      {{/each}}
    </ul>
  </div>
{{/each}}

Voor complexere het nestelen patronen, zie ​ Beste praktijken ​.

Voorbeeld: Beleggingsvoordelen

Zie het onderstaande voorbeeld voor dynamische voordelen die zijn gebaseerd op de status van loyaliteit.

{
  "loyaltyTier": "gold",
  "benefits": [
    { "name": "Free shipping", "icon": "truck" },
    { "name": "20% discount", "icon": "percent" },
    { "name": "Priority support", "icon": "headset" }
  ]
}

<h2>Your {{context.journey.actions.GetLoyaltyInfo.loyaltyTier}} Member Benefits</h2>
<ul class="benefits">
  {{#each context.journey.actions.GetLoyaltyInfo.benefits as |benefit|}}
    <li>
      <span class="icon-{{benefit.icon}}"></span>
      {{benefit.name}}
    </li>
  {{/each}}
</ul>

Doorlopen van zoekresultaten van gegevensset dataset-lookup

De ​ activiteit van de Opzoeken van de Dataset ​ staat u toe om gegevens van ​ datasets van Adobe Experience Platform ​ tijdens reis runtime terug te winnen. De verrijkte gegevens worden opgeslagen als een array en kunnen in uw berichten worden herhaald.

Leer meer over het vormen van de activiteit van de Lookup van de Dataset in ​ deze sectie ​. De raadpleging van de gegevensset is bijzonder krachtig wanneer gecombineerd met gebeurtenisgegevens - zie ​ Voorbeeld: Gebeurtenisgegevens verrijkt met datasetraadpleging ​ voor een praktisch gebruiksgeval.

Contextpad voor raadpleging van gegevenssets

context.journey.datasetLookup.<activityID>.entities

Voorbeeld: Productgegevens uit een gegevensset

Als u een activiteit van de Opzoekmachine van de Dataset gebruikt om productinformatie terug te winnen die op SKUs wordt gebaseerd, zie hieronder steekproef.

<h2>Product Details</h2>
<table>
  <thead>
    <tr>
      <th>Product Name</th>
      <th>Category</th>
      <th>Price</th>
    </tr>
  </thead>
  <tbody>
    {{#each context.journey.datasetLookup.3709000.entities as |product|}}
      <tr>
        <td>{{product.name}}</td>
        <td>{{product.category}}</td>
        <td>${{product.price}}</td>
      </tr>
    {{/each}}
  </tbody>
</table>

Voorbeeld: Gefilterde herhaling met gegevenssetgegevens

Gebruik voorwaardelijke {{#if}} instructies in uw {{#each}} -lus om zoekresultaten van datasets tijdens herhaling te filteren en alleen items weer te geven die aan specifieke criteria voldoen (bijvoorbeeld producten van een bepaalde categorie). Zie het onderstaande voorbeeld.

<h2>Household Products</h2>
{{#each context.journey.datasetLookup.3709000.entities as |product|}}
  {{#if product.category = "household"}}
    <div class="product">
      <h3>{{product.name}}</h3>
      <p>Price: ${{product.price}}</p>
    </div>
  {{/if}}
{{/each}}

Leer meer over voorwaardelijk filtreren in ​ Beste praktijken ​.

Voorbeeld: De totalen van de datasetraadpleging berekenen

Om totalen te berekenen en te tonen terwijl het herhalen over de resultaten van de datasetraadpleging, zie het voorbeeld hieronder.

{% let householdTotal = 0 %}
{{#each context.journey.datasetLookup.3709000.entities as |product|}}
  {%#if product.category = "household"%}
    {% let householdTotal = householdTotal + product.price %}
  {%/if%}
{{/each}}

<p>Your household products total: ${{householdTotal}}</p>

Technische eigenschappen van reis gebruiken technical-properties

De technische eigenschappen van de reis verlenen toegang tot meta-gegevens over de reisuitvoering, zoals reis ID en supplementaire herkenningstekens. Deze kunnen nuttig zijn wanneer gecombineerd met iteratiepatronen, vooral voor het filteren van arrays op basis van specifieke trajectinstanties.

Beschikbare technische eigenschappen

context.journey.technicalProperties.journeyUID
context.journey.technicalProperties.supplementalId

Voorbeeld: Matrixitems filteren met aanvullende id

Wanneer u aanvullende id’s gebruikt bij een door een gebeurtenis geïnitieerde reis met een array, kunt u filteren om alleen het relevante item voor de huidige reisinstantie weer te geven. Leer meer over supplementaire herkenningstekens in ​ deze gids ​.

Scenario: Een reis wordt teweeggebracht met veelvoudige boekingen, maar u wilt informatie slechts voor het specifieke boeken (die door supplementaire identiteitskaart wordt geïdentificeerd) tonen die deze reisinstantie teweegbracht.

{{#each context.journey.events.event_ID.bookingList as |booking|}}
  {%#if booking.bookingInfo.bookingNum = context.journey.technicalProperties.supplementalId%}
    <div class="booking-details">
      <h3>Your Booking: {{booking.bookingInfo.bookingNum}}</h3>
      <p>Destination: {{booking.bookingInfo.bookingCountry}}</p>
      <p>Date: {{booking.bookingInfo.bookingDate}}</p>
    </div>
  {%/if%}
{{/each}}

Voorbeeld: ID van reis opnemen voor tracering

Zie het onderstaande voorbeeld als u de reis-id in uw bericht wilt opnemen voor traceringsdoeleinden.

<footer>
  <p>Journey Reference: {{context.journey.technicalProperties.journeyUID}}</p>
</footer>

Meerdere contextbronnen combineren combine-sources

U kunt gegevens uit verschillende bronnen in het zelfde bericht combineren om rijke, gepersonaliseerde ervaringen tot stand te brengen. Deze sectie toont praktische voorbeelden om veelvoudige contextbronnen samen te gebruiken.

de bronnen van de context u kunt combineren:

Voorbeeld: Objecten winkelen met voorraad in real-time

Bekijk het onderstaande voorbeeld om gebeurtenisgegevens (inhoud van winkelwagentje) te combineren met aangepaste actiegegevens (voorraadstatus).

<h2>Your Cart</h2>
{{#each context.journey.events.cartEvent.productListItems as |product|}}
  <div class="cart-item">
    <h3>{{product.name}}</h3>
    <p>Quantity: {{product.quantity}}</p>
    <p>Price: ${{product.priceTotal}}</p>
  </div>
{{/each}}

<h2>We Also Recommend</h2>
{{#each context.journey.actions.GetRecommendations.items as |recommendation|}}
  <div class="recommendation">
    <h4>{{recommendation.name}}</h4>
    <p>${{recommendation.price}}</p>
    {{#if recommendation.inStock}}
      <span class="badge">In Stock</span>
    {{else}}
      <span class="badge out-of-stock">Out of Stock</span>
    {{/if}}
  </div>
{{/each}}

Voorbeeld: Gebeurtenisgegevens verrijkt met gegevenssetopzoekopdracht

Om ​ gebeurtenis SKUs ​ met gedetailleerde productinformatie van de raadpleging van de a ​ dataset ​ te combineren, bekijk hieronder de steekproef.

<h2>Your Order Details</h2>
{{#each context.journey.events.orderEvent.productListItems as |item|}}
  <div class="order-item">
    <p><strong>SKU:</strong> {{item.SKU}}</p>
    <p><strong>Quantity:</strong> {{item.quantity}}</p>

    <!-- Enrich with dataset lookup data -->
    {{#each context.journey.datasetLookup.1234567.entities as |enrichedProduct|}}
      {{#if enrichedProduct.SKU = item.SKU}}
        <p><strong>Product Name:</strong> {{enrichedProduct.name}}</p>
        <p><strong>Category:</strong> {{enrichedProduct.category}}</p>
        <img src="{{enrichedProduct.imageUrl}}" alt="{{enrichedProduct.name}}" />
      {{/if}}
    {{/each}}
  </div>
{{/each}}

Voorbeeld: Meerdere bronnen combineren met technische eigenschappen

Bekijk het onderstaande voorbeeld om meerdere contextbronnen (profielgegevens, gebeurtenisgegevens, aangepaste handelingen en technische eigenschappen) in één bericht te combineren.

<div class="personalized-content">
  <!-- Profile data -->
  <h1>Hello {{profile.person.name.firstName}},</h1>

  <!-- Event data iteration -->
  <h2>Your Recent Purchases</h2>
  {{#each context.journey.events.purchaseEvent.items as |purchase|}}
    <div class="purchase">
      <p>{{purchase.productName}} - ${{purchase.price}}</p>
    </div>
  {{/each}}

  <!-- Custom action response iteration -->
  <h2>Recommended for You</h2>
  {{#each context.journey.actions.GetPersonalizedRecs.recommendations as |rec|}}
    <div class="recommendation">
      <h3>{{rec.title}}</h3>
      <p>{{rec.description}}</p>
    </div>
  {{/each}}

  <!-- Technical properties -->
  <footer>
    <p class="fine-print">Journey ID: {{context.journey.technicalProperties.journeyUID}}</p>
  </footer>
</div>

Andere contexttypen other-contexts

Terwijl deze gids zich op herhaling over series concentreert, zijn andere contexttypes beschikbaar voor verpersoonlijking die typisch geen herhaling vereisen. Deze worden direct benaderd in plaats van via een lus te herhalen:

Voor volledige verpersoonlijkingssyntaxis en voorbeelden die deze bronnen gebruiken, verwijs naar:

Werken met arrays in Journey-expressies arrays-in-journeys

Terwijl de vorige secties zich bij herhaling over series in berichtverpersoonlijking gebruikend Handlebars concentreren, werkt u ook met series wanneer het vormen van reisactiviteiten. In deze sectie wordt uitgelegd hoe u arraygegevens uit gebeurtenissen in Journey-expressies kunt gebruiken, met name wanneer u gegevens doorgeeft aan aangepaste handelingen of wanneer u arrays met datasetlookups gebruikt.

Arraywaarden aan aangepaste actieparameters doorgeven arrays-to-custom-actions

Wanneer het vormen van ​ douaneacties ​, moet u vaak waarden uit gebeurtenisseries halen en hen als parameters overgaan. Deze sectie behandelt gemeenschappelijke patronen.

Leer meer over het overgaan van inzamelingen in ​ inzamelingen van de Pas in de parameters van de douaneactie ​.

Eén waarde uit een array extraheren

geval van het Gebruik: Haal een specifiek veld uit een gebeurtenisarray om als een queryparameter in een GET-aanvraag door te geven.

{
  "commerce": {
    "productListItems": [
      { "SKU": "SKU-1", "priceTotal": 10.0 },
      { "SKU": "SKU-2", "priceTotal": 0.0 },
      { "SKU": "SKU-3", "priceTotal": 20.0 }
    ]
  }
}

@event{YourEventName.commerce.productListItems.first(currentEventField.priceTotal > 0).SKU}

Een lijst met waarden op basis van een array maken

geval van het Gebruik: Maak een door komma’s gescheiden lijst met id’s die als een queryparameter moeten worden doorgegeven (bijvoorbeeld /products?ids=sku1,sku2,sku3 ).

serializeList(
  @event{YourEventName.commerce.productListItems.all(currentEventField.priceTotal > 0).SKU},
  ",",
  true
)

Een array van objecten doorgeven aan een aangepaste handeling

geval van het Gebruik: Een volledige array van objecten verzenden in een aanvraaginstantie (voor POST of GET met body).

{
  "ctxt": {
    "products": [
      {
        "id": "productA",
        "name": "Product A",
        "price": 20.1,
        "color": "blue"
      }
    ]
  }
}

Arrays met datasetraadplegingen gebruiken arrays-with-dataset-lookup

Wanneer het gebruiken van de ​ activiteit van de Lookup van de Dataset ​, kunt u een serie van waarden als raadplegingssleutels overgaan om verrijkte gegevens terug te winnen.

Voorbeeld: Zoek de productdetails voor alle SKU’s in een gebeurtenisarray op.

list(@event{purchaseEvent.productListItems.SKU})

Beperkingen en patronen array-limitations

Houd rekening met deze beperkingen wanneer u werkt met arrays in ritten:

Geen dynamische lusbewerking over arrays in transportflow

De reizen kunnen geen dynamische lijnen tot stand brengen waar één actieknooppunt veelvoudige tijden voor elk punt in een serie wordt uitgevoerd. Dit is bedoeld om problemen met runaway-prestaties te voorkomen.

wat u niet kunt doen:

Aanbevolen patronen in plaats daarvan:

Leer meer in ​ Grafieken en beperkingen ​.

Overwegingen voor arraygrootte

Grote arrays kunnen de reisprestaties beïnvloeden:

Volledig voorbeeld: Gebeurtenisarray naar aangepaste handeling complete-example

Hier volgt een volledige workflow waarin wordt getoond hoe u een gebeurtenisarray kunt gebruiken met een aangepaste handeling.

Scenario: Wanneer een gebruiker zijn winkelwagentje verlaat, stuurt hij de gegevens van het winkelwagentje naar een externe aanbeveling-API om persoonlijke suggesties te krijgen en geeft hij deze vervolgens weer in een e-mail.

{
  "cartItems": [
    {
      "sku": "string",
      "price": 0,
      "quantity": 0
    }
  ]
}

{
  "recommendations": [
    {
      "productId": "string",
      "productName": "string",
      "price": 0,
      "imageUrl": "string"
    }
  ]
}

<h2>We noticed you left these items in your cart</h2>
{{#each context.journey.events.cartAbandonment.productListItems as |item|}}
  <div class="cart-item">
    <p>{{item.name}} - Quantity: {{item.quantity}}</p>
  </div>
{{/each}}

<h2>You might also like</h2>
{{#each context.journey.actions.GetCartRecommendations.recommendations as |rec|}}
  <div class="recommendation">
    <img src="{{rec.imageUrl}}" alt="{{rec.productName}}" />
    <h3>{{rec.productName}}</h3>
    <p>${{rec.price}}</p>
  </div>
{{/each}}

Aanbevolen procedures best-practices

Volg deze tips en trucs bij het doorlopen van contextuele gegevens om een onderhoudsvriendelijke, krachtige personalisatie te maken.

Beschrijvende variabelenamen gebruiken

Kies variabelenamen die duidelijk aangeven waar u doorheen gaat. Hierdoor wordt uw code beter leesbaar en eenvoudiger te onderhouden. Leer meer over ​ verpersoonlijkingssyntaxis ​:

<!-- Good -->
{{#each products as |product|}}
{{#each users as |user|}}
{{#each recommendations as |recommendation|}}

<!-- Less clear -->
{{#each items as |item|}}
{{#each array as |element|}}

Fragmenten in lussen uitdrukken

Wanneer het gebruiken van ​ uitdrukkingsfragmenten ​ binnen {{#each}} lijnen, ben zich ervan bewust dat u geen lijn-scoped variabelen als fragmentparameters kunt overgaan. Fragmenten kunnen echter toegang krijgen tot algemene variabelen die buiten het fragment in de berichtinhoud zijn gedefinieerd.

{% let globalDiscount = 15 %}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    {{fragment id='ajo:fragment123/variant456' mode='inline'}}
  </div>
{{/each}}

{{#each products as |product|}}
  <!-- This will NOT work as expected -->
  {{fragment id='ajo:fragment123/variant456' currentProduct=product}}
{{/each}}

Leer meer over ​ het gebruiken van uitdrukkingsfragmenten binnen lijnen ​, met inbegrip van gedetailleerde voorbeelden en extra aanraakpunten.

Lege arrays verwerken

Gebruik de component {{else}} om fallback-inhoud op te geven wanneer een array leeg is. Leer meer over ​ helperfuncties ​:

{{#each context.journey.actions.GetRecommendations.items as |item|}}
  <div>{{item.name}}</div>
{{else}}
  <p>No recommendations available at this time.</p>
{{/each}}

Combineren met voorwaardelijke hulplijnen

Gebruik {{#if}} binnen lussen voor voorwaardelijke inhoud. Leer meer over ​ voorwaardelijke regels ​ en zie voorbeelden in ​ de actieresultaten van de Douane ​ en ​ de raadplegings ​ secties van de Dataset.

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    {{#if product.onSale}}
      <span class="badge">On Sale!</span>
    {{/if}}
    {{#if product.newArrival}}
      <span class="badge">New</span>
    {{/if}}
  </div>
{{/each}}

Herhaling van prestaties beperken

Bij grote arrays kunt u het aantal herhalingen beperken:

<!-- Display only first 5 items -->
{{#each context.journey.actions.GetProducts.items as |product|}}
  {{#if @index < 5}}
    <div>{{product.name}}</div>
  {{/if}}
{{/each}}

Metagegevens van arrays openen

Handlebars verstrekt speciale variabelen binnen lijnen die met geavanceerde iteratiepatronen helpen:

{{#each products as |product|}}
  <div class="product {{#if @first}}featured{{/if}}">
    {{@index}}. {{product.name}}
  </div>
{{/each}}

Problemen oplossen troubleshooting

Heb je problemen met iteratie? In deze sectie worden gemeenschappelijke problemen en oplossingen besproken.

Array wordt niet weergegeven

Uitgave: De arrayherhaling geeft geen inhoud weer.

Syntaxisfouten

Uitgave: Validatie van expressie mislukt of bericht wordt niet gerenderd.

Expressiefragmenten werken niet in lussen

Uitgave: Een expressiefragment geeft geen verwachte inhoud weer wanneer het wordt gebruikt in een {{#each}} -lus, of toont lege/onverwachte uitvoer.

Uw herhalingen testen

Gebruik 🔗 de wijze van de 0} reistest om uw herhalingen te verifiëren. Dit is vooral belangrijk wanneer het gebruiken van ​ douaneacties ​ of ​ datasetraadplegingen ​:

Verwante onderwerpen related-topics

fundamentals van Personalization: ​ begonnen met verpersoonlijking ​ | ​ voeg verpersoonlijking ​ toe | ​ syntaxis van Personalization ​ | ​ Helperfuncties ​ | ​ creeer voorwaardelijke regels ​

configuratie van de Reis: ​ Ongeveer gebeurtenissen ​ | ​ Vorm douaneacties ​ | ​ de inzamelingen van de pas in de parameters van de douaneactie ​ | ​ API van het gebruik vraagreacties in douaneacties ​ | ​ los uw douaneacties ​ problemen op | ​ de gegevens van Adobe Experience Platform van het Gebruik in reizen ​ | ​ Aanvullende herkenningstekens van het Gebruik in reizen ​ | ​ Grafieken en beperkingen ​ | ​ Test uw reis ​

de uitdrukkingsfuncties van de Reis: ​ Geavanceerde uitdrukkingsredacteur ​ | ​ het beheersfuncties van de Inzameling ​ (eerst, allen, laatste) | ​ de functies van de Lijst ​ (serializeList, filter, soort) | ​ de functies van de Serie ​ (hoofd, staart)

Personalization gebruiksgevallen: ​ de verlaten e-mail van de Kunst ​ | ​ de statusbericht van de Orde ​

ontwerp van het Bericht: ​ begonnen met e-mailontwerp ​ | ​ creeer dupberichten ​ | ​ creeer SMS berichten ​ | ​ Voorproef en test uw inhoud ​