在歷程中使用補充識別碼 supplemental-id

在補充ID為bookingNum且屬性位於相同層級bookingCountry的物件陣列中，歷程將根據bookingNum逐一檢視陣列物件，並為每個物件建立歷程執行個體。

• 條件活動中的下列運算式將逐一檢視物件陣列，並檢查bookingCountry的值是否等於「FR」：

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

• 電子郵件個人化編輯器中的下列運算式將會逐一檢視物件陣列、提取適用於目前歷程執行個體的bookingCountry，並在內容中顯示它：

  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}}

• 用來觸發歷程的事件範例：

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

您必須在建立時啟用對象的expressActivation。 這會告訴Journey Optimizer要獨立啟用每筆記錄，而不需依設定檔ID重複資料刪除。 建立受眾後，就無法變更此標幟。

建立對象時，請使用下列API呼叫：

端點：

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

必要的標頭：

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}

要求內文（設定expressActivation: true）：

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

如需完整參考資訊，請參閱建立外部對象API檔案。

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.