Personalisierungssyntax personalization-syntax

Auf dieser Seite: Erfahren Sie mehr über die Handlebars- und PQL-Personalisierungssyntax in Adobe Journey Optimizer, einschließlich allgemeiner Regeln, reservierter Keywords, Typzwang, verfügbarer Namespaces und Best Practices.

Personalization in Journey Optimizer verwendet zwei komplementäre Syntaxen, die im selben Ausdruck zusammenarbeiten:

Um Laufzeitfehler zu vermeiden, ist es von entscheidender Bedeutung zu verstehen, in welchem Kontext Sie sich befinden. Beispielsweise schlägt ein in {{...}} platzierter PQL-Funktionsaufruf fehl, weil Handlebars versucht, ihn als Helper aufzulösen, anstatt ihn als PQL-Ausdruck zu bewerten.

Beispiele:

Die Attributstruktur wird in einem XDM-Schema von Adobe Experience Platform definiert. Weitere Informationen.

Allgemeine Syntaxregeln general-rules

Reservierte Keywords reserved-keywords

Bestimmte Keywords sind in Profile Query Language (PQL) reserviert und können nicht direkt als Feld- oder Variablennamen in Personalisierungsausdrücken verwendet werden. Wenn Ihr XDM-Schema Felder mit Namen enthält, die reservierten Keywords entsprechen, müssen Sie diese mit Backticks (`) maskieren, wenn Sie in Ihren Ausdrücken darauf verweisen möchten.

Zu den reservierten Keywords zählen:

Beispiel:

Wenn Ihr Profilschema ein Feld mit dem Namen next enthält, müssen Sie es in Backticks einschließen:

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

Ohne die Backticks gibt die Validierung des Personalisierungseditors einen Fehler zurück.

PQL-Syntaxregeln für spezielle Attributschlüssel pql-special-keys

Neben reservierten Keywords erfordern zwei zusätzliche Fälle Backtick-Escaping in PQL-Ausdrücken.

Getrennte Attributschlüssel hyphenated-keys

Wenn Ihr XDM-Schema Feldnamen mit Bindestrichen (z. B. my-field, event-type) oder Namen enthält, die mit Zahlen beginnen oder Zahlen enthalten, schließen Sie den Schlüssel in Backticks in PQL-Ausdrücken ein:

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

Ohne Backticks in einem PQL-Ausdruck wird der Bindestrich als Subtraktionsoperator interpretiert und verursacht einen PQL-Syntaxfehler.

Numerische Ereignis-IDs in Kontextattributen numeric-event-ids

Wenn Sie auf Kontextereignisattribute verweisen, bei denen die Ereignis-ID eine Zahl ist (z. B. 1697323153), schließen Sie sie in Backticks ein. Dies gilt auch für Funktionen wie formatDate():

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

Typzwang type-coercion

PQL ist stark typisiert. Beim Vergleichen oder Übergeben von Werten müssen beide Seiten vom gleichen Typ sein. Häufige Fälle:

Verfügbare Namespaces namespaces

Helper helpers-all

Ein Handlebars-Helper ist eine einfache Kennung, auf die Parameter folgen können. Jeder Parameter ist ein Handlebars-Ausdruck. Helper können in jedem Kontext einer Vorlage aufgerufen werden.

Diese Block-Helper werden durch ein # am Anfang des Helper-Namens gekennzeichnet und erfordern einen passenden schließenden / am Ende des Namens.

Blöcke sind Ausdrücke mit einer Blockeröffnung ({{# }}) und schließendem ({{/}}).

Weitere Informationen zu Hilfsfunktionen finden Sie diesem Abschnitt.

Literaltypen literal-types

Adobe Journey Optimizer unterstützt die folgenden Literaltypen:

Best Practices best-practices

Überprüfen Sie diese Syntaxregeln, bevor Sie Personalisierungsausdrücke erstellen. Die meisten Laufzeitfehler rühren aus der Vermischung von Handlebars- und PQL-Kontexten her.

Verwenden Sie die richtige Syntax für bedingte Blöcke

Verwenden Sie immer {%#if%} / {%else if%} / {%else%} / {%/if%}. Die Syntax {% if %} / {% elseif %} / {% endif %} wird nicht unterstützt.

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

Rufen Sie keine PQL-Funktionen in {{...}} Handlebars-Blöcken auf

{{...}} löst nur Handlebars-Variablen und -Helfer auf - es wird PQL nicht ausgewertet. Das Umschließen einer PQL-Funktion wie upperCase() in {{...}} verursacht den Fehler „Helper konnte nicht gefunden werden“. Verwenden Sie stattdessen {%= ... %}:

Verwenden eines Alias für eine benannte Schleife beim Kombinieren von {{#each}} mit{%#if%}

this.field wird vom Handlebars-Renderer aufgelöst, nicht jedoch vom PQL-Auswerter innerhalb einer {%#if%}. Definieren Sie einen benannten Alias mit as |item|, damit beide Kontexte das Feld auflösen können:

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

Weisen Sie einer Variablen vor der Schleife Ergebnisse der PQL-Funktion zu

PQL-UDFs wie topN können nicht direkt in {{#each}} aufgerufen werden. Bewerten Sie sie zunächst mit {% let %} und durchlaufen Sie dann das Ergebnis:

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

Verwenden Sie {% let %}, um zu vermeiden, dass Funktionsaufrufe wiederholt werden

Wenn ein berechneter Wert mehrmals benötigt wird, speichern Sie ihn in einer Variablen. Dies verbessert die Lesbarkeit und verhindert redundante Auswertungen:

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

Verwenden Sie die richtige Argumentreihenfolge fürdateDiff

dateDiff(start, end) nimmt das frühere Datum zuerst. Um die bis zu einem zukünftigen Datum verbleibenden Tage zu berechnen, übergeben Sie das aktuelle Datum als erstes Argument:

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

Verwenden von = für Gleichheitsvergleiche in PQL, nicht==

PQL verwendet für Gleichheit einen einzelnen =. Die Verwendung von == führt zu einem Syntaxfehler.

Backticks für Feldnamen mit Bindestrichen verwenden - nur in PQL-Ausdrücken

Wenn ein XDM-Schemafeldname einen Bindestrich enthält (z. B. order-total), schließen Sie ihn in Backticks ein, um zu verhindern, dass der Bindestrich als Subtraktionsoperator geparst wird. Dies wird nur innerhalb {%= ... %} PQL-Ausdrücke unterstützt, nicht in {{...}} Handlebars-Blöcken:

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

Gebrauchsfertige Ausdrücke, die Sie direkt in Ihren Inhalt kopieren können, finden Sie unter Personalization-Rezepte.