Personalisierungsrezepte personalization-recipes

Auf dieser Seite finden Sie einsatzbereite Personalisierungsrezepte für Datumsangaben, Arrays, Zeichenfolgen, bedingte Logik und PQL-Edge-Fälle, die Sie direkt in Ihren Adobe Journey Optimizer-Inhalt kopieren können.

Auf dieser Seite finden Sie einsatzbereite Personalisierungsmuster für die häufigsten Anwendungsfälle in Adobe Journey Optimizer. Alle Beispiele verwenden die Syntax des Personalisierungseditors und können direkt in E-Mail-, SMS- oder Push-Inhalte kopiert werden.

Eine vollständige Übersicht der verfügbaren Funktionen finden Sie unter Hilfsfunktionen, Datums-/, Zeichenfolgenfunktionen und Array-Funktionen.

Rezepte für Datum und Uhrzeit date-time-recipes

Rezept 1 - Zeigt das aktuelle Datum in einem lesbaren Format an recipe-current-date

Verwenden Sie formatDate mit getCurrentZonedDateTime(), um das heutige Datum in einem beliebigen Format wiederzugeben:

{%= formatDate(getCurrentZonedDateTime(), "MMMM dd, yyyy") %}

Ausgabe (Beispiel): April 11, 2026

Allgemeine Formatmuster:

Rezept 2 — Countdown bis zu einem Ablauf- oder Ereignisdatum recipe-countdown

Verwenden Sie dateDiff, um die Anzahl der verbleibenden Tage bis zu einem Profildatumsattribut zu berechnen und es dann dynamisch zu rendern:

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}
{%#if daysLeft > 0%}
Your reward points expire in {{daysLeft}} day{%#if daysLeft > 1%}s{%/if%}. Use them before they're gone!
{%else%}
Your reward points have expired.
{%/if%}

Ausgabe (Beispiel): Your reward points expire in 7 days. Use them before they're gone!

Rezept 3 - X Tage vor einem dynamischen Enddatum recipe-days-before

Um ein Datum zu berechnen, das X Tage vor einem Profilattribut liegt (z. B. um in Inhalt oder Betreffzeilen zu referenzieren), verwenden Sie addDays mit einem negativen Offset:

{%= formatDate(addDays(stringToDate(profile.subscription.endDate), -7), "MMMM dd, yyyy") %}

Ausgabe (Beispiel): April 04, 2026 (7 Tage vor dem 11. April)

Um auch eine feste Tageszeit festzulegen (z. B. 9 Uhr), kombinieren Sie mit setHours:

{%= formatDate(setHours(addDays(stringToDate(profile.subscription.endDate), -7), 9), "dd/MM/yyyy HH:mm") %}

Rezept 4 — Aktuelle Zeit nur als HH:MM anzeigen recipe-time-only

Verwenden Sie extractHours und extractMinutes, um nur den Zeitanteil anzuzeigen, mit einem Schutzmechanismus mit führender Null für Minuten:

{% let h = extractHours(getCurrentZonedDateTime()) %}
{% let m = extractMinutes(getCurrentZonedDateTime()) %}
Your appointment is at {{h}}:{%#if m < 10%}0{%/if%}{{m}}.

Ausgabe (Beispiel): Your appointment is at 14:05.

Rezept 5 - Wochenende vs. Wochentag erkennen recipe-weekend

Verwenden Sie dayOfWeek , um Inhalte auf der Grundlage des Tages anzupassen. Die Funktion gibt 1 (Montag) bis 7 (Sonntag) zurück. Verwenden Sie den = Operator (PQL-Syntax, nicht ==):

{%#if dayOfWeek(getCurrentZonedDateTime()) = 6 or dayOfWeek(getCurrentZonedDateTime()) = 7%}
We're closed on weekends — our team will follow up on the next business day.
{%else%}
Our team will get back to you within 24 hours.
{%/if%}

Array- und Schleifenrezepte array-recipes

Rezept 6 - Listet alle Elemente aus einem Profil-Array auf recipe-list-items

Verwenden Sie {{#each}} , um über ein Profil-Array zu iterieren und jedes Element zu rendern. Dies ist nur im Personalisierungseditor (E-Mail, SMS, Push) verfügbar:

{{#each profile.purchases.recentItems}}
  - {{this.name}}: {{this.price}}€
{{/each}}

Ausgabe (Beispiel):

- Running shoes: 89€
- Water bottle: 15€
- Gym bag: 45€

Rezept 7 - Zeigt die Top N Elemente aus einem Array nach Preis recipe-first-n

Verwenden Sie topN , um die Top-N-Elemente nach einem numerischen Feld zu sortieren und abzurufen. Da topN eine PQL-Funktion ist, weisen Sie sie zuerst mit {% let %} einer Variablen zu und dann mit {{#each}}:

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

Oder verwenden Sie head, um nur das oberste Element abzurufen:

{%= head(profile.purchases.recentItems).name %}

Rezept 8 - Inhalt bedingt pro Array-Element rendern recipe-conditional-loop

Verwenden Sie {%#if%} in {{#each}}, um die Ausgabe nur für übereinstimmende Elemente zu rendern. Definieren Sie einen Schleifenalias mit as |order|, damit der PQL-Auswerter den Attributverweis in der Bedingung auflösen kann:

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Order {{order.id}} is pending — we'll notify you when it ships.
  {%/if%}
{{/each}}

Zeichenfolgen- und Formatierungsrezepte string-recipes

Rezept 9 - Eine Zeichenfolge mit replaceAll reinigen und wiederverwenden recipe-replaceall-reuse

replaceAll gibt einen neuen Wert zurück - das Original wird nicht geändert. Verwenden Sie {% let %}, um das Ergebnis zu speichern und mehrmals darauf zu verweisen, ohne den Funktionsaufruf zu wiederholen:

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

Ausgabe (Beispiel):

Hi John,
Your exclusive code is: WELCOME-JOHN

Rezept 10 - Einen Wert in der JSON-Ausgabe doppelt angeben recipe-json-quotes

Um ein literales doppeltes Anführungszeichen in eine Zeichenfolge einzuschließen (z. B. um JSON für eine benutzerdefinierte Payload zu generieren), Escape-Zeichen mit einem umgekehrten Schrägstrich (\"):

{ "greeting": "Hello \"{{profile.person.name.firstName}}\"" }

Ausgabe: { "greeting": "Hello \"John\"" }

Rezept 11 - Formatieren einer Datumskomponente in Großbuchstaben recipe-uppercase-date

Kombinieren Sie formatDate mit upperCase, um Monats- oder Tagesnamen in Großbuchstaben zu ändern:

{%= upperCase(formatDate(getCurrentZonedDateTime(), "MMMM")) %}

Ausgabe (Beispiel): APRIL

Für eine vollständige Datumszeichenfolge in Großbuchstaben:

{%= upperCase(formatDate(profile.person.birthDateTime, "EEEE MMMM dd yyyy")) %}

Ausgabe (Beispiel): WEDNESDAY JANUARY 01 2020

Bedingte Logik - Rezepte conditional-recipes

Rezept 12 — IF/ELSEIF/ELSE in personalisierten Inhalten recipe-if-elseif

Verwenden Sie {%#if%}, {%else if%} und {%else%} für eine bedingte Logik mit mehreren Verzweigungen. Dieses Muster funktioniert in E-Mail-Inhalten und -Fragmenten:

{%#if profile.loyalty.tier = "gold"%}
As a Gold member, enjoy free shipping on all orders.
{%else if profile.loyalty.tier = "silver"%}
As a Silver member, enjoy free shipping on orders over €50.
{%else%}
Join our loyalty program to unlock exclusive benefits.
{%/if%}

Rezept 13 — Null-Safe-Attributanzeige recipe-null-safe

Verwenden Sie ein bedingtes Fallback, um zu vermeiden, dass leere Werte gerendert werden, wenn ein Profilattribut null sein kann oder fehlt:

{%#if profile.person.name.firstName%}
Hi {{profile.person.name.firstName}},
{%else%}
Hi there,
{%/if%}

Oder inline mit einem Muster im ternären Stil unter Verwendung von isEmpty:

Hi {%#if isEmpty(profile.person.name.firstName)%}valued customer{%else%}{{profile.person.name.firstName}}{%/if%},

PQL Edge Case-Rezepte pql-edge-cases

Rezept 14 - Referenzieren eines mit Bindestrichen versehenen Attributschlüssels recipe-hyphenated-key

Wenn der XDM-Schemafeldname Bindestriche enthält (z. B. order-total, event-type), schließen Sie ihn in einen PQL-Ausdruck mit Backticks ein, um zu verhindern, dass der Bindestrich als Subtraktionsoperator interpretiert wird:

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

Rezept 15 - Referenzieren einer numerischen Ereignis-ID in einem Kontextattribut recipe-numeric-event-id

Wenn Sie ein Journey-Kontextereignis verwenden, dessen ID eine numerische Zeichenfolge ist (z. B. 1697323153), schließen Sie die ID in Backticks ein und verwenden Sie {% let %} mit toDateTime() und formatDate():

{% let appointmentDate = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy HH:mm") %}
Your appointment: {{appointmentDate}}

Ausgabe (Beispiel): Your appointment: 18/03/2026 14:30

Rezept 16 - Zwang eingeben: Zeichenfolgenfeld mit einer Zahl vergleichen recipe-type-coercion

PQL ist stark typisiert. Wenn ein Profilfeld als Zeichenfolge gespeichert wird, Sie es jedoch numerisch vergleichen müssen, konvertieren Sie es zuerst mit stringToNumber():

{%= stringToNumber(profile.loyalty.pointsBalance) > 500 %}

Für boolesche Felder, die als Zeichenfolgen gespeichert werden:

{%= toBool(profile.consents.email.val) = true %}

Kurzübersicht quick-reference

Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.

Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.