Auf dieser Seite Erfahren Sie, wie Sie mit dem Personalisierungseditor Personalisierungsausdrücke aus Quellen wie Profilattribute, Zielgruppen, Angebotsentscheidungen und kontextuelle Attribute hinzufügen, anpassen und validieren können.
Der Personalisierungseditor ist die Kernkomponente der Personalisierung in Journey Optimizer. Er ist in jedem Kontext verfügbar, in dem Sie eine Personalisierung definieren müssen, wie z. B. E-Mails, Push-Benachrichtigungen und Angebote.
In der Benutzeroberfläche des Personalisierungseditors können Sie alle Daten auswählen, anordnen, anpassen und validieren, um eine benutzerdefinierte Personalisierung für Ihren Content zu erstellen.
Wo kann ich eine Personalisierung hinzufügen? where
Mit dem Symbol
Die Personalisierung kann an verschiedenen Stellen in Ihren Nachrichten hinzugefügt werden, z. B. im Feld Betreffzeile.
Sie kann auch in anderen Abschnitten Ihres Contents hinzugefügt werden. Zum Beispiel kann eine Personalisierung für Push-Benachrichtigungen in den Feldern Titel, Textkörper, Benutzerdefinierter Ton, Badges und Benutzerdefinierte Daten hinzugefügt werden.
Beim Bearbeiten von E-MailInhalten in der E-MailDesigner können Sie mithilfe des Symbols in der kontextuellen Symbolleiste eine Personalisierung in den meisten Textelementen hinzufügen.
Mit Journey Optimizer können Sie auch URLs in Ihren Nachrichten personalisieren. Personalisierte URLs führen Empfangende je nach den Profilattributen zu bestimmten Seiten einer Website oder zu einer personalisierten Microsite. Weitere Informationen
| note |
|---|
| NOTE |
| Die Personalisierung von URLs ist für diese Link-Typen verfügbar: Externer Link, Abmelde-Link und Ausschluss. |
Personalisierungsquellen sources
Im Navigationsbereich können Sie die Quelle für die Personalisierung auswählen. Verfügbare Quellen sind:
- Profilattribute: Listet alle Verweise auf, die mit dem Profilschema verknüpft sind, wie in der Dokumentation zum Adobe Experience Platform-Datenmodell (XDM) beschrieben.
- Zielattribute: Dieser Ordner ist spezifisch für orchestrierte Kampagnen. Er enthält Attribute, die direkt auf der Kampagnen-Arbeitsfläche berechnet werden. Informationen zum Hinzufügen von Personalisierungen in orchestrierten Kampagnen
- Zielgruppen: Listet alle im Segmentierungs-Service von Adobe Experience Platform erstellten Zielgruppen auf. Weitere Informationen finden Sie in der Dokumentation zur Adobe Experience Platform-Segmentierung.
- Angebotsentscheidungen: Listet alle Angebote auf, die mit einer bestimmten Platzierung verbunden sind. Wählen Sie die Platzierung aus und fügen Sie dann die Angebote in den Inhalt ein. Eine vollständige Dokumentation zum Verwalten von Angeboten finden Sie in diesem Abschnitt.
- Kontextattribute: Wenn eine Kanalaktionsaktivität (E-Mail, Push, SMS) in einer Journey oder Kampagne verwendet wird, stehen für die Personalisierung Kontextattribute im Zusammenhang mit Ereignissen und Eigenschaften zur Verfügung. Ein Beispiel für die Personalisierung mit kontextuellen Attributen finden Sie in diesem Abschnitt. Darüber hinaus können Antworten benutzerdefinierter Aktionen für die Personalisierung verwendet werden. Erfahren Sie, wie Sie Antworten benutzerdefinierter Aktionen in nativen Kanälen verwenden .
Hinzufügen von Personalisierung add
Im zentralen Arbeitsbereich erstellen Sie Ihre Personalisierungssyntax. Um ein Attribut zur Personalisierung Ihrer Nachricht zu verwenden, suchen Sie es im linken Navigationsbereich und klicken Sie auf die Schaltfläche +, um es zum Ausdruck hinzuzufügen.
Über das Menü mit den Auslassungspunkten neben dem Symbol + können Sie weitere Details für jedes Attribut abrufen und Ihre am häufigsten verwendeten Attribute zu den Favoriten hinzufügen. Zu Favoriten hinzugefügte Attribute sind über das Menü Favoriten im Navigationsbereich zugänglich.
Darüber hinaus können Sie einen standardmäßigen Fallback-Text definieren, der angezeigt wird, wenn ein Profilattribut vom Typ Zeichenfolge leer ist. Klicken Sie dazu auf die Schaltfläche mit den Auslassungspunkten neben dem Attribut und wählen Sie Einfügen mit Fallback-Text. Schreiben Sie den Text, der standardmäßig angezeigt werden soll, wenn der Wert des Attributs für ein Profil leer ist, und klicken Sie dann auf Hinzufügen.
Im folgenden Beispiel können Sie mit dem Personalisierungseditor die Profile auswählen, die heute Geburtstag haben, und dann die Anpassung vervollständigen, indem Sie ein spezifisches Angebot einfügen, das zu diesem Tag passt.
Optionen für die Ausdrucksbearbeitung options
Der zentrale Arbeitsbereich bietet verschiedene Tools, mit denen Sie Ihren Personalisierungsausdruck schreiben können.
Verfügbare Optionen sind:
-
Suchen/Suchen und Ersetzen: Durchsuchen Sie Ihren Ausdruck und ersetzen Sie automatisch Teile des Codes.
-
Rückgängig machen/Wiederholen: Machen Sie den letzten Vorgang rückgängig oder wiederholen Sie ihn.
-
Automatisch vervollständigen: Vervollständigt Code automatisch während der Eingabe und unterbreitet Vorschläge. Diese Funktion ist nur für HTML- und Textformate verfügbar und unterstützt Profil- und Kontextattribute. Wenn der Editor über den Umschalter deaktiviert ist, stellt er stattdessen die automatische Vervollständigung von nativem HTML-Code bereit.
-
HTML/JSON/Text: Identifizieren Sie das Format Ihres Codes. Dadurch kann das System die Funktion zur Validierung und automatischen Vervollständigung basierend auf der ausgewählten Sprache anpassen.
-
Validieren: Überprüfen Sie die Syntax Ihres Ausdrucks. Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Als Fragment speichern: Speichern Sie Ihren Ausdruck als Ausdrucksfragment. Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Schriftgrad: Passt den Schriftgrad für den Content im Editor an, um die Lesbarkeit zu verbessern.
-
Zeilenumbruch: Aktiviert oder deaktiviert den Zeilenumbruch, sodass lange Ausdrücke in einer einzelnen Zeile angezeigt oder im Editor umgebrochen werden können. Zu den Optionen gehören:
- Aus (Standard): Kein Zeilenumbruch. Lange Zeilen gehen über die Ansicht des Editors hinaus und erfordern einen horizontalen Bildlauf.
- Ein: Passt Zeilen mit Umbrüchen an die Breite des Editors an.
- Zeilenumbruchspalte: Fügt Zeilenumbrüche ein, wenn eine Zeile 80 Zeichen erreicht.
- Begrenzt: Fügt Zeilenumbrüche angepasst an die Editor-Breite oder bei Erreichen von 80 Zeichen ein, je nachdem, welcher Wert kleiner ist.
-
Pillen: Attribute werden als kompakte „Pillen“ angezeigt, um die Lesbarkeit zu verbessern, indem lange Attributpfade ausgeblendet werden. Klicken Sie auf ein Attribut, um dessen vollständigen Pfad anzuzeigen.
note NOTE Diese Option ist nur für Profilattribute, kontextuelle Attribute und dynamische Medien verfügbar.
Im Navigationsbereich stehen zusätzliche Funktionen zur Verfügung, mit denen Sie Ihren Personalisierungsausdruck erstellen können.
-
Hilfsfunktionen: Listet alle Hilfsfunktionen auf, die für die Durchführung von Datenoperationen wie Berechnungen, Datenformatierungen oder -konvertierungen, Bedingungen und die Bearbeitung von Daten im Rahmen der Personalisierung verfügbar sind. Weitere Informationen zu den verfügbaren Hilfsfunktionen
-
Favoriten: Attribute, die Sie den Favoriten hinzugefügt haben, werden in dieser Liste angezeigt. Auf diese Weise können Sie schnell auf Ihre am häufigsten verwendeten Elemente zugreifen. Um ein Attribut zu Ihren Favoriten hinzuzufügen, klicken Sie auf das Menü mit den Auslassungspunkten und wählen Sie Zu Favoriten hinzufügen aus.
-
Bedingungen: Nutzen Sie die in der Bibliothek erstellten bedingten Regeln, um dynamischen Content in Ihre Nachrichten einzufügen. Auf diese Weise können Sie basierend auf Bedingungen mehrere Varianten Ihrer Nachricht erstellen. Informationen zum Erstellen von dynamischem Content
-
Fragmente: Nutzen Sie Ausdrucksfragmente, die in der aktuellen Sandbox erstellt oder gespeichert wurden. Ein Fragment ist eine wiederverwendbare Komponente, die in Journey Optimizer-Kampagnen und -Journeys referenziert werden kann. Mit dieser Funktion können Sie mehrere benutzerdefinierte Inhaltsbausteine vorab erstellen, mit denen Marketing-Fachleute Inhalte schnell in einem verbesserten Design-Prozess zusammenstellen können. Informationen zur Verwendung von Ausdrucksfragmenten
Wenn Ihr Personalisierungsausdruck fertig ist, müssen Sie ihn vom Personalisierungseditor validieren lassen. Weiterführende Informationen finden Sie in diesem Abschnitt.
Mechanismen der Validierung validation-mechanisms
Die Validierung Ihres Ausdrucks wird automatisch durchgeführt, wenn Sie auf die Schaltfläche Hinzufügen klicken, wodurch das Editorfenster geschlossen wird. Sie können Ihre Personalisierungssyntax auch mit der Schaltfläche Validieren überprüfen.
Erweitern Sie den folgenden Abschnitt, um Fehler anzuzeigen, die häufig bei der Validierung von Personalisierungen auftreten.
- Pfad „XYZ“ nicht gefunden
Beim Versuch, auf ein Feld zu verweisen, das im Schema nicht definiert ist.
In diesem Fall ist firstName1 nicht als Attribut im Profilschema definiert:
| code language-none |
|---|
|
- Typ für Variable „XYZ“ stimmt nicht überein. Array erwartet, Zeichenfolge gefunden.
Beim Versuch, über eine Zeichenfolge, statt über ein Array zu iterieren:
In diesem Fall ist product kein Array:
| code language-none |
|---|
|
- Ungültige Handlebars-Syntax.
'[XYZ}}'gefunden
Wenn eine ungültige Handlebars-Syntax verwendet wird.
Handlebar-Ausdrücke sind von {{expression}} umgeben.
| code language-none |
|---|
|
- Ungültige Segmentdefinition
| code language-none |
|---|
|
Bei Angeboten können spezifische Fehler auftreten. Erweitern Sie den folgenden Abschnitt, um weitere Informationen zu erhalten:
Die Fehler bei der Integration von Angeboten in eine E-Mail-Nachricht oder Push-Benachrichtigung haben das folgende Muster:
| code language-none |
|---|
|
Die Validierung erfolgt während der Validierung des Personalisierungsinhalts im Personalisierungseditor.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Fehlertitel | Validierung/Auflösung |
| Ressource mit der ID placementID und dem Typ OfferPlacement nicht gefunden Ressource mit der ID activityID und dem Typ OfferActivity nicht gefunden |
Überprüfen Sie, ob activityID und/oder placementID verfügbar ist. |
| Ressource konnte nicht validiert werden. | Der componentType in der Platzierung sollte mit dem Angebot offerType übereinstimmen. |
| Die öffentliche URL ist in der offerId des Angebots nicht vorhanden. | Für die Image-Angebote (alle personalisierten und Fallback-Angebote, die mit dem Entscheidungs- und Platzierungs-Paar verknüpft sind) sollte die öffentliche URL gefüllt sein (deliveryURL sollte nicht leer sein). |
| Die Entscheidung enthält Attribute, die nicht zu Profilen gehören. | Die Verwendung des Angebotsmodells sollte nur die Profilattribute enthalten. |
| Beim Abrufen der Entscheidungsverwendung ist ein Fehler aufgetreten. | Dieser Fehler kann auftreten, wenn die API versucht, das Angebotsmodell abzurufen. |
| Angebotsattribut – Das Angebotsattribut ist ungültig. | Überprüfen Sie, ob das Angebotsattribut, auf das in der Angebots-Dropdown-Liste verwiesen wird, gültig ist. Im Folgenden finden Sie die gültigen Attribute: Bild: deliveryURL, linkURL Text: content HTML: Inhalt |
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.
TL;DR
Auf dieser Seite wird erläutert, wie Sie mit dem Journey Optimizer-Personalisierungseditor Personalisierungsausdrücke aus Quellen auswählen, erstellen, anpassen und validieren können, darunter Profilattribute, Zielgruppen, Angebotsentscheidungen und Kontextattribute.
Intents
- Verstehen, wo Personalisierung in Journey Optimizer hinzugefügt werden kann (Nachrichten, E-Mail-Designer, URLs, E-Mail-Konfiguration, Angebote)
- Auswählen der entsprechenden Personalisierungsquelle für einen Ausdruck
- Hinzufügen von Attributen und Erstellen von Ausdrücken im Editor-Arbeitsbereich
- Editor-Tools verwenden: Suchen/Ersetzen, Automatisch vervollständigen, Validieren, Pillen, Als Fragment speichern
- Verwenden von Navigationsbereichsfunktionen: Hilfsfunktionen, Favoriten, Bedingungen, Fragmente
- Ausdrücke überprüfen und häufige Fehler beheben
- Personalization-Editor: Das zentrale Benutzeroberflächen-Tool in Journey Optimizer zum Erstellen, Anpassen und Validieren von Personalisierungsausdrücken; verfügbar, wo immer Personalisierung definiert werden kann. (produktspezifisch)
- Personalization-Quellen: Die für die Erstellung von Ausdrücken verfügbaren Datenkategorien - Profilattribute, Zielgruppenattribute, Zielgruppen, Angebotsentscheidungen und Kontextattribute.
- Kontextuelle Attribute: Journey- oder kampagnenspezifische Daten (Ereignisse, Eigenschaften, benutzerdefinierte Aktionsantworten), die nur zur Personalisierung verfügbar sind, wenn eine Kanalaktion auf einer Journey oder Kampagne verwendet wird. (produktspezifisch)
- Pillen: Ein Anzeigemodus des Personalisierungseditors, der lange Attributpfade als kompakte, klickbare Token rendert, um die Lesbarkeit zu verbessern. Nur für Profilattribute, kontextuelle Attribute und Dynamic Media verfügbar. (produktspezifisch)
- Automatisch vervollständigen: Eine Editor-Funktion, die Code während der Eingabe automatisch vorschlägt und vervollständigt. Nur für HTML- und Textformate verfügbar, unterstützt nur Profil- und Kontextattribute. (produktspezifisch)
- Ausdrucksfragment: Eine wiederverwendbare Ausdruckskomponente für Personalisierung, die in Kampagnen und Journey referenziert werden kann. (produktspezifisch)
- Fallback-Text: Eine Standardzeichenfolge, die angezeigt wird, wenn ein Profilattribut vom Typ Zeichenfolge für ein bestimmtes Profil leer ist, konfiguriert pro Attribut über „Einfügen mit Fallback-Text“.
- Kanonischer Name: Personalisierungseditor
- Nicht verwechseln: Personalization-Editor (zum Erstellen von Inhaltsausdrücken in Nachrichten, E-Mails, Push-Benachrichtigungen und Angeboten - unterstützt sowohl Handlebars als auch die PQL-Syntax) ≠ Erweiterter Ausdruckseditor (der auf der Journey für Bedingungen zu Datenquellen und Ereignisinformationen, benutzerdefinierte Warteaktivitäten und Aktionsparameterzuordnung verwendet wird) bietet integrierte Funktionen und Operatoren, die sich von denen im Personalisierungseditor unterscheiden)
- Nicht verwechseln: Profilattribute (XDM-Schemabasiert, in allen Kontexten verfügbar) ≠ Kontextuelle Attribute (Journey/kampagnenspezifisch, nur in diesem Kontext verfügbar) ≠ Zielattribute (nur orchestrierte Kampagnen)
- Nicht verwechseln: Automatische Vervollständigung für HTML/Text (schlägt Personalisierungsattribut-Vervollständigungen vor) ≠ native HTML-Code-automatische Vervollständigung (der Editor-Standard, wenn der Umschalter deaktiviert ist)
- Die automatische Vervollständigung ist nur für die Formate HTML und Text verfügbar. Sie unterstützt nur Profil- und Kontextattribute.
- Der Pillenanzeigemodus ist nur für Profilattribute, kontextuelle Attribute und Dynamic Media verfügbar.
- Die URL-Personalisierung ist nur für die Link-Typen „Externer Link“, „Abmelde-Link“ und „Opt-out-Link“ verfügbar.
- Standardmäßig werden im Attributbereich nur ausgefüllte Attribute angezeigt. Deaktivieren Sie „Nur ausgefüllte Attribute anzeigen“, um alle Schemaattribute anzuzeigen.
- Die Verwendung des Angebotsmodells darf nur Profilattribute enthalten. Nicht-Profilattribute in einer Entscheidung verursachen einen Validierungsfehler.
F: Wo kann die Personalisierung in Journey Optimizer hinzugefügt werden?
In jedem Feld mit dem Symbol Personalisierung hinzufügen , einschließlich der Betreffzeile der E-Mail, der Felder für die Push-Benachrichtigung (Titel, Textkörper, benutzerdefinierter Ton, Abzeichen, benutzerdefinierte Daten), E-Mail-Designer-Textelemente, URLs (externer Link, Abmelde-Link, Opt-out), E-Mail-Konfigurations-Subdomains/Kopfzeilen/URL-Tracking-Parameter und Darstellungen des Angebotstyps.
F: Welche Personalisierungsquellen stehen zur Verfügung?
Profilattribute, Zielattribute (nur orchestrierte Kampagnen), Zielgruppen, Angebotsentscheidungen und Kontextattribute (Journey-/Kampagnenereignisse und benutzerdefinierte Aktionsantworten).
F: Wie wird ein Ausdruck validiert?
Die Validierung wird automatisch ausgeführt, wenn Sie auf Hinzufügen klicken, um den Editor zu schließen. Sie können sie auch manuell mit der Schaltfläche Validieren Trigger erstellen. Häufige Fehler sind: Pfad nicht gefunden (Feld nicht im Schema), Typ stimmt nicht überein (Zeichenfolge als Array wird durchlaufen), ungültige Handlebars-Syntax und ungültige Segmentdefinition.
F: Was bewirkt die Pillen-Option?
Dadurch werden lange Attributpfade als kompakte, anklickbare Token gerendert, was die Lesbarkeit im Editor verbessert. Nur für Profilattribute, kontextuelle Attribute und Dynamic Media verfügbar.
F: Warum sehe ich nur einige Attribute im Attributbereich?
Standardmäßig werden im Bereich nur ausgefüllte Attribute angezeigt. Wählen Sie das Einstellungssymbol über dem Suchfeld aus und deaktivieren Sie „Nur ausgefüllte Attribute anzeigen“, um alle Schemaattribute anzuzeigen.