UI에서 열거형 및 제안 값 정의

XDM(Experience Data Model)에서 사전 정의된 허용 또는 제안 값 세트를 문자열 필드에 제공하여 해당 필드에 수집되는 값 또는 세그먼테이션에서 동작하는 방법을 더 잘 제어할 수 있습니다.

An enum 문자열 필드에 대해 수집할 수 있는 값을 사전 정의된 세트로 제한합니다. 데이터를 열거형 필드에 수집하려고 하며 값이 해당 구성에 정의된 데이터와 일치하지 않으면 수집이 거부됩니다.

열거형과는 반대로, 제안된 값 문자열 필드로 이동해도 처리할 수 있는 값이 제한되지 않습니다. 대신, 제안된 값은 세그멘테이션 UI 문자열 필드를 속성으로 포함할 때.

When 새 필드 정의 Adobe Experience Platform 사용자 인터페이스에서 유형을 문자열를 정의할 수 있는 옵션이 제공됩니다 enum 또는 제안된 값 해당 필드에 대해 입력합니다.

UI의 문자열 필드에 대해 활성화된 열거형 및 제안된 값 옵션을 보여주는 이미지

열거형 정의

선택 열거형 및 추천 값​를 선택하고 을 선택합니다. 열거형. 열거형의 값 제약 조건을 지정할 수 있도록 해주는 추가 컨트롤이 나타납니다. 구속을 추가하려면 행 추가.

UI에서 선택한 열거형 옵션을 보여주는 이미지

아래에 열에서 필드를 다음으로 제한하려는 정확한 값을 제공해야 합니다. 또한, 다음과 같이 사용자에게 친숙한 기능을 제공할 수도 있습니다 표시 이름 또한, 값이 세그멘테이션에서 표시되는 방식에 영향을 주는 제한입니다.

계속 사용 행 추가 원하는 제약 조건 및 선택적 레이블을 열거형에 추가하려면 또는 삭제 아이콘(삭제 아이콘 이미지)을 클릭하여 레코드 추가를 제거합니다. 완료되면 을 선택합니다 적용 스키마에 변경 사항을 적용하려면

UI의 문자열 필드에 대해 채워진 열거형 값 및 표시 이름을 표시하는 이미지

캔버스가 변경 사항을 반영하도록 업데이트됩니다. 나중에 이 스키마를 탐색할 때 오른쪽 레일 내에서 열거형 필드에 대한 제한을 보고 편집할 수 있습니다.

제안된 값 정의

선택 열거형 및 추천 값​를 선택하고 을 선택합니다. 제안된 값 추가 컨트롤을 표시하려면 여기에서 을 선택합니다. 행 추가 제안 값 추가를 시작하려면 다음을 수행하십시오.

UI에서 선택한 추천 값 옵션을 보여주는 이미지

아래에 표시 이름 열에서 세분화 UI에 표시할 값에 대해 친숙한 이름을 제공합니다. 제안된 값을 추가하려면 행 추가 필요에 따라 프로세스를 다시 반복하고 반복합니다. 이전에 추가한 행을 제거하려면 삭제 아이콘 문제의 행 옆에 있습니다.

완료되면 을 선택합니다 적용 스키마에 변경 사항을 적용하려면

UI의 문자열 필드에 대해 채워진 열거형 값 및 표시 이름을 표시하는 이미지

노트

필드의 업데이트된 제안된 값이 세그멘테이션 UI에 반영되는 경우 약 5분 지연이 있습니다.

표준 필드에 대해 제안된 값 관리

표준 XDM 구성 요소의 일부 필드에는 다음과 같이 고유한 제안된 값이 포함되어 있습니다 eventType 에서 XDM ExperienceEvent 클래스. 표준 필드에 대해 추가적인 제안 값을 생성할 수 있지만, 조직에서 정의하지 않은 제안된 값은 수정하거나 제거할 수 없습니다. UI에서 표준 필드를 볼 때 해당 제안된 값이 표시되지만 읽기 전용입니다.

