DokumentationJourney OptimizerHandbuch für Journey Optimizer

Personalisierungssyntax personalization-syntax

Last update: Mon Apr 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Entwickler

Die Personalisierung in Journey Optimizer basiert auf der Vorlagensyntax „Handlebars“. Eine vollständige Beschreibung der Handlebars-Syntax finden Sie in der Dokumentation zu HandlebarsJS.

Sie verwendet eine Vorlage und ein Eingabeobjekt, um HTML oder andere Textformate zu generieren. Handlebars-Vorlagen sehen wie normaler Text mit eingebetteten Handlebars-Ausdrücken aus.

Beispiel für einen einfachen Ausdruck:

{{profile.person.name}}

Hier gilt:

  • profile ist ein Namespace.
  • person.name ist ein Token, das aus Attributen besteht. Die Attributstruktur wird in einem XDM-Schema von Adobe Experience Platform definiert. Weitere Informationen.

Allgemeine Syntaxregeln general-rules

  • Kennungen können beliebige Unicode-Zeichen sein, mit Ausnahme folgender Einschränkungen:

    code language-none 
    Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

  • Die Syntax unterscheidet zwischen Groß- und Kleinschreibung.

  • Die Wörter true, false, null und undefined sind nur im ersten Teil eines Pfadausdrucks zulässig.

  • In Handlebars werden den von {{expression}} zurückgegebenen Werten HTML-Escape-Zeichen hinzugefügt. Wenn der Ausdruck „&“ enthält, wird die Ausgabe mit HTML-Escape-Zeichen als „&amp;“ generiert. Wenn Sie eine Rückgabe der Werte ohne Escape-Zeichen wünschen, verwenden Sie dreifache geschweifte Klammern („Triple-Stash“).

  • Bezüglich der Argumente für literale Funktionen unterstützt der Sprach-Parser für Vorlagen keinen einfachen umgekehrten Schrägstrich (\), der nicht escaped ist. Dieses Zeichen muss mit einem zusätzlichen umgekehrten Schrägstrich (\) escaped werden. Beispiel:

    {%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

Verfügbare Namespaces namespaces

  • Profil

    Dieser Namespace erlaubt die Referenzierung aller im Profilschema definierten Attribute, die unter Dokumentation zum Datenmodell (XDM) von Adobe Experience Platform beschrieben werden.

    Die Attribute müssen im Schema definiert sein, damit sie in einem Personalisierungsblock in Journey Optimizer referenziert werden können.

    Weitere Informationen zur Verwendung von Profilattributen in Bedingungen finden Sie in diesem Abschnitt.

    accordion
    Beispielverweise
    • {{profile.person.name.fullName}}
    • {{profile.person.name.firstName}}
    • {{profile.person.gender}}
    • {{profile.personalEmail.address}}
    • {{profile.mobilePhone.number}}
    • {{profile.homeAddress.city}}
    • {{profile.faxPhone.number}}

  • Zielgruppe

    Weitere Informationen zum Segmentierungs-Service finden Sie in dieser Dokumentation.

  • Angebote

    In diesem Namespace können Sie bestehende Entscheidungen referenzieren.

    Um ein Angebot zu referenzieren, müssen Sie einen Pfad mit den verschiedenen Informationen angeben, die das Angebot definieren. Dieser Pfad weist die folgende Struktur auf:

    offers.Type.[Placement Id].[Activity Id].Attribute

    Hier gilt:

    • offers identifiziert den Pfadausdruck, der zum Angebots-Namespace gehört.
    • Type bestimmt den Typ der Angebotsdarstellung. Zu den möglichen Werten gehören image, html und text
    • Placement Id und Activity Id sind Platzierungs- und Aktivitätskennungen.
    • Attributes sind angebotsspezifische Attribute, die vom Angebotstyp abhängen. Beispiel: deliveryUrl für Bilder

    Weitere Informationen zur Entscheidungs-API und zu Angebotsdarstellungen finden Sie auf dieser Seite.

    Ein Validierungsmechanismus, der auf dieser Seite beschrieben wird, validiert alle Verweise anhand Angebotsschemas

    accordion
    Beispielverweise

    • Speicherort, an dem das Bild gehostet wird:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl

    • Ziel-URL beim Klicken auf das Bild:

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl

    • Text-Inhalt des Angebots aus der Entscheidungs-Engine:

      offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

    • HTML-Inhalt des Angebots aus der Entscheidungs-Engine:

      offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

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 Helper-Funktionen finden Sie in diesem Abschnitt.

Literaltypen literal-types

Adobe Journey Optimizer unterstützt die folgenden Literaltypen:

Literal
Definition
Zeichenfolge
Ein Datentyp, der aus Zeichen besteht, die von doppelten Anführungszeichen umgeben sind.
Beispiele: "prospect", "jobs", "articles"
Boolesch
Ein Datentyp, der entweder „true“ oder „false“ ist.
Ganzzahl
Ein Datentyp, der eine ganze Zahl darstellt. Sie kann positiv, negativ oder null sein.
Beispiele: -201, 0, 412
Array
Ein Datentyp, der aus einer Gruppe anderer Literalwerte besteht. Zur Gruppierung werden eckige Klammern und Kommas verwendet, um zwischen verschiedenen Werten zu trennen.
Hinweis: Sie können nicht direkt auf die Eigenschaften von Elementen in einem Array zugreifen.
Beispiele: [1, 4, 7], ["US", "FR"]
CAUTION
Die Variable xEvent ist in Personalisierungsausdrücken nicht verfügbar. Die Verwendung von xEvent führt zu Überprüfungsfehlern.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76