Nutzen von Fragmenten in Entscheidungsrichtlinien fragments

Auf dieser Seite: Nutzen Sie Journey Optimizer-Inhaltsfragmente und AEM-Inhaltsfragmente innerhalb von Entscheidungsrichtlinien, um die Bereitstellung von Inhalten kanalübergreifend zu personalisieren und zu optimieren.

Entscheidungselemente unterstützen zwei Arten von Fragmentinhalten, die beim Verfassen von Nachrichten innerhalb einer Entscheidungsrichtlinie genutzt werden können:

Journey Optimizer-Inhaltsfragmente ajo-fragments

Wenn Ihre Entscheidungsrichtlinie Entscheidungselemente einschließlich AJO-Inhaltsfragmenten enthält, können Sie diese Fragmente beim Verfassen einer Nachricht innerhalb der Entscheidungsrichtlinie auf allen Kanälen nutzen, auf denen die Entscheidungsfindung verfügbar ist (Code-basiertes Erlebnis, E-Mail, Push, SMS und Journeys).

Angenommen, Sie möchten verschiedene Inhalte für mehrere Mobilgerätemodelle anzeigen. Fügen Sie die angegebenen Fragmente, die sich jeweils auf ein anderes Telefonmodell beziehen, zu dem Entscheidungselement hinzu, das Sie in der Entscheidungsrichtlinie verwenden. Erfahren Sie, wie Sie Fragmente zu einem Entscheidungselement hinzufügen.

Abschnitt „Fragmente“ eines Entscheidungselements mit Fragmentverweisen und Platzierungsschlüsseln. {width="70%"}

Anschließend können Sie eine der folgenden Methoden verwenden:

Code direkt einfügen

Kopieren Sie einfach den unten stehenden Code-Block in den Entscheidungsrichtlinien-Code. Ersetzen Sie variable durch die Fragment-ID und placement durch den Fragmentverweisschlüssel:

code language-handlebars
{% let variable =  get(item._experience.decisioning.offeritem.contentReferencesMap, "placement").id %}
{{fragment id = variable required=false}}
Befolgen Sie die detaillierten Schritte
  1. Navigieren Sie zu den Hilfsfunktionen und fügen Sie die Let-Funktion {% let variable = expression %} {{variable}} zum Code-Bereich hinzu, in dem Sie die Variable für Ihr Fragment deklarieren können.

    Entscheidungsrichtlinien-Code-Editor, der die im Code-Bereich eingefügte Helper-Funktion „Let“ anzeigt.

  2. Verwenden Sie die auf Map > Get basierende Funktion {%= get(map, string) %}, um Ihren Ausdruck zu erstellen. Die Zuordnung ist das Fragment, auf das im Entscheidungselement verwiesen wird. Die Zeichenfolge kann das Gerätemodell sein, das Sie im Entscheidungselement als Fragmentverweisschlüssel eingegeben haben.

    Zum Referenzieren der Fragmentzuordnung und des Fragmentverweisschlüssels werden die Funktionen „Map“ und „Get“ verwendet.

  3. Sie können auch ein kontextuelles Attribut verwenden, das diese Gerätemodell-ID enthält.

    Für die Gerätemodellkennung ausgewähltes kontextuelles Attribut.

  4. Fügen Sie die Variable hinzu, die Sie für Ihr Fragment als Fragment-ID ausgewählt haben.

    Die Fragment-ID-Variable wird aus dem Entscheidungselement im Entscheidungsrichtlinien-Code festgelegt.

Die Fragment-ID und der Referenzschlüssel werden später im Abschnitt Fragmente des Entscheidungselements ausgewählt.

WARNING
Wenn der Fragmentschlüssel falsch oder der Fragmentinhalt ungültig ist, schlägt das Rendern fehl und kann einen Fehler im Edge-Aufruf verursachen.
Um Fehler zu vermeiden, wenn ein Fragment vorübergehend nicht verfügbar ist, wird das required=false-Flag verwendet, sodass das Fragment stattdessen übersprungen wird. Weitere Informationen zu vorübergehend nicht verfügbaren Fragmenten

Verwendung und Schutzmechanismen fragments-guardrails

Die folgenden Schutzmechanismen gelten speziell für AJO-Inhaltsfragmente, die in Entscheidungselementen verwendet werden.

