Verwenden von Adobe Experience Platform-Daten für die Personalisierung aep-data

Öffnen Sie den Personalisierungseditor, der in allen Kontexten verfügbar ist, in denen Sie Personalisierungen definieren können, z. B. Nachrichten. Erfahren Sie, wie Sie mit dem Personalisierungseditor arbeiten

Navigieren Sie zur Liste der Hilfsfunktionen und fügen Sie die Hilfsfunktion datasetLookup in den Code-Bereich ein.

Diese Funktion bietet eine vordefinierte Syntax, mit der Sie Felder aus Ihren Adobe Experience Platform-Datensätzen aufrufen können. Es gilt folgende Syntax:

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

• datasetId ist die ID des Datensatzes, mit dem Sie arbeiten.

• id ist die ID der Quellspalte, die mit der primären Identität des Nachschlagedatensatzes verknüpft werden soll.

  note
  NOTE
  Der für dieses Feld eingegebene Wert kann entweder eine Feld-ID (profile.packages.packageSKU), ein in einem Journey-Ereignis übergebenes Feld (context.journey.events.event_ID.productSKU) oder ein statischer Wert (sku007653) sein. In jedem Fall verwendet das System den Wert und durchsucht den Datensatz, um zu überprüfen, ob er mit einem Schlüssel übereinstimmt.
  Wenn Sie einen Zeichenfolgenwert in Textform für den Schlüssel verwenden, lassen Sie den Text in Anführungszeichen stehen. Beispiel: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}. Wenn Sie einen Attributwert als dynamischen Schlüssel verwenden, entfernen Sie die Anführungszeichen. Beispiel: {{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}

• result ist ein beliebiger Name, den Sie angeben müssen, um auf alle Feldwerte zu verweisen, die Sie aus dem Datensatz abrufen wollen. Dieser Wert wird in Ihrem Code verwendet, um jedes Feld aufzurufen.

• required=false: Wenn „required“ auf „TRUE“ gesetzt ist, wird die Nachricht nur gesendet, wenn ein übereinstimmender Schlüssel gefunden wird. Wenn der Wert auf „false“ gesetzt ist, ist kein übereinstimmender Schlüssel erforderlich, um die Nachricht zuzustellen. Beachten Sie, dass bei Festlegung auf „false“ empfohlen wird, Fallback- oder Standardwerte in Ihrem Nachrichteninhalt zu berücksichtigen.

Passen Sie die Syntax an Ihre Anforderungen an. In diesem Beispiel möchten wir Daten zu Passagierflügen abrufen. Es gilt folgende Syntax:

{{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}

• Wir arbeiten mit dem Datensatz, dessen ID „1234567890abcdtId“ lautet.
• Das Feld, das wir verwenden möchten, um einen Join mit dem Suchdatensatz herzustellen, lautet profile.upcomingFlightId,
• Wir möchten alle Feldwerte unter der Referenz „Flug“ einbeziehen.

Nachdem die im Adobe Experience Platform-Datensatz aufzurufende Syntax konfiguriert wurde, können Sie angeben, welche Felder Sie abrufen möchten. Es gilt folgende Syntax:

{{result.fieldId}}

• result ist der Wert, den Sie dem Parameter result in der Hilfsfunktion datasetLookup zugewiesen haben. In diesem Beispiel ist es „flight“.

• fieldID ist die ID des Feldes, das Sie abrufen möchten. Diese ID ist in der Benutzeroberfläche von Adobe Experience Platform sichtbar, wenn Sie das Eintragschema durchsuchen, das mit Ihrem Datensatz verknüpft ist:

  accordion
  Wo kann ich eine Feld-ID abrufen?
  Feld-IDs können bei der Vorschau eines Datensatzes in der Benutzeroberfläche von Adobe Experience Platform abgerufen werden. In der Adobe Experience Platform-Dokumentation erfahren Sie, wie Sie eine Vorschau von Datensätzen anzeigen.

In diesem Beispiel möchten wir Informationen über die Einstiegszeit und den Flugsteig der Fluggäste verwenden. Fügen Sie daher die beiden folgenden Zeilen hinzu:

• {{flight._myorg.booking.boardingTime}}
• {{flight._myorg.booking.gate}}

Da Ihr nun Code fertig ist, können Sie Ihren Inhalt wie gewohnt abschließen und ihn mit einer der beiden Simulationsmethoden testen: Klicken Sie auf Inhalte simulieren, um Inhaltsvarianten mit Beispieleingabedaten oder automatischer KI-Generierung zu testen, oder klicken Sie auf Inhalte simulieren und wählen Sie dann Inhalte simulieren (AEP-Profile) aus dem Dropdown-Menü aus, um eine Vorschau mit Testprofilen anzuzeigen. Erfahren Sie, wie Sie Inhalte in der Vorschau anzeigen und testen können