Personalization syntax personalization-syntax

På den här sidan: Lär dig mer om hanterarfält och PQL personaliseringssyntax i Adobe Journey Optimizer, inklusive allmänna regler, reserverade nyckelord, typtvång, tillgängliga namnutrymmen och bästa praxis.

Personalization i Journey Optimizer använder två kompletterande syntaxer som fungerar tillsammans i samma uttryck:

Att förstå vilket sammanhang du befinner dig i är avgörande för att undvika körningsfel. Ett PQL-funktionsanrop som placerats i {{...}} kommer till exempel att misslyckas eftersom Handlebars försöker att lösa det som en hjälp i stället för att utvärdera det som ett PQL-uttryck.

Exempel:

Attributstrukturen definieras i ett Adobe Experience Platform XDM-schema. Läs mer.

Allmänna syntaxregler general-rules

Reserverade nyckelord reserved-keywords

Vissa nyckelord är reserverade i Profile Query Language (PQL) och kan inte användas direkt som fält- eller variabelnamn i personaliseringsuttryck. Om XDM-schemat innehåller fält med namn som matchar reserverade nyckelord måste du undvika dem med hjälp av bakterier (`) för att referera till dem i dina uttryck.

Reserverade nyckelord är:

Exempel:

Om ditt profilschema har ett fält med namnet next måste du omsluta det med bakgrunder:

{{profile.person.`next`.name}}

Utan de här blocken misslyckas personaliseringsredigeraren med valideringen och ett fel inträffar.

PQL syntaxregler för specialattributnycklar pql-special-keys

Förutom reserverade nyckelord krävs ytterligare två fall för att undvika backtick i PQL-uttryck.

Avstavade attributnycklar hyphenated-keys

Om ditt XDM-schema innehåller fältnamn med bindestreck (t.ex. my-field, event-type) eller namn som börjar med eller innehåller siffror, radbryt nyckeln i bakslag i PQL-uttryck:

{%= profile.events.`order-total` > 100 %}

Om det inte finns några bakgrunder i ett PQL-uttryck tolkas bindestrecket som en subtraktionsoperator och orsakar ett syntaxfel i PQL.

Numeriska händelse-ID:n i kontextattribut numeric-event-ids

När kontexthändelseattribut refereras till där händelse-ID är ett tal (t.ex. 1697323153), radbryt den i backticks. Detta gäller även inuti funktioner som formatDate():

{% let ts = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy") %}
{{ts}}

Typtvång type-coercion

PQL är starkt typat. När värden jämförs eller skickas måste båda sidorna vara av samma typ. Vanliga fall:

Tillgängliga namnutrymmen namespaces

Hjälpmedel helpers-all

Handtag-hjälpen är en enkel identifierare som kan följas av parametrar. Varje parameter är ett Handlebars-uttryck. Hjälpprogrammen kan nås från alla sammanhang i en mall.

Dessa blockhjälpare identifieras av en # före hjälpnamnet och kräver en matchande avslutande / med samma namn.

Blocken är uttryck som har ett blocköppning ({{# }}) och stängning ({{/}}).

Mer information om hjälpfunktioner finns i det här avsnittet.

Literala typer literal-types

Adobe Journey Optimizer stöder följande literaltyper:

God praxis best-practices

Granska dessa syntaxregler innan du skapar personaliseringsuttryck. De flesta runtime-fel uppstår när du blandar handtag och PQL-kontexter.

Använd rätt villkorsstyrd blocksyntax

Använd alltid {%#if%} / {%else if%} / {%else%} / {%/if%}. Syntaxen {% if %} / {% elseif %} / {% endif %} stöds inte.

{%#if profile.loyalty.tier = "gold"%}
Gold member content
{%else if profile.loyalty.tier = "silver"%}
Silver member content
{%else%}
Default content
{%/if%}

Anropa inte PQL-funktioner i {{...}} Handlebars blocks

{{...}} löser endast hanterarfältsvariabler och hjälpprogram - det utvärderas inte av PQL. Om en PQL-funktion som upperCase() i {{...}} kapslas in uppstår felet"det gick inte att hitta hjälpen". Använd {%= ... %} i stället:

Använd ett namngivet loopalias när {{#each}} kombineras med{%#if%}

this.field löses av Handlebars-renderaren men inte av PQL-utvärderaren i ett {%#if%} -villkor. Definiera ett namngivet alias med as |item| så att båda kontexterna kan matcha fältet:

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Order {{order.id}} is pending.
  {%/if%}
{{/each}}

Tilldela PQL-funktionsresultat till en variabel innan slingor

PQL UDF som topN kan inte anropas direkt i {{#each}}. Utvärdera dem först med {% let %} och iterera sedan över resultatet:

{% let topOrders = topN(profile.orders, price, 3) %}
{{#each topOrders}}
  {{this.name}} — {{this.price}}€
{{/each}}

Använd {% let %} för att undvika upprepade funktionsanrop

När ett beräknat värde behövs mer än en gång, sparar du det i en variabel. Detta förbättrar läsbarheten och förhindrar överflödiga utvärderingar:

{% let cleanName = replaceAll(profile.person.name.firstName, "[^a-zA-Z]", "") %}
Hi {{cleanName}}, your code is: WELCOME-{%= upperCase(cleanName) %}

Använd rätt argumentordning fördateDiff

dateDiff(start, end) tar det tidigare datumet först. Om du vill beräkna återstående dagar till ett framtida datum skickar du aktuellt datum som det första argumentet:

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}

Använd = för likhetsjämförelser i PQL, inte==

PQL använder en enskild =-operator för likhet. Om du använder == uppstår ett syntaxfel.

Använd bakterier för avstavade fältnamn - endast i PQL-uttryck

Om ett XDM-schemafältnamn innehåller ett bindestreck (t.ex. order-total), radbryt det i bakslag för att förhindra att bindestrecket tolkas som en subtraktionsoperator. Detta stöds endast i {%= ... %} PQL-uttryck, inte i {{...}} Handlebars-block:

{%= profile.events.`order-total` > 100 %}

Mer information om färdiga uttryck som du kan kopiera direkt till ditt innehåll finns i Personalization recept.