Verwenden von Adobe Experience Platform-Daten in Journeys datalookup

Filterung anhand von Produktkategorien

Szenario Ein Coupon für Benutzende, die mehr als 40 $ für Haushaltsprodukte ausgeben.

Journey-Fluss:

1. Kaufereignis: Erfassen Sie SKUs im Warenkorb von Benutzenden.

2. Aktivität „Datensatzsuche“:

   • Datensatz: products-dataset (SKU als Primärschlüssel).
   • Suchschlüssel: list(@event{purchase_event.products.sku}).
   • Zurückzugebende Felder: ["SKU", "category", "price"].

3. Bedingungsaktivität:

   • Filtern nach SKUs, bei denen die Kategorie „Haushalt“ lautet.

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   ODER

   • Aggregieren der Gesamtausgaben für Haushaltsprodukte und vergleichen mit dem Schwellenwert von 40 $.

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. Personalisierungseditor:

   Verwenden Sie die angereicherten Daten, um den E-Mail-Inhalt zu personalisieren:

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

Personalisierung mit externen Treuedaten

Szenario: Ermitteln Sie, welches E-Mail-Konto für ein Profil den Treuestatus „Platin“ aufweist. In diesem Szenario ist das Treuekonto mit einer E-Mail-ID verknüpft und im Standardspeicher für die Profilsuche sind keine Treuedaten verfügbar.

Journey-Fluss:

1. Profilereignis-Trigger: Erfassen Sie E-Mail-IDs aus dem Profil- oder Ereigniskontext.

2. Aktivität „Datensatzsuche“:

   • Datensatz: loyalty-member-dataset (E-Mail als Primärschlüssel).
   • Suchschlüssel: @profile.email.
   • Zurückzugebende Felder: ["email", "loyaltyTier"].

3. Bedingungsaktivität:

   Verzweigen Sie die Journey anhand der Treuestufe:

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. Personalisierungseditor:

   Verwenden Sie die angereicherten Treuestufendaten, um ausgehende Kommunikation zu personalisieren:

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

KI-Wissensreferenz

Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.

Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.

• TL;DR: Auf dieser Seite wird erläutert, wie Sie die Datensatzsuchaktivität konfigurieren können, um AEP-Datensatzdaten zur Journey-Laufzeit dynamisch abzurufen, um Personalisierung in Echtzeit und bedingte Logik zu nutzen.

intents:

• Hinzufügen einer Datensatz-Lookup-Aktivität zu einer Journey, um externe AEP-Datensatzdaten zur Laufzeit abzurufen
• Bestimmte Datensatzfelder (Blattknoten/Grundwerte) auswählen, die während der Suche abgerufen werden sollen
• Definieren eines Suchschlüssels im erweiterten Modus, um Journey-Kontext mit Datensatzdatensätzen zu verbinden
• Verwenden von angereicherten Datensatzdaten im Journey-Ausdruckseditor oder Personalisierungseditor
• Fehlerbehebung bei Fehlern bei „Datensatz-Suche nicht gefunden“, die durch die Verwendung des einfachen Modus für den Suchschlüssel verursacht wurden

Glossar:

• Datensatzsuchaktivität: Eine Journey-Orchestrierungsaktivität, die Daten zur Laufzeit aus AEP-Datensatzdatensätzen mithilfe eines Verbindungsschlüssels abruft produktspezifisch)
• Blattknoten: Ein Feld auf der niedrigsten Ebene einer Schemahierarchie, das einen primitiven Wert (Zeichenfolge, Zahl, boolescher Wert, Datum) enthält (produktspezifisch)
• Lookup key: Der Verbindungsausdruck (Zeichenfolge oder Liste von Zeichenfolgen), mit dem Journey-Kontextdaten mit Datensätzen im ausgewählten Datensatz abgeglichen werden (produktspezifisch)
• Angereicherte Daten: Daten, die von einer Datensatzsuchaktivität abgerufen und vorübergehend im Journey-Kontext gespeichert werden, um sie in nachgelagerten Aktivitäten zu verwenden (produktspezifisch)

Leitplanken:

• Maximal 10 Datensatzsuchaktivitäten pro Journey.
• Pro Lookup-Aktivität können maximal 20 ausgewählte Felder ausgewählt werden.
• Es können maximal 50 Schlüssel im Suchschlüssel-Array vorhanden sein.
• Die Größe der angereicherten Daten ist auf 10 KB beschränkt.
• Der Datensatz muss in Adobe Experience Platform für die Suche aktiviert sein, bevor er in der Aktivitätskonfiguration angezeigt wird.
• Es können nur Blattknoten (primitive Werte) ausgewählt werden. Arrays und Karten können nicht ausgewählt werden.
• Als Lookup-Schlüssel werden nur Zeichenfolgen oder Zeichenfolgenlisten unterstützt.
• Der Lookup-Schlüssel muss im erweiterten Modus definiert werden. Die Verwendung des einfachen Modus führt dazu, dass die Aktivitätsausgabe nachgelagert nicht als Kontextattribut verfügbar ist.
• Angereicherte Daten sind vorübergehend und nur während der Journey-Laufzeit und bei der Personalisierung ausgehender Aktivitäten verfügbar.
• Um eine optimale Leistung zu erzielen, begrenzen Sie die Anzahl der Lookup-Aktivitäten auf 5 pro Journey (empfohlen). Die vom System erzwungene feste Grenze beträgt 10 Aktivitäten pro Journey. Es werden auch bis zu 20 Attribute pro Suche empfohlen.

Terminologie:

• Kanonischer Name: Datensatz-Suchaktivität — Akronym: n/a — Varianten: AEP-Datensuche, Datenanreicherungsaktivität
• Synonyme: „lookup key“ = „Verbindungsschlüssel“
• Verwechseln Sie nicht: „Datensatzsuchaktivität“ ≠ „Erlebnisereignis-Suche“ — durch die Datensatzsuche werden Datensatzdaten und nicht Zeitreihen-Erlebnisereignisse abgerufen

FAQ:

• F: Warum wird mein Datensatz nicht in der Dropdown-Liste Datensatzfeld angezeigt? - Der Datensatz muss für die Suche in Adobe Experience Platform aktiviert sein. Befolgen Sie die Anweisungen im Abschnitt „Muss gelesen werden“, um diese zu aktivieren.
• F: Warum gibt @datasetLookup{} den Fehler „Datensatzsuche nicht gefunden“ in einer Bedingung zurück? - Der Lookup-Schlüssel wurde im einfachen Modus anstelle des erweiterten Modus definiert. Definieren Sie sie im erweiterten Modus neu und veröffentlichen Sie die Journey erneut.
• F: Kann ich Arrays oder Zuordnungsfelder aus dem Datensatz abrufen? — Nein, es können nur primitive Blattknotenfelder (Zeichenfolge, Zahl, Boolesch, Datum) ausgewählt werden.
• F: Wie greife ich in einer E-Mail auf angereicherte Daten zu? - Verwenden Sie den Personalisierungseditor mit dem {{context.journey.datasetLookup.<activityId>.entities}}.
• F: Werden angereicherte Daten nach dem Ende der Journey beibehalten? — Nein, angereicherte Daten sind vorübergehend und nur während der Journey-Laufzeitsitzung verfügbar.