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 expressActivation für die Zielgruppe zum Zeitpunkt der Erstellung aktivieren. Dadurch wird Journey Optimizer angewiesen, jeden Eintrag unabhängig und ohne Deduplizierung nach Profil-ID zu aktivieren. Diese Markierung 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 Header:

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}

Anfrage-Inhalt (expressActivation: true festlegen):

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

Die vollständige Referenz finden Sie in der API-Dokumentation zum Erstellen externer Zielgruppen.

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page explains how to use supplemental identifiers in Adobe Journey Optimizer journeys to allow a single profile to have multiple concurrent journey instances, each scoped to a distinct secondary ID such as a booking, subscription, or policy ID.

Intents:

• Understand when and why to use a supplemental identifier instead of relying solely on a profile ID
• Configure a supplemental identifier in an event-triggered journey by marking an attribute as an identity in the event schema
• Configure a supplemental identifier in a Read audience journey by enabling the option in the Read audience activity
• Reference supplemental identifier attributes for message personalization and conditional logic using the expression editor
• Apply the correct expression syntax to iterate over object arrays keyed by a supplemental ID
• Identify guardrails and limitations before implementing supplemental identifiers in a journey

Glossary:

• Supplemental identifier: A secondary identifier (e.g., order ID, booking ID, subscription ID) used alongside the profile ID to scope a journey instance to a specific record, enabling multiple concurrent instances per profile (product-specific)
• Profile ID: The primary identifier used by default to execute journeys; a profile active in a journey cannot re-enter another journey without a supplemental ID
• Non-person identifier namespace: An identity namespace that does not represent a person (required for supplemental IDs); must be distinct from the primary identity namespace
• joai namespace: Not applicable to this page (see inbound actions troubleshooting)
• DULE: Data Use Labelling and Enforcement — the data governance policy validation framework in Adobe Experience Platform; supplemental IDs are not subject to DULE checks

Guardrails:

• Supplemental identifiers are supported only for event-triggered and Read audience journeys; not supported for Audience qualification journeys
• A profile cannot have more than 10 concurrent journey instances
• Each journey instance counts toward frequency capping even when created via supplemental identifiers
• The supplemental identifier must be of type string; string arrays and maps are not supported
• The supplemental ID attribute must not be marked as Primary identity in the schema
• The namespace used for the supplemental ID must be a non-person identifier namespace
• After applying the non-person identity namespace to a schema, a new event or field group must be created; existing entities cannot be refreshed
• For Read audience journeys with supplemental IDs: the reading rate is limited to 500 profiles per second per journey instance; only Unified Profile Service audiences are supported; supplemental ID must be a profile field (not an event/context field)
• Downstream events in the same journey must use the same supplemental ID and namespace
• Supplemental ID is disabled for Read audience journeys that use a business event

Terminology:

• Canonical name: Supplemental identifier — Acronym: none — variants: supplemental ID, secondary identifier
• Synonyms: “supplemental identifier” = “supplemental ID” (used interchangeably in the UI and documentation)
• Do not confuse: “supplemental identifier” ≠ “primary identity” — the supplemental ID must never be marked as the primary identity in the schema

FAQ:

• Q: What is a supplemental identifier used for? — It allows a single profile to enter and execute a journey multiple times simultaneously, with each instance scoped to a different secondary record such as a booking, subscription, or policy ID.
• Q: Which journey types support supplemental identifiers? — Event-triggered journeys and Read audience journeys. Audience qualification journeys do not support supplemental identifiers.
• Q: How many concurrent journey instances can a profile have with supplemental identifiers? — A maximum of 10 concurrent journey instances per profile.
• Q: Can I use the supplemental ID attributes for message personalization? — Yes. Reference them via the Contextual attributes menu in the expression editor or personalization editor.
• Q: Does the supplemental ID need to be marked as a Primary identity in the schema? — No. It must be marked as an Identity but must not be set as the Primary identity.
• Q: Are DULE governance policies applied to the supplemental identifier? — No. DULE validation checks are not performed on the supplemental ID.