Verwenden dynamischer Fragmente dynamic-fragments

Auf dieser Seite: Erfahren Sie, wie die Auslösung dynamischer Fragmente in Adobe Journey Optimizer verwendet wird, um auszuwählen, welches veröffentlichte Fragment zur Laufzeit in eine Nachricht eingefügt wird. Dies erfolgt auf der Grundlage von Profilattributen, Datensatzsuchen oder Kontextdaten, die zum Versandzeitpunkt übergeben werden.

Adobe Journey Optimizer unterstützt die Auslösung dynamischer Fragmente zur Laufzeit, um auszuwählen, welches veröffentlichte Fragment in eine Nachricht eingefügt wird. Dies erfolgt auf der Grundlage von Profilattributen, Datensatzsuchen oder Kontextdaten, die zum Versandzeitpunkt übergeben werden. Dies ermöglicht hochgradig personalisierte Inhalte ohne Duplizierung der Kampagnen- oder Journey-Logik.

Überblick overview

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

IDs dynamischer Fragmente können aus drei Quellen stammen:

Voraussetzungen prerequisites

Stellen Sie vor der Verwendung dynamischer Fragmente Folgendes sicher:

Schritt 1: Erstellen und Veröffentlichen des Fragments create-fragment

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

Schritt 2: Erstellen der Nachricht mit einem Verweis auf ein dynamisches Fragment author-message

Fügen Sie im Personalisierungseditor den Platzhalter des dynamischen Fragments 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 ihn 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 Tabelle, in der eine Zuordnung von Stil zu Fragment erfolgt), verwenden Sie die datasetLookup-Helper-Funktion, 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, was dann zum Auflösen des Fragments verwendet wird.

Auflösen über Kontextdaten resolve-from-context

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

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

Der Pfad 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.

Auflösen über ein Profilattribut 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 Ihres Datensatzes für den Suchansatz configure-dataset

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

Beispiel für Datensatzstruktur:

Schritt 4: Übergeben von Kontextdaten zum Versandzeitpunkt 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 Kampagnentestversand-API die Fragment-ID in das context-Objekt 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. Unter diesem Schlüssel verschachtelte Attribute 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 Kampagnentestversand-API, um zu überprüfen, ob das dynamische Fragment korrekt aufgelöst wird und ob die gerenderte E-Mail-Ausgabe wie erwartet aussieht.

Weitere Informationen zu Kampagnen-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 pauschal als derselbe Fehlertyp kategorisiert.

So beheben Sie Fehler bei der Fragmentauflösung: