Iterera över kontextuella data personalization-contexts

Lär dig hur du använder itereringssyntax för Handlebars för att visa dynamiska listor med data från olika källor i dina meddelanden, inklusive händelser, anpassade åtgärdssvar och andra sammanhangsbaserade data.

Översikt overview

Journey Optimizer ger åtkomst till kontextuella data från flera källor under meddelandepersonalisering. Du kan iterera över arrayer från dessa källor med hjälp av Handlebars-syntax i inbyggda kanaler (email, push, SMS) för att visa dynamiskt innehåll som produktlistor, rekommendationer eller andra upprepade element.

Tillgängliga sammanhangskällor:

Den här guiden visar hur du itererar över arrayer från var och en av dessa källor i dina meddelanden och hur du arbetar med arrayer när du konfigurerar reseaktiviteter. Börja med Hantera fält-itereringssyntax om du vill förstå grunderna för meddelandeanpassning, eller gå till Arbeta med arrayer i Journey-uttryck om du vill lära dig hur du skickar arraydata till anpassade åtgärder och datasetsökningar.

Syntax för iterering av Handlebars syntax

Hanteringsfält ger {{#each}} hjälpen som kan itereras över arrayer. Grundsyntaxen är:

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

Nyckelpunkter:

Iterera över händelsedata event-data

Händelsedata är tillgängliga när din resa aktiveras av en händelse. Detta är användbart för att visa data som hämtades när resan påbörjades, till exempel kundvagnsinnehåll, orderartiklar eller formulärinskickningar.

Kontextsökväg för händelser

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

Exempel: Skapa kundvagnsobjekt från en händelse

Om ditt händelseschema innehåller en productListItems-matris (standardformat XDM) kan du visa kundvagnens innehåll enligt exemplet nedan.

{{#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}}

Exempel: Kapslade arrayer i händelser

Använd kapslade {{#each}}-block för kapslade strukturer.

{{#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}}

Läs mer om kapsling i Bästa tillvägagångssätt.

Iterera över anpassade åtgärdssvar custom-action-responses

Anpassade åtgärder-svar innehåller data som returnerats från externa API-anrop. Detta är användbart när du vill visa realtidsinformation från dina system, t.ex. förmånspoäng, produktrekommendationer, lagerstatus eller personaliserade erbjudanden.

Kontextsökväg för anpassade åtgärder

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

Exempel: Produktrekommendationer från ett API

Om du vill iterera över en array med produktrekommendationer som returneras från en anpassad åtgärd och visa dem som enskilda kort i ditt meddelande, se exemplet nedan.

{
  "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>

Exempel: Kapslade arrayer från anpassade åtgärder

Om du vill iterera över ett anpassat åtgärdssvar som innehåller kapslade arrayer (en array med objekt där varje objekt innehåller en annan array), se exemplet nedan. Detta visar hur kapslade {{#each}}-slingor används för att få åtkomst till flera datanivåer.

{
  "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}}

Mer komplexa kapslingsmönster finns i Bästa tillvägagångssätt.

Exempel: Förmåner i bonusskiktet

Om du vill visa dynamiska fördelar baserat på lojalitetsstatus, se exemplet nedan.

{
  "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>

Iterera sökresultat för datauppsättningar dataset-lookup

Uppslagsaktiviteten för datauppsättningar gör att du kan hämta data från Adobe Experience Platform-datauppsättningar under körning. De inkapslade data lagras som en array och kan itereras över i dina meddelanden.

Läs mer om hur du konfigurerar uppslagsaktiviteten för datauppsättningar i det här avsnittet. Datauppsättningssökningen är särskilt kraftfull när den kombineras med händelsedata - se Exempel: Händelsedata som har berikats med datauppsättningssökning för ett praktiskt användningsexempel.

Kontextsökväg för datasökningar

context.journey.datasetLookup.<activityID>.entities

Exempel: Produktinformation från en datauppsättning

Om du använder en datauppslagsaktivitet för att hämta produktinformation baserat på SKU:er, se exemplet nedan.

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

Exempel: Filtrerad iteration med datauppsättningsdata

Om du vill filtrera sökresultat för datauppsättningar under upprepning och bara visa objekt som matchar specifika villkor (t.ex. produkter från en viss kategori) använder du villkorliga {{#if}}-satser i {{#each}} -slingan. Se exemplet nedan.

<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}}

Läs mer om villkorsstyrd filtrering i Bästa praxis.

Exempel: Beräkna summor från datauppsättningssökning

Om du vill beräkna och visa summor medan du itererar över datasetsökningsresultat, se exemplet nedan.

{% 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>

Använd resans tekniska egenskaper technical-properties

Resetekniska egenskaper ger åtkomst till metadata om körningen av resan, som rese-ID och kompletterande identifierare. Dessa kan vara användbara när de kombineras med iterationsmönster, särskilt för att filtrera arrayer baserat på specifika resinstanser.

Tillgängliga tekniska egenskaper

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

Exempel: Filtrera arrayobjekt med hjälp av tilläggsidentifierare

När du använder tilläggsidentifierare i händelseutlösta resor med matriser kan du filtrera så att bara den relevanta artikeln för den aktuella resinstansen visas. Läs mer om ytterligare identifierare i den här handboken.

Scenario: En resa aktiveras med flera bokningar, men du vill bara visa information för den specifika bokningen (identifieras med ett extra ID) som utlöste den här reseinstansen.

{{#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}}

Exempel: Inkludera rese-ID för spårning

Se exemplet nedan om du vill inkludera rese-ID:t i ditt meddelande för spårningsändamål.

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

Kombinera flera sammanhangskällor combine-sources

Ni kan kombinera data från olika källor i samma budskap för att skapa innehållsrika, personaliserade upplevelser. I det här avsnittet visas praktiska exempel på hur du använder flera sammanhangskällor tillsammans.

Kontextkällor som du kan kombinera:

Exempel: Kundvagnsartiklar med realtidslager

Se exemplet nedan om du vill kombinera händelsedata (kundvagnens innehåll) med anpassade åtgärdsdata (lagerstatus).

<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}}

Exempel: Händelsedata som har berikats med datasökning

Visa exemplet nedan om du vill kombinera händelse-SKU:er med detaljerad produktinformation från en dataset-sökning.

<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}}

Exempel: Kombinera flera källor med tekniska egenskaper

Se exemplet nedan om du vill kombinera flera sammanhangskällor (profildata, händelsedata, anpassade åtgärder och tekniska egenskaper) i ett enda meddelande.

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

Andra sammanhangstyper other-contexts

Den här guiden fokuserar på upprepning över arrayer, men det finns andra sammanhangstyper tillgängliga för personalisering som vanligtvis inte kräver upprepning. De här nås direkt i stället för att upprepas:

Fullständig personaliseringssyntax och exempel på hur du använder dessa källor finns i:

Arbeta med arrayer i Journey-uttryck arrays-in-journeys

I de föregående avsnitten fokuseras på att iterera över arrayer i meddelandepersonalisering med hjälp av Handlebars, men du arbetar också med arrayer när du konfigurerar reseaktiviteter. I det här avsnittet beskrivs hur du använder arraydata från händelser i Journey-uttryck, särskilt när du skickar data till anpassade åtgärder eller använder arrayer med datasetuppslag.

Skicka arrayvärden till anpassade åtgärdsparametrar arrays-to-custom-actions

När du konfigurerar anpassade åtgärder måste du ofta extrahera värden från händelsearrayer och skicka dem som parametrar. I det här avsnittet beskrivs vanliga mönster.

Läs mer om hur du skickar samlingar i Överför samlingar till anpassade åtgärdsparametrar.

Extrahera ett enskilt värde från en array

Använd fall: Hämta ett specifikt fält från en händelsearray som ska skickas som en frågeparameter i en GET-begäran.

{
  "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}

Skapa en lista med värden från en array

Använd skiftläge: Skapa en kommaavgränsad lista med ID:n som ska skickas som en frågeparameter (t.ex. /products?ids=sku1,sku2,sku3).

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

Överföra en array med objekt till en anpassad åtgärd

Använd skiftläge: Skicka en fullständig array med objekt i en begärandebrödtext (för POST eller GET med brödtext).

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

Använda arrayer med datasetsökningar arrays-with-dataset-lookup

När du använder uppslagsaktiviteten för datauppsättningar kan du skicka en array med värden som uppslagsnycklar för att hämta inkapslade data.

Exempel: Sök efter produktinformation för alla SKU:er i en händelsearray.

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

Begränsningar och mönster array-limitations

Tänk på dessa begränsningar när du arbetar med matriser under resor:

Ingen dynamisk slinga över matriser i reseflödet

Det går inte att skapa dynamiska slingor där en åtgärdsnod körs flera gånger för varje objekt i en array. Detta är avsiktligt för att förhindra prestandaproblem vid körning.

Vad du inte kan göra:

Rekommenderade mönster i stället:

Läs mer i Guardrutor och begränsningar.

Överväganden om matrisstorlek

Stora disksystem kan påverka resprestanda:

Fullständigt exempel: händelsematris till anpassad åtgärd complete-example

Här är ett komplett arbetsflöde som visar hur du använder en händelsearray med en anpassad åtgärd.

Scenario: När en användare överger sin kundvagn skickar du kundvagnsdata till ett externt rekommendations-API för att få anpassade förslag och visar dem sedan i ett e-postmeddelande.

{
  "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}}

Bästa praxis best-practices

Följ dessa metodtips när du itererar över kontextuella data för att skapa underhållande, högpresterande personalisering.

Använd beskrivande variabelnamn

Välj variabelnamn som tydligt anger vad du itererar över. Detta gör koden mer läsbar och enklare att underhålla. Läs mer om personaliseringssyntax:

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

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

Uttrycksfragment i slingor

När du använder uttrycksfragment i {{#each}} -slingor bör du vara medveten om att du inte kan skicka loopomfattade variabler som fragmentparametrar. Fragment kan dock komma åt globala variabler som är definierade i meddelandeinnehållet utanför fragmentet.

{% 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}}

Läs mer om att använda uttrycksfragment i slingor, inklusive detaljerade exempel och ytterligare tillfälliga lösningar.

Hantera tomma arrayer

Använd {{else}}-satsen för att tillhandahålla reservinnehåll när en matris är tom. Läs mer om hjälpfunktioner:

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

Kombinera med villkorliga hjälpmedel

Använd {{#if}} i slingor för villkorligt innehåll. Läs mer om villkorliga regler och se exempel i avsnitten Anpassade åtgärder och Datauppsättningssökning.

{{#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}}

Begränsa iteration för prestanda

För stora arrayer bör du överväga att begränsa antalet iterationer:

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

Åtkomst till arraymetadata

Handlebars innehåller speciella variabler i slingor som hjälper till med avancerade iterationsmönster:

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

Felsökning troubleshooting

Har du problem med upprepningen? I det här avsnittet beskrivs vanliga problem och lösningar.

Matrisen visas inte

Problem: Din arrayiteration visar inget innehåll.

Syntaxfel

Problem: Uttrycksvalideringen misslyckas eller meddelandet återges inte.

Uttrycksfragment fungerar inte i slingor

Problem: Ett uttrycksfragment visar inte förväntat innehåll när det används i en {{#each}}-slinga eller visar tomma/oväntade utdata.

Testa dina iterationer

Använd testläget ​ för resan för att verifiera dina iterationer. Detta är särskilt viktigt när du använder anpassade åtgärder eller datauppsättningssökningar:

Relaterade ämnen related-topics

Grundläggande om Personalization: Kom igång med personalisering | Lägg till personalisering | Personalization-syntax ​ | Hjälpfunktioner | Skapa villkorliga regler

Resekonfiguration: Om händelser | Konfigurera anpassade åtgärder | Skicka samlingar till anpassade åtgärdsparametrar | Använd API-anropssvar i anpassade åtgärder | Felsöka anpassade åtgärder | Använd Adobe Experience Platform-data på resor | Använd extra identifierare på resor | Skyddsritningar och begränsningar ​ | Testa din resa

Reseuttrycksfunktioner: Avancerad uttrycksredigerare | Funktioner för samlingshantering (först, alla, sist) | Listfunktioner (serializeList, filter, sort) | Arrayfunktioner (head, tail)

Användningsexempel för Personalization: E-post om att kunden har lämnat en kundvagn | Meddelande om orderstatus

Meddelandedesign: Kom igång med e-postdesign | Skapa push-meddelanden | Skapa SMS-meddelanden | Förhandsgranska och testa ditt innehåll