Simulieren von Inhalts- und Ausdrucksfragmenten in E-Mails
Für den E-Mail-Kanal werden mit einem Entscheidungselement verknüpfte Ausdrucksfragmente korrekt angezeigt, wenn Sie einen Testversand durchführen oder die Kampagne aktiviert wird. Mit Inhalte simulieren wird das Ausdrucksfragment aus dem Entscheidungselement jedoch nicht angezeigt.
Visuelle Fragmente und Entscheidungselemente in E-Mails
Sie können einem Entscheidungselement kein visuelles Fragment zuweisen, nur Ausdrucksfragmente werden in diesem Kontext unterstützt.
Entscheidungselement- und Kontextattribute

Entscheidungselement- und Kontextattribute werden in Journey Optimizer-Fragmenten standardmäßig nicht unterstützt. Sie können jedoch stattdessen globale Variablen verwenden, wie unten beschrieben.

Angenommen, Sie möchten die Variable sport in Ihrem Fragment verwenden.

  1. Verweisen Sie auf diese Variable im Fragment, z. B.:

    code language-text
    Elevate your practice with new {{sport}} gear!
    
  2. Definieren Sie die Variable mit der Funktion Let im Entscheidungsrichtlinienblock. Im folgenden Beispiel wird sport mit dem Entscheidungsattribut definiert:

    code language-handlebars
    {#each decisionPolicy.13e1d23d-b8a7-4f71-a32e-d833c51361e0.items as |item|}}
    {% let sport = item._cjmstage.value %}
    {{fragment id = get(item._experience.decisioning.offeritem.contentReferencesMap, "placement1").id }}
    {{/each}}
    
Inhaltsvalidierung von Entscheidungselementfragmenten
  • Aufgrund der Dynamik dieser Fragmente wird bei Verwendung in einer Kampagne die Nachrichtenvalidierung während der Erstellung des Kampagneninhalts für Fragmente übersprungen, auf die in Entscheidungselementen verwiesen wird.

  • Die Validierung des Fragmentinhalts erfolgt nur während der Erstellung und Veröffentlichung des Fragments.

  • Bei Ausdrucksfragmenten vom Typ JSON wird der Inhalt beim Speichern des Fragments syntaktisch validiert. Validierungsfehler werden als Warnhinweise angezeigt.

Zur Laufzeit wird der Kampagneninhalt (einschließlich des Fragmentinhalts aus Entscheidungselementen) validiert. Im Falle eines Validierungsfehlers wird die Kampagne nicht gerendert.

Vorübergehend nicht verfügbare Fragmente werden übersprungen {#temporary-unavailable-fragments}

Wenn Journeys oder Kampagnen auf Fragmente verweisen, die an Entscheidungselemente angehängt sind, kann es zu kurzen Synchronisierungsverzögerungen kommen, bevor aktualisierte Fragmente am Edge verfügbar sind.

Um Fehler zu vermeiden, wenn ein Fragment vorübergehend nicht verfügbar ist, ist für Fragmente jetzt das required-Flag standardmäßig auf false eingestellt, sodass sie übersprungen werden, anstatt einen Journey- oder Kampagnenfehler zu verursachen.

Das bedeutet, dass ein Fragment einfach ignoriert wird, wenn es am Edge vorübergehend nicht verfügbar ist. Wenn das Fragment verfügbar ist, wird es normal dargestellt.

Beispiel

Wenn Ihre Entscheidungsrichtlinie für zwei Angebote qualifiziert ist und jedes ein Fragment hat – z. B. „20 % Rabatt“ und „30 % Rabatt“ – und das zweite Fragment vorübergehend nicht verfügbar ist, zeigt das System mit required=false das verfügbare Angebot (20 % Rabatt) an und überspringt das andere Fragment (30 % Rabatt), anstatt die Journey oder Kampagne fehlschlagen zu lassen. Dies erhöht die Zuverlässigkeit bei der Synchronisierung von Inhalten.

NOTE
Sie können ein Fragment weiterhin als obligatorisch markieren, indem Sie das required-Flag auf true setzen. Wenn ein Fragment jedoch vorübergehend fehlt, kann dies dazu führen, dass die Journey- oder Kampagnendarstellung fehlschlägt.

AEM-Inhaltsfragmente aem-fragments-decisioning

AVAILABILITY
Diese Funktion ist für Kanäle mit Unterstützung für Entscheidungsfindung verfügbar.

Bevor Sie AEM-Inhaltsfragmente in einer Entscheidungsrichtlinie nutzen, stellen Sie Folgendes sicher:

Im Personalisierungseditor sind alle AEM-Inhaltsfragmente verfügbar, die mit den von der Richtlinie ausgewählten Entscheidungselementen verknüpft sind. Pro Fragmentschlüsselname wird ein Ordner angezeigt.

➡️ Erfahren Sie in diesem Video, wie Sie AEM-Inhaltsfragmente mit der Journey Optimizer-Entscheidungsfindung verwenden

In diesem Beispiel enthält die Entscheidungsrichtlinie zwei Entscheidungselemente, an die AEM-Fragmente mit ihren Verweisnamen verknüpft sind.

Personalisierungseditor mit AEM-Inhaltsfragmenten, die pro Fragmentschlüsselname in einer Entscheidungsrichtlinie verfügbar sind.

  1. Klicken Sie auf die Schaltfläche „+“, um Ihrem Ausdruck das gewünschte Fragment hinzuzufügen.

    Da mit einem einzelnen Verweisnamen mehrere Fragmente über verschiedene Angebotselemente hinweg verknüpft sein können, bestimmt die Entscheidungsfindung anhand der Ranking-Kriterien der Entscheidungsrichtlinie das beste Element für jede Kundin und jeden Kunden.

  2. Nachdem das Fragment ausgewählt wurde, können Sie seine Attribute wie Bild-URLs, Textfelder oder andere Inhalte nutzen und mithilfe von Entscheidungsfindung den richtigen Inhalt zum richtigen Zeitpunkt der richtigen Person anzeigen.

    Ausgewählte AEM-Inhaltsfragmentattribute, die im Entscheidungsrichtlinienausdruck für die Personalisierung verfügbar sind.

  3. Bevor Sie eine Kampagne oder Journey aktivieren, verwenden Sie eine der Simulationsmethoden, um eine Vorschau der Darstellung von Feldwerten für AEM-Inhaltsfragmente anzuzeigen. Erfahren Sie mehr über die Simulation von Inhalten

Verwenden von AEM-Inhaltsfragmenten über mehrere Kanäle hinweg aem-fragments-channels

Wie Sie AEM-Inhaltsfragmentattribute aus einer Entscheidungsrichtlinie einfügen, hängt vom Kanal ab, in dem Sie arbeiten.

E-Mail

So fügen Sie AEM-Inhaltsfragmentattribute mithilfe einer Entscheidungsrichtlinie in Ihre E-Mail ein:

  1. Öffnen Sie Ihren E-Mail-Entwurf im E-Mail-Designer und klicken Sie in der rechten Leiste auf das Symbol Entscheidungsfindung, um das Panel „Entscheidungsrichtlinie“ zu öffnen.

  2. Wählen Sie die zusammengestellte Auswahlstrategie aus und geben Sie eine Platzierung an, um den Bereich der E-Mail zu definieren, in den das Angebot eingefügt werden soll.

  3. Klicken Sie auf das Symbol + und wählen Sie das spezifische Feld aus dem AEM-Inhaltsfragment aus, das in diesem Bereich angezeigt werden soll, z. B. das Feld mit der URL des Hero-Bilds.

    Panel „Entscheidungsrichtlinie“ im E-Mail-Designer, in dem ein Feld für ein AEM-Inhaltsfragment für einer Platzierung ausgewählt ist.

  4. Klicken Sie vor der Veröffentlichung auf Inhalte simulieren, um das Ergebnis in der Vorschau anzuzeigen und sicherzustellen, dass das Angebot mit der höchsten Priorität und sein Inhaltsfragment wie erwartet für ein Testprofil gerendert werden.

Code-basiertes Erlebnis (JSON)

Verwenden Sie beim Erstellen eines auf JSON beruhenden Code-basierten Erlebnisses die folgende Struktur, um AEM-Inhaltsfragmentattribute aus einer Entscheidungsrichtlinie darzustellen.

code language-handlebars
[
{{#each decisionPolicy.YOUR_POLICY_ID.items as |item|}}
{% let frag = get(item._experience.decisioning.offeritem.aemContentReferencesMap, "YOUR_REFERENCE_KEY").id %}
{{fragment id = frag result='YOUR_REFERENCE_KEY' required=false}}
{
  "fieldName": "{{{YOUR_REFERENCE_KEY.fieldName}}}"
},
{{/each}}
]
note
NOTE
AEM-Inhaltsfragmente verwenden aemContentReferencesMap, um Fragmente nach Verweisschlüssel nachzuschlagen. Dies unterscheidet sich von contentReferencesMap, das für Journey Optimizer-Inhaltsfragmente verwendet wird.

Beachten Sie beim Erstellen Ihrer JSON-Payload Folgendes:

  • Platzieren Sie die Klammern des JSON-Arrays [ und ] außerhalb der #each-Schleife.
  • Verwenden Sie dreifache Klammern {{{ }}} für Feldwerte in JSON-Zeichenfolgen, um zu verhindern, dass HTML Sonderzeichen maskiert, und um eine gültige JSON-Ausgabe sicherzustellen.
  • Der Parameter result='YOUR_REFERENCE_KEY' erfasst den aufgelösten Fragmentinhalt unter diesem Namen, damit Sie auf dessen Felder mit YOUR_REFERENCE_KEY.fieldName verweisen können.

Code-basierter Erlebnis-Editor, der Attribute von AEM-Inhaltsfragmenten anzeigt, die aus einer Entscheidungsrichtlinie in JSON gerendert werden.

Code-basiertes Erlebnis (HTML)

Verwenden Sie für HTML-basierte Code-basierte Erlebnisse standardmäßige doppelte geschweifte Klammern für das Feld-Rendering:

code language-handlebars
{{#each decisionPolicy.YOUR_POLICY_ID.items as |item|}}
{% let frag = get(item._experience.decisioning.offeritem.aemContentReferencesMap, "YOUR_REFERENCE_KEY").id %}
{{fragment id = frag result='YOUR_REFERENCE_KEY' required=false}}
<div>{{YOUR_REFERENCE_KEY.fieldName}}</div>
{{/each}}

Verwenden von Assets aus AEM-Inhaltsfragmenten aem-cf-assets

AEM-Inhaltsfragmente können Bildfelder enthalten, die auf in AEM gespeicherte Assets verweisen. Da Journey Optimizer nur den relativen Pfad dieser Assets erhält, werden Bilder möglicherweise erst geladen, wenn die vollständige Veröffentlichungs-URL vorangestellt wird.

NOTE
Die native Auflösung von AEM-Asset-Verweisen innerhalb von Inhaltsfragmenten wird derzeit noch nicht unterstützt. Die folgenden Vorgehensweisen dienen als Workarounds, bis diese Unterstützung verfügbar ist.
Voranstellen der AEM-Veröffentlichungs-Domain
  1. Ermitteln Sie anhand Ihrer AEM-Instanz-URL die Autoren-Domain, z. B. author-p12345-e67890.adobeaemcloud.com

    AEM-Instanz-URL mit der Autoren-Domain, aus der die Veröffentlichungs-Domain abgeleitet wird.

  2. Ersetzen Sie author durch publish, um die Veröffentlichungs-Domain zu erhalten: publish-p12345-e67890.adobeaemcloud.com

  3. Stellen Sie im Personalisierungseditor von Journey Optimizer diese Veröffentlichungs-Domain dem Asset-Verweisfeld des Inhaltsfragments voran.

    Personalisierungseditor mit einer AEM-Veröffentlichungs-Domain, die einem Asset-Verweisfeld eines Inhaltsfragments vorangestellt ist.

Das Bild wird nun zur Versandzeit mit seiner vollständigen Veröffentlichungs-URL aufgelöst.

Speichern der Veröffentlichungs-URL in einem Textfeld
  1. Öffnen Sie Ihr Inhaltsfragment in AEM.

  2. Navigieren Sie zur JSON-Vorschau und überprüfen Sie den Abschnitt Referenzen, um die Veröffentlichungs-URL des Assets zu finden.

    Abschnitt „Referenzen“ der JSON-Vorschau eines AEM-Inhaltsfragments mit der Veröffentlichungs-URL des Assets.

  3. Kopieren Sie die Veröffentlichungs-URL und fügen Sie sie in ein dafür vorgesehenes Textfeld innerhalb des Inhaltsfragments ein.

    Textfeld eines AEM-Inhaltsfragments mit der kopierten Veröffentlichungs-URL für das referenzierte Asset.

  4. Verwenden Sie in Journey Optimizer dieses Textfeld direkt als Bildquelle in Ihrem Personalisierungsausdruck.

    Personalisierungsausdruck in Journey Optimizer, der das Textfeld des Inhaltsfragments als Bildquelle verwendet.

Mit diesem Ansatz wird die URL nicht manuell erstellt, und die Veröffentlichungs-URL bleibt im Inhaltsfragment selbst.

Anleitungsvideo video

Erfahren Sie, wie Sie Adobe Experience Manager-Inhaltsfragmente mit Journey Optimizer-Entscheidungsfindung verwenden, um Inhalte zu personalisieren und zu optimieren.

recommendation-more-help
journey-optimizer-help