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 Journey).

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 dem Codebereich hinzugefügte Hilfsfunktion „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.

    Die Funktionen Map und Get werden zum Referenzieren der Fragmentzuordnung und des Fragmentverweisschlüssels 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 ist oder der Fragmentinhalt ungültig ist, kann das Rendering fehlschlagen und 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. Erfahren Sie mehr über vorübergehend nicht verfügbare Fragmente

Verwendung und Leitlinien fragments-guardrails

Die folgenden Leitplanken 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 Testversand durchführen oder die Kampagne aktiviert wird. In Inhalt simulieren wird das Ausdrucksfragment jedoch nicht aus dem Entscheidungselement 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

Entscheidungselementattribute und kontextuelle Attribute werden in Journey Optimizer Fragmenten nicht standardmäßig 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}}
    
Validierung des Inhalts eines Entscheidungsfragments
  • Aufgrund der Dynamik dieser Fragmente wird bei Verwendung in einer Kampagne die Nachrichtenvalidierung bei der Erstellung von Kampagneninhalten 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 Journey oder Kampagnen auf Fragmente verweisen, die an Entscheidungselemente angehängt sind, kann es zu kurzen Synchronisierungsverzögerungen kommen, bevor aktualisierte Fragmente in 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 festgelegt, sodass sie übersprungen werden, anstatt einen Journey- oder Kampagnenfehler zu verursachen.

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

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, mit required=false das System das verfügbare Angebot rendert (20 % Rabatt) und das andere Fragment (30 % Rabatt) überspringt, 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 die required-Markierung auf true setzen. Wenn ein Fragment jedoch vorübergehend fehlt, kann dies dazu führen, dass das Journey- oder Kampagnen-Rendering fehlschlägt.

AEM-Inhaltsfragmente aem-fragments-decisioning

AVAILABILITY
Diese Funktion ist für ausgehende Kanäle mit Entscheidungsunterstützung 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.

➡️ Im Video erfahren Sie, wie Sie AEM-Inhaltsfragmente mit Journey Optimizer Decisioning verwenden

In diesem Beispiel enthält die Entscheidungsrichtlinie zwei Entscheidungselemente, an die AEM-Fragmente über ihren Referenznamen gebunden sind.

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

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

    Da an einen einzelnen Referenznamen mehrere Fragmente über verschiedene Angebotselemente hinweg gebunden sein können, bestimmt Decisioning anhand der Ranking-Kriterien der Entscheidungsrichtlinie das beste für 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 Decisioning den richtigen Inhalt zum richtigen Zeitpunkt für den richtigen Kunden darstellen.

    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 zum Rendern der Feldwerte für AEM-Inhaltsfragmente anzuzeigen. Erfahren Sie mehr über die Simulation von Inhalten

Verwenden von AEM-Inhaltsfragmenten kanalübergreifend 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 in der E-Mail-Designer und klicken Sie in der rechten Leiste auf Decisioning-Symbol, um das Bedienfeld „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 gerendert werden soll, z. B. das URL-Feld des Herobilds.

    Senden Sie eine E-Mail an das Entscheidungsrichtlinien-Bedienfeld von Designer, wobei für eine Platzierung ein Feld für ein AEM-Inhaltsfragment ausgewählt ist.

  4. Klicken Sie vor der Veröffentlichung Inhalt 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 JSON-basierten Code-basierten Erlebnisses die folgende Struktur, um AEM-Inhaltsfragmentattribute aus einer Entscheidungsrichtlinie zu rendern.

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 Referenzschlü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 JSON-Array-Klammern [ und ] außerhalb der #each.
  • Verwenden Sie dreifache Klammern {{{ }}} für Feldwerte in JSON-Zeichenfolgen, um zu verhindern, dass HTML Sonderzeichen umgeht, und um eine gültige JSON-Ausgabe sicherzustellen.
  • Der 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 AEM-Inhaltsfragmentattribute anzeigt, die aus einer Entscheidungsrichtlinie in JSON gerendert wurden.

Code-basiertes Erlebnis (HTML)

Verwenden Sie für HTML-basierte Code-basierte Erlebnisse standardmäßige doppelte Klammern für die Feldwiedergabe:

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 noch nicht unterstützt. Die folgenden Ansätze sind Problemumgehungen, bis diese Unterstützung hinzugefügt wird.
AEM-Veröffentlichungs-Domain voranstellen
  1. Identifizieren Sie über die AEM-Instanz-URL die Autoren-Domain - z. B. author-p12345-e67890.adobeaemcloud.com.

    AEM-Instanz-URL, die die für die Ableitung der Veröffentlichungsdomäne verwendete Autoren-Domain anzeigt.

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

  3. Stellen Sie im Journey Optimizer-Personalisierungseditor diese Veröffentlichungs-Domain dem Feld Asset-Verweis aus dem Inhaltsfragment voran.

    Personalization-Editor mit der AEM-Veröffentlichungs-Domain, der ein Asset-Referenzfeld für Inhaltsfragmente vorangestellt wird.

Das Bild wird jetzt zum Zeitpunkt der Bereitstellung auf seine vollständige Veröffentlichungs-URL aufgelöst.

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

  2. Wechseln Sie zur JSON-Vorschau und überprüfen Sie den Abschnitt Verweise, um die veröffentlichte Asset-URL zu finden.

    Abschnitt mit den JSON-Vorschauverweisen für AEM-Inhaltsfragmente, der die veröffentlichte Asset-URL anzeigt.

  3. Kopieren Sie die Veröffentlichungs-URL und fügen Sie sie in ein dediziertes Textfeld im Inhaltsfragment ein.

    Textfeld des AEM-Inhaltsfragments, das die kopierte Veröffentlichungs-URL für das referenzierte Asset enthält.

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

    Journey Optimizer-Personalisierungsausdruck, der auf das Textfeld des Inhaltsfragments als Bildquelle verweist.

Durch diesen Ansatz wird die manuelle URL-Erstellung vermieden und die Veröffentlichungs-URL im Inhaltsfragment selbst belassen.

Anleitungsvideo video

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

recommendation-more-help
journey-optimizer-help