UI의 문자열 필드에 대해 채워진 열거형 값 및 표시 이름을 표시하는 이미지

표준 필드에 대해 제안된 새 값을 추가하려면 행 추가. 이전에 조직에서 추가한 제안 값을 제거하려면 을 선택합니다 삭제 아이콘 문제의 행 옆에 있습니다.

UI의 문자열 필드에 대해 채워진 열거형 값 및 표시 이름을 표시하는 이미지

열거형 및 제안된 값에 대한 진행 규칙

열거형 필드가 있는 스키마가 데이터를 Platform으로 수집하는 데 사용되면 스키마 정의에 대한 추가 변경 사항은 시스템에 이미 있는 데이터를 준수해야 합니다. 일반적으로 기존 필드를 변경하면 해당 필드만 만들 수 있습니다 less 제한. 필드는 이미 있는 것보다 더 제한적으로 만들 수 없습니다.

열거형 및 제안된 값에 대해 다음 규칙이 수집 후 적용됩니다.

  • 사용자 CAN 기존의 제안된 값과 함께 표준 및 사용자 지정 필드에 대해 제안된 값을 추가합니다.
  • 사용자 CAN 기존의 제안된 값을 사용하여 사용자 지정 필드에서 제안된 값을 제거합니다.
  • 사용자 CAN 기존 사용자 지정 열거형 필드에 대한 새 열거형 값을 추가합니다.
  • 사용자 CAN 사용자 지정 필드의 열거형 값을 제안되는 값으로만 전환하거나, 열거형 또는 제안된 값이 없는 문자열로 변환합니다. 이 스위치는 적용한 후에는 취소할 수 없습니다.
  • 사용자 CANNOT 표준 필드에서 열거형 또는 제안 값을 제거합니다.
  • 사용자 CANNOT 기존 열거형이 없는 필드에 열거형 값을 추가합니다.
  • 사용자 CANNOT 사용자 지정 필드에 대한 기존의 모든 열거형 값보다 작은 값을 제거합니다.
  • 사용자 CANNOT 제안된 값에서 열거형으로 전환합니다.

열거형 및 제안된 값에 대한 규칙 병합

여러 스키마에서 구성이 다른 동일한 동일한 열거형 필드를 사용하고 해당 스키마가 결합에 포함된 경우 열거형 차이가 조정되는 방식에 대해 특정 규칙이 적용됩니다. 정확한 규칙은 스키마가 동일한 표준 필드(예: eventType) 또는 다른 필드 그룹에서 동일한 사용자 지정 필드 경로를 참조하는 경우

동일한 표준 필드를 참조하는 경우:

  • 추가적인 추천 값은 추가됨 노조에서
  • 동일한 열거형 키에 대해 제안된 값에 대한 업데이트는 다음과 같습니다 업데이트됨 노조에서

다른 필드 그룹에서 동일한 사용자 지정 필드 경로를 참조하는 경우:

  • 추가적인 추천 값은 추가됨 노조에서
  • 두 개 이상의 스키마에 동일한 추가 제안된 값이 정의되어 있으면 해당 값은 다음과 같습니다 병합됨 노조에서 즉, 병합한 후 동일한 제안된 값이 두 번 표시되지 않습니다.

유효성 검사 제한 사항

현재 시스템 제한 사항으로 인해, 섭취 중에 시스템에서 열거형의 유효성을 검사하지 않는 두 가지 경우가 있습니다.

  1. 열거형은 배열 필드.
  2. 열거형은 스키마 계층 구조에서 두 개 이상의 수준에서 정의됩니다.

다음 단계

이 안내서에서는 UI에서 문자열 필드에 대한 열거형 및 제안 값을 정의하는 방법을 다룹니다. 스키마 레지스트리 API를 사용하여 열거형 및 제안 값을 관리하는 방법에 대한 자세한 내용은 다음을 참조하십시오 튜토리얼.

에서 다른 XDM 필드 유형을 정의하는 방법을 배우려면 Schema Editor, 개요 참조 ui에서 필드 정의.

이 페이지에서는