Verwenden zusätzlicher Kennungen in Journeys supplemental-id

In einem Objekt-Array mit der zusätzlichen ID als bookingNum und einem Attribut auf derselben Ebene namens bookingCountry iteriert die Journey durch das Array-Objekt auf der Grundlage der bookingNum und erstellt für jedes Objekt eine Journey-Instanz.

• Der folgende Ausdruck in der Bedingungsaktivität iteriert durch das Objekt-Array und prüft, ob der Wert von bookingCountry gleich „FR“ ist:

  code language-none
  @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR"

• Der folgende Ausdruck im E-Mail-Personalisierungseditor iteriert durch das Objekt-Array, ruft das bookingCountry für die aktuelle Journey-Instanz ab und zeigt es im Inhalt an:

  code language-none
  {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}}

• Beispiel für das Ereignis, das zum Auslösen der Journey verwendet wird:

  code language-none
  "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]

Sie müssen die expressActivation für die Zielgruppe zum Zeitpunkt der Erstellung aktivieren. Dadurch wird Journey Optimizer angewiesen, jeden Datensatz unabhängig und ohne Deduplizierung nach Profil-ID zu aktivieren. Dieses Flag kann nach der Erstellung der Zielgruppe nicht mehr geändert werden.

Verwenden Sie beim Erstellen der Zielgruppe den folgenden API-Aufruf:

Endpunkt:

POST https://platform.adobe.io/data/core/ais/external-audience

Erforderliche Kopfzeilen:

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
x-sandbox-name: {SANDBOX_NAME}

Anfragetext (expressActivation: true festgelegt):

{
  "name": "my_audience_name",
  "fields": [ ... ],
  "sourceSpec": { ... },
  "audienceType": "people",
  "namespace": "CustomerAudienceUpload",
  "expressActivation": true
}

Die vollständige Referenz finden ​ in der Dokumentation ​ Erstellen einer externen Zielgruppen-API .

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 zusätzliche IDs in Adobe Journey Optimizer-Journey verwenden können, damit ein einzelnes Profil über mehrere gleichzeitige Journey-Instanzen verfügen kann, von denen jede eine unterschiedliche sekundäre ID aufweist, z. B. eine Buchungs-, Abonnement- oder Richtlinien-ID.

intents:

• Erfahren Sie, wann und warum Sie eine zusätzliche Kennung verwenden sollten, anstatt sich ausschließlich auf eine Profil-ID zu verlassen
• Konfigurieren Sie eine zusätzliche Kennung in einem ereignisausgelösten Journey, indem Sie im Ereignisschema ein Attribut als Identität markieren.
• Konfigurieren Sie eine zusätzliche Kennung auf einer Journey mit dem Titel „Zielgruppe lesen“, indem Sie die Option in der Aktivität „Zielgruppe lesen“ aktivieren
• Referenzieren zusätzlicher ID-Attribute für die Personalisierung von Nachrichten und bedingte Logik mithilfe des Ausdruckseditors
• Wenden Sie die richtige Ausdruckssyntax an, um über Objekt-Arrays zu iterieren, die von einer zusätzlichen ID verschlüsselt werden
• Ermitteln Sie Leitplanken und Einschränkungen, bevor Sie zusätzliche Kennungen in einer Journey implementieren.

Glossar:

• Zusätzliche Kennung: Eine sekundäre Kennung (z. B. Bestell-ID, Buchungs-ID, Abonnement-ID), die zusammen mit der Profil-ID verwendet wird, um eine Journey-Instanz auf einen bestimmten Datensatz zu beschränken, sodass mehrere gleichzeitige Instanzen pro (produktspezifisch) möglich sind
• Profil-ID: Die primäre Kennung, die standardmäßig zur Ausführung von Journey verwendet wird. Ein Profil, das auf einer Journey aktiv ist, kann ohne eine zusätzliche ID keine andere Journey erneut eingeben
• Nicht-Personen-ID-Namespace: Ein Identity-Namespace, der keine Person darstellt (erforderlich für zusätzliche IDs); muss sich vom primären Identity-Namespace unterscheiden
• Joai-Namespace: Nicht auf diese Seite anwendbar (siehe Fehlerbehebung bei eingehenden Aktionen)
• DULE: Datennutzungskennzeichnung und -durchsetzung - das Data Governance-Richtlinien-Validierungs-Framework in Adobe Experience Platform; zusätzliche IDs unterliegen keinen DULE-Prüfungen

Leitplanken:

• Zusätzliche Kennungen werden nur für ereignisgesteuerte und „Zielgruppen-Journey lesen“ unterstützt. Für Journey werden keine Kennungen für Zielgruppen-Qualifizierungen unterstützt
• Ein Profil kann nicht mehr als 10 gleichzeitige Journey-Instanzen haben
• Jede Journey-Instanz zählt zur Frequenzlimitierung, selbst wenn sie über zusätzliche Kennungen erstellt wird
• Die zusätzliche Kennung muss vom Typ string sein. Zeichenfolgen-Arrays und Zuordnungen werden nicht unterstützt
• Das zusätzliche ID-Attribut darf im Schema nicht als Primäre Identität markiert sein
• Der Namespace, der für die zusätzliche ID verwendet wird, muss ein Namespace mit einer Nicht-Personen-Kennung sein
• Nachdem Sie den Nicht-Personen-Identity-Namespace auf ein Schema angewendet haben, muss ein neues Ereignis oder eine neue Feldergruppe erstellt werden. Vorhandene Entitäten können nicht aktualisiert werden
• Für Journey mit zusätzlichen IDs vom Typ „Zielgruppe lesen“: Die Leserate ist auf 500 Profile pro Sekunde pro Journey-Instanz beschränkt. Nur Zielgruppen des einheitlichen Profildienstes werden unterstützt. Zusätzliche ID muss ein Profilfeld sein (kein Ereignis-/Kontextfeld)
• Nachgelagerte Ereignisse auf derselben Journey müssen dieselbe zusätzliche ID und denselben Namespace verwenden
• Die zusätzliche ID ist für Journey des Typs Zielgruppe lesen deaktiviert, die ein Geschäftsereignis verwenden

Terminologie:

• Kanonischer Name: Zusätzliche Kennung — Akronym: keine — Varianten: zusätzliche Kennung, sekundäre Kennung
• Synonyme: „Supplemental Identifier“ = „Supplemental ID“ (synonym in der Benutzeroberfläche und Dokumentation verwendet)
• Verwechseln Sie nicht: „Zusätzliche Kennung“ ≠ „primäre Identität“ - die zusätzliche ID darf im Schema nie als primäre Identität markiert werden

FAQ:

• F: Wofür wird eine zusätzliche Kennung verwendet? - Dadurch kann ein einzelnes Profil mehrmals gleichzeitig in einen Journey eintreten und ihn ausführen, wobei jede Instanz einen anderen sekundären Datensatz wie eine Buchungs-, Abonnement- oder Richtlinien-ID aufweist.
• F: Welche Journey-Typen unterstützen zusätzliche Kennungen? — Ereignisausgelöste Journey und Journey von Zielgruppen lesen. Journey für die Zielgruppenqualifizierung unterstützen keine zusätzlichen Kennungen.
• F: Wie viele gleichzeitige Journey-Instanzen kann ein Profil mit zusätzlichen Kennungen haben? - Es können maximal 10 gleichzeitige Journey-Instanzen pro Profil verwendet werden.
• F: Kann ich die zusätzlichen ID-Attribute für die Nachrichtenpersonalisierung verwenden? — Ja. Referenzieren Sie sie über das Menü Kontextuelle Attribute im Ausdruckseditor oder Personalisierungseditor.
• F: Muss die zusätzliche ID als Primäre Identität im Schema markiert werden? — Nein. Sie muss als Identität gekennzeichnet sein, darf jedoch nicht als Primäre Identität festgelegt werden.
• F: Werden die DULE-Governance-Richtlinien auf die zusätzliche Kennung angewendet? — Nein. DULE-Validierungsprüfungen werden für die zusätzliche ID nicht durchgeführt.