여정에서 추가 식별자 사용 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 만들기 설명서를 참조하십시오.

이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.

이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.

• TL;DR: 이 페이지에서는 Adobe Journey Optimizer 여정에서 보조 식별자를 사용하여 단일 프로필에 예약, 구독 또는 여정 ID와 같은 고유한 보조 ID로 범위가 지정된 여러 개의 동시 인스턴스를 허용하는 방법에 대해 설명합니다.

의도:

• 프로필 ID에만 의존하는 대신 보조 식별자를 사용하는 시기와 이유를 이해합니다
• 속성을 이벤트 스키마에서 ID로 표시하여 이벤트가 트리거된 여정에서 보조 식별자를 구성합니다
• 대상자 읽기 활동에서 옵션을 활성화하여 대상자 읽기 여정에서 보조 식별자를 구성합니다
• 표현식 편집기를 사용하여 메시지 개인화 및 조건부 논리에 대한 보조 식별자 속성 참조
• 올바른 표현식 구문을 적용하여 보조 ID로 처리된 오브젝트 배열을 반복합니다
• 여정에서 추가 식별자를 구현하기 전에 보호 기능 및 제한 사항 식별

용어집:

• 보조 식별자: 프로필 ID와 함께 사용하여 여정 인스턴스를 특정 레코드로 확장하고 (제품별) 프로필당 여러 개의 동시 인스턴스를 활성화하는 보조 식별자(예: 주문 ID, 예약 ID, 구독 ID)
• 프로필 ID: 여정을 실행하는 데 기본적으로 사용되는 기본 식별자입니다. 여정에서 활성 상태인 프로필은 보조 ID가 없으면 다른 여정을 다시 입력할 수 없습니다.
• 비개인 식별자 네임스페이스: 개인을 나타내지 않는 ID 네임스페이스(보조 ID에 필요)입니다. 기본 ID 네임스페이스와 구별되어야 합니다.
• joai 네임스페이스: 이 페이지에 적용할 수 없습니다(인바운드 동작 문제 해결 참조).
• DULE: 데이터 레이블 지정 및 적용 사용 - Adobe Experience Platform의 데이터 거버넌스 정책 유효성 검사 프레임워크, 보조 ID는 DULE 검사의 대상이 아닙니다

보호 기능:

• 보조 식별자는 여정 트리거 및 대상 읽기 이벤트에만 지원되며, 대상 자격 여정에 대해서는 지원되지 않습니다
• 프로필에는 동시 여정 인스턴스가 10개를 초과할 수 없습니다.
• 각 여정 인스턴스는 보조 식별자를 통해 생성된 경우에도 빈도 상한에 포함됩니다
• 보조 식별자는 string 형식이어야 합니다. 문자열 배열 및 맵은 지원되지 않습니다.
• 보조 ID 속성은 스키마에서 기본 ID로 표시되지 않아야 합니다.
• 보조 ID에 사용되는 네임스페이스는 비개인 식별자 네임스페이스여야 합니다.
• 비개인 ID 네임스페이스를 스키마에 적용한 후에는 새 이벤트 또는 필드 그룹을 만들어야 합니다. 기존 엔터티는 새로 고칠 수 없습니다
• 보조 ID가 있는 대상 여정 읽기의 경우: 읽기 비율은 여정 인스턴스당 초당 500개의 프로필로 제한됩니다. 통합 프로필 서비스 대상만 지원됩니다. 보조 ID는 프로필 필드(이벤트/컨텍스트 필드가 아님)여야 합니다
• 동일한 여정의 다운스트림 이벤트는 동일한 보충 ID 및 네임스페이스를 사용해야 합니다
• 비즈니스 이벤트를 사용하는 대상자 읽기 여정에 대해서는 보조 ID가 비활성화됩니다

용어:

• 정식 이름: 보조 식별자 — 약어: 없음 — 변형: 보조 ID, 보조 식별자
• 동의어: “supplemental identifier” = “supplemental ID” (UI 및 설명서에서 상호 교환하여 사용됨)
• 혼동하지 마십시오. “보조 식별자”≠ “기본 ID” — 보조 ID를 스키마에서 기본 ID로 표시해서는 안 됩니다

FAQ:

• Q: 보조 ID는 무엇에 사용됩니까? — 단일 프로필에서 예약, 구독 또는 여정 ID와 같은 다른 보조 레코드로 범위가 지정되는 동시에 정책을 여러 번 입력하고 실행할 수 있습니다.
• Q: 보조 식별자를 지원하는 여정 유형은 무엇입니까? — 이벤트가 트리거된 여정 및 대상자 읽기 여정. 대상 자격 여정은 보조 식별자를 지원하지 않습니다.
• Q: 보충 식별자를 사용하여 프로필에 포함할 수 있는 동시 여정 인스턴스 수는 몇 개입니까? — 프로필당 최대 10개의 동시 여정 인스턴스.
• Q: 메시지 개인화에 보조 ID 특성을 사용할 수 있습니까? — 예. 표현식 편집기 또는 개인화 편집기의 상황별 속성 메뉴를 통해 이를 참조합니다.
• Q: 보조 ID를 스키마에서 기본 ID로 표시해야 합니까? — 아니요. ID로 표시되어야 하지만 기본 ID로 설정해서는 안 됩니다.
• Q: DULE 거버넌스 정책이 보조 식별자에 적용됩니까? — 아니요. 보조 ID에 대해서는 DULE 유효성 검사가 수행되지 않습니다.