Verwenden dynamischer Fragmente dynamic-fragments

Auf dieser Seite Erfahren Sie, wie Sie mithilfe der dynamischen Fragmentauflösung in Adobe Journey Optimizer festlegen können, welches veröffentlichte Fragment zur Laufzeit in eine Nachricht eingefügt wird. Dies erfolgt auf der Grundlage von Profilattributen, Datensatzsuchen oder Kontextdaten, die zum Sendezeitpunkt übergeben werden.

Adobe Journey Optimizer unterstützt dynamische Fragmentauflösung zur Laufzeit. Damit können Sie anhand von Profilattributen, Datensatzsuchen oder Kontextdaten, die zum Sendezeitpunkt übergeben werden, auswählen, welches veröffentlichte Fragment in eine Nachricht eingefügt wird. Dies ermöglicht hochgradig personalisierte Inhalte ohne Duplizierung der Kampagnen- oder Journey-Logik.

Überblick overview

Statische Fragmente werden zur Entwurfszeit in eine Nachricht eingebettet. Für jeden Empfänger wird dasselbe Fragment verwendet. Dynamische Fragmente lösen die Fragment-ID zur Laufzeit pro Empfänger auf. Das bedeutet, dass verschiedene Profile innerhalb derselben Kampagne oder Journey völlig unterschiedliche Inhaltsbausteine erhalten können.

Dynamische Fragment-IDs können aus drei Quellen stammen:

Voraussetzungen prerequisites

Stellen Sie vor der Verwendung dynamischer Fragmente Folgendes sicher:

Schritt 1: Fragment erstellen und veröffentlichen create-fragment

Bevor ein Fragment dynamisch referenziert werden kann, muss es in Journey Optimizer veröffentlicht werden.

Schritt 2: Verfassen Sie die Nachricht mit einem dynamischen Fragmentverweis author-message

Fügen Sie im Personalisierungseditor den Platzhalter für dynamische Fragmente mit der folgenden Syntax ein:

{{fragment id=dynamic_fragment_id}}

Die Kennung dynamic_fragment_id ist ein Variablenname. Der Wert muss aufgelöst werden, bevor die Fragmentsuche erfolgt. Sie können sie mithilfe eines Datensatzsuchausdrucks, eines Profilattributs oder Kontextdaten auflösen.

Auflösen über eine Datensatzsuche resolve-from-dataset

Wenn die Fragment-ID in einem AEP-Datensatz gespeichert ist (z. B. in einer Zuordnungstabelle zwischen Stil und Fragment), verwenden Sie die datasetLookup Hilfsfunktion, um sie aufzulösen:

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

In diesem Beispiel enthält der Datensatz Zeilen, die durch einen Stilwert (z. B. style1) verschlüsselt wurden. Für ein bestimmtes Profil ruft die Suche den entsprechenden Wert der fragmentId Spalte ab und weist ihn dynamic_fragment_id zu, die dann zum Auflösen des Fragments verwendet wird.

Aus Kontextdaten auflösen resolve-from-context

Wenn die Fragment-ID zum Zeitpunkt des Versands als Teil des API-Anfragekontexts angegeben wird, verweisen Sie mithilfe des context-Namespace darauf:

{{fragment id=context.audiencePayload.fragmentId}}

Der context.audiencePayload ist das erforderliche Präfix für alle Attribute, die aus einer CSV-Zielgruppendatei stammen oder über den API-Anfragekontext übergeben werden. Der Spaltenname aus der CSV-Datei (z. B. fragmentId) folgt dem Präfix .

Aus einem Profilattribut auflösen resolve-from-profile

Wenn die Fragment-ID in Adobe Experience Platform als Profilattribut gespeichert ist, verweisen Sie direkt darauf:

{{fragment id=profile.mi.fragmentId}}

Schritt 3: Konfigurieren Sie Ihren Datensatz für den Suchansatz configure-dataset

Wenn Sie den Ansatz der Datensatzsuche verwenden, aktualisieren Sie Ihr Datensatzschema und Ihre Daten, um die Fragment-ID zu übernehmen.

Beispiel für eine Datensatzstruktur:

Schritt 4: Kontextdaten zum Sendezeitpunkt übergeben pass-context-data

Wenn Sie die Fragment-ID aus Kontextdaten auflösen (z. B. aus einer CSV-Zielgruppenempfehlungsdatei), übergeben Sie die Fragment-ID in der API-Anfrage unter dem erforderlichen Kontextpräfix.

Fügen Sie bei Verwendung der Kampagnen-Proofing-API die Fragment-ID in das context ein:

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

Das Präfix context.audiencePayload ist erforderlich. Attribute, die unter diesem Schlüssel verschachtelt sind, werden beim Ausführen der Live-Kampagne direkt den Spalten in der CSV-Zielgruppendatei zugeordnet.

Schritt 5: Testen und Validieren proof-validate

Bevor Sie die Kampagne aktivieren, verwenden Sie die Proofing-API von Campaign , um zu überprüfen, ob das dynamische Fragment korrekt aufgelöst wird und ob die gerenderte E-Mail-Ausgabe wie erwartet aussieht.

Weitere Informationen zur Campaign-API finden Sie in der Dokumentation zu Journey Optimizer-APIs.

Leitlinien und Einschränkungen guardrails

Die folgenden Einschränkungen gelten für die Verwendung dynamischer Fragmente:

Weitere Leitlinien für Fragmente finden Sie in diesem Abschnitt.

Umgang mit Fehlern error-handling

Wenn ein dynamisches Fragment zur Laufzeit nicht aufgelöst werden kann, wird ein Ausschlussereignis für das betroffene Profil generiert. Derzeit werden alle Fehler beim Rendern von Fragmenten als ein einziger allgemeiner Fehlertyp kategorisiert.

So debuggen Sie Fehler bei der Fragmentauflösung: