Show Menu
화제×

스키마 편집기를 사용하여 스키마 만들기

스키마 레지스트리는 Adobe Experience Platform 스키마 라이브러리의 모든 리소스를 보고 관리할 수 있는 사용자 인터페이스 및 RESTful API를 제공합니다. 스키마 라이브러리에는 Adobe, Experience Platform 파트너 및 사용자가 응용 프로그램을 사용하는 공급업체가 제공하는 리소스뿐만 아니라, 사용자가 정의하고 스키마 레지스트리에 저장하는 리소스가 포함되어 있습니다.
이 자습서에서는 Experience Platform 내의 스키마 편집기를 사용하여 스키마를 만드는 단계를 설명합니다. 스키마 레지스트리 API를 사용하여 스키마를 작성하려는 경우 API를 사용하여 스키마를 만드는 자습서를 시도하기 전에 스키마 레지스트리 개발자 가이드 를 읽어 보십시오 스키마 레지스트리 API를 사용하여 스키마 만들기 .
이 자습서에는 스키마를 구성하는 데 사용할 수 있는 새 클래스를 정의하는 단계도 포함되어 있습니다.

시작하기

이 자습서에서는 스키마 편집기 사용과 관련된 Adobe Experience Platform의 다양한 측면을 파악해야 합니다. 이 자습서를 시작하기 전에 다음 개념을 살펴보십시오.
이 자습서를 사용하려면 Experience Platform에 액세스해야 합니다. Experience Platform에서 IMS 조직에 액세스할 수 없는 경우 시스템 관리자에게 문의하십시오.

스키마 작업 공간에서 기존 스키마 찾아보기

Experience Platform 내의 스키마 작업 영역에서는 스키마 라이브러리의 시각화를 제공하므로 사용자가 사용 가능한 모든 스키마를 보고 관리할 수 있을 뿐만 아니라 새 스키마를 작성할 수 있습니다. 작업 영역에는 이 자습서 전체에서 스키마를 작성할 캔버스인 스키마 편집기도 포함되어 있습니다.
Experience Platform에 로그인한 후 왼쪽 탐색 에서 스키마를 클릭하면 스키마 작업 영역으로 이동합니다. 사용 가능한 모든 스키마를 보고, 관리하고 사용자 정의할 수 있는 스키마 목록(스키마 라이브러리 표현)이 표시됩니다. 이 목록에는 스키마의 기반이 되는 이름, 유형, 클래스 및 동작(레코드 또는 시간 시리즈)과 스키마를 마지막으로 수정한 날짜 및 시간이 포함됩니다.
클래스, 믹싱 및 데이터 형식을 포함하여 레지스트리의 모든 리소스에 대한 필터링 기능을 사용하려면 검색 막대 옆에 있는 필터 아이콘을 클릭합니다.

스키마 만들기 및 이름 지정

스키마 작성을 시작하려면 스키마 작업 영역의 오른쪽 모서리에서 스키마 만들기를 클릭합니다.
스키마 편집기가 나타납니다. 스키마를 작성할 캔버스입니다. 편집기에 도착하면 사용자 지정을 시작할 수 있도록 캔버스의 구조 섹션에 있는 "제목 없는 스키마"가 자동으로 생성됩니다.
편집기 오른쪽에는 스키마 속성이 있는데, 여기서 표시 이름 ​필드를 사용하여 스키마의 이름을 제공할 수 있습니다. 이름을 입력했으면 캔버스가 스키마의 새 이름을 반영하도록 업데이트됩니다.
스키마의 이름을 결정할 때 고려해야 할 몇 가지 중요한 사항이 있습니다.
  • 나중에 라이브러리에서 스키마를 쉽게 찾을 수 있도록 스키마 이름은 짧고 설명이어야 합니다.
  • 스키마 이름은 고유해야 합니다. 이는 나중에 다시 사용할 수 없도록 충분히 구체적이어야 합니다. 예를 들어, 조직에서 서로 다른 브랜드에 대한 별도의 로열티 프로그램을 보유하고 있는 경우 나중에 정의할 수 있는 다른 충성도 관련 스키마와 쉽게 구별할 수 있도록 스키마 "브랜드 a 충성도 구성원"을 지정하는 것이 좋습니다.
  • 선택적으로 설명 필드를 사용하여 스키마에 대한 추가 정보를 제공할 있습니다.
이 자습서는 충성도 프로그램의 구성원과 관련된 데이터를 인제스트하는 스키마를 구성하므로 스키마의 이름은 "충성도 구성원"입니다.

클래스 지정

편집기의 왼쪽에 컴포지션 섹션이 있습니다. 현재 두 개의 하위 섹션이 포함되어 있습니다. 스키마 클래스 .
이제 스키마에 이름이 있으므로 스키마를 구현할 클래스를 할당할 때입니다. 클래스 옆에 있는 할당을 클릭합니다 .
# 대화 상자가 나타납니다. 이 창에는 조직에서 정의한 모든 클래스(소유자가 "고객"임)와 Adobe에서 정의한 표준 클래스 등 사용 가능한 모든 클래스 목록이 표시됩니다.
클래스 이름을 클릭하여 클래스에 대한 설명을 표시합니다. 클래스 구조 미리 보기를 선택하여 클래스와 연관된 필드 및 메타데이터를 볼 수도 있습니다.
이 자습서에서는 XDM 개별 프로필 클래스를 사용합니다. 클래스 옆의 라디오 단추를 클릭하여 선택한 다음 # 을 클릭합니다**.
캔버스가 다시 나타납니다. 이제 클래스 섹션에 선택한 클래스(XDM 개별 프로필)가 포함되어 있으며 XDM 개별 프로필 클래스에 의해 기고한 필드가 구조 섹션 내에 표시됩니다.
필드가 "fieldName" 형식으로 표시됩니다. | 데이터 유형"을 참조하십시오. UI에서 스키마 필드를 정의하는 단계는 이 자습서의 후반부에서 제공됩니다.
스키마를 저장하기 전에 초기 작성 프로세스 중에 어느 시점에서나 스키마 클래스를 변경할 수 있지만, 이 작업은 매우 신중하게 수행해야 합니다. 믹스는 특정 클래스와 호환되므로 클래스를 변경하면 캔버스 및 추가한 모든 필드가 재설정됩니다.

혼합 추가

클래스가 지정되었으므로 구성 섹션에는 세 번째 하위 섹션이 포함됩니다. 믹싱 .
이제 혼합을 추가하여 스키마에 필드를 추가할 수 있습니다. 혼합이란 특정 개념을 설명하는 하나 이상의 들판으로 이루어진 그룹입니다. 이 자습서에서는 혼합을 사용하여 충성도 프로그램의 구성원을 설명하고 이름, 생일, 전화 번호, 주소 등과 같은 주요 정보를 캡처합니다.
믹스를 추가하려면 # 하위 섹션 **에서 # 클릭합니다.
# 대화 상자가 나타납니다. 혼합은 특정 클래스와 함께 사용하기 위한 것이므로 믹싱 목록은 선택한 클래스(이 경우 XDM 개별 프로필 클래스)와 호환되는 것만 표시합니다.
혼합 옆에 있는 라디오 단추를 선택하면 # 옵션이 제공됩니다 . "프로필 인물 세부 사항" 믹싱을 선택한 다음 # 를 클릭합니다**.
스키마 캔버스가 다시 나타납니다. 이제 믹싱 섹션에는 "프로필 인물 세부 사항" 믹스가 표시되고 구조 섹션에는 믹싱에 의해 기여 되는 필드가 포함됩니다.
이 혼합은 데이터 유형이 "Person"인 최상위 수준 이름 아래의 여러 필드에 기여합니다. 이 필드 그룹은 이름, 생년월일, 성별 등 개인에 대한 정보를 설명합니다.
필드는 스키마 레지스트리에서 스칼라 유형(문자열, 정수, 배열 또는 날짜 등)과 "데이터 유형"(공통 개념을 나타내는 필드 그룹)을 데이터 유형으로 사용할 수 있습니다.
"이름" 필드에는 "사람 이름"이라는 데이터 유형이 있습니다. 이것은 일반적인 개념을 설명하며 이름, 성 및 전체 이름과 같은 이름 관련 하위 필드를 포함합니다.
캔버스 내의 다른 필드를 클릭하면 스키마 구조에 기여하는 추가 필드를 볼 수 있습니다.

다른 믹신 추가

이제 동일한 단계를 반복하여 다른 믹스를 추가할 수 있습니다. 이번에 # 대화 상자를 보면 "프로필 개인 정보" 믹신이 회색으로 표시되었고 그 옆에 있는 라디오 단추를 선택할 수 없습니다. 이렇게 하면 현재 스키마에 이미 포함되어 있는 믹스를 실수로 복제할 수 없습니다.
이제 # 대화 상자에서 "프로필 개인 세부 사항" 믹스를 추가할 수* 있습니다.
캔버스가 추가되면 다시 나타납니다. "프로필 개인 세부 사항"은 이제 컴포지션 섹션의 믹싱 아래에 나열되며, ​구조아래에 집 주소, 휴대폰 등의 필드가 추가되었습니다.
"이름" 필드와 유사하게 방금 추가한 필드는 다중 필드 개념을 나타냅니다. 예를 들어 "homeAddress"에는 "Address"의 데이터 유형이 있고 "mobilePhone"에는 "Phone Number"의 데이터 유형이 있습니다. 이러한 각 필드를 클릭하여 확장하고 데이터 유형에 포함된 추가 필드를 볼 수 있습니다.

새로운 믹싱 정의

"충성도 멤버" 스키마는 충성도 프로그램 멤버와 관련된 데이터를 캡처하기 위한 것으로 특정 충성도 관련 필드가 필요합니다. 필요한 필드가 포함된 표준 믹스인(mixins)이 없으므로 새 믹스인을 정의해야 합니다.
이 때 # 대화 상자를 열 때 # 를 선택합니다**. 그러면 혼합에 대한 표시 이름 설명 을제공하라는 메시지가 표시됩니다.
클래스 이름과 마찬가지로 혼합기 이름은 짧고 단순해야 스키마에 어떤 내용이 기여할 것인지 설명합니다. 이 두 가지 모두 고유하므로 이름을 다시 사용할 수 없으므로 해당 이름이 충분한지 확인해야 합니다.
이 튜토리얼의 경우 새로운 믹스의 이름을 "충성도 세부 사항"으로 지정합니다.
스키마 편집기로 돌아가려면 믹신 추가를 클릭합니다. 이제 캔버스 왼쪽에 있는 믹싱 아래에 "충성도 세부 정보"가 표시되어야 하지만 아직 여기에 연관된 필드가 없으므로 구조 ​아래에 새 필드가 나타나지 않습니다.

믹스에 필드 추가

이제 "충성도 세부 사항" 조합을 만들었으므로, 혼합이 스키마에 기여할 필드를 정의할 때입니다.
시작하려면 # 섹션에서 믹신 이름을 클릭합니다. 이렇게 하면 # 이 편집기의 오른쪽에 나타나고 # 아래의 스키마 이름 옆에 # 단추가*​나타납니다.
" 충성도 멤버" 옆의 필드 추가를 클릭하여 구조에서 새 노드를 만듭니다. 이 노드(이 예에서 "_tenantId"라고 함)는 IMS 조직의 테넌트 ID 앞에 밑줄이 있는 것을 나타냅니다. 테넌트 ID가 존재하면 추가할 필드가 조직의 네임스페이스에 포함되어 있음을 나타냅니다.
즉, 추가하려는 필드는 조직에 고유하며 IMS 조직에서만 액세스할 수 있는 특정 영역의 스키마 레지스트리에 저장됩니다. 정의한 필드는 항상 네임스페이스에 추가되어야 다른 표준 클래스, 혼합, 데이터 형식 및 필드의 이름과 충돌하지 않습니다.
해당 네임스페이스 노드 안은 "새 필드"입니다. 이것은 "충성도 세부 사항" 혼합의 시작이다.
편집기의 오른쪽에 필드 속성을 사용하여 충성도 관련 필드를 유지하는 데 사용할 "개체" 유형의 "충성도" 필드를 만드는 것으로 시작합니다. 완료되면 적용을 클릭합니다 .
변경 사항이 적용되고 새로 만든 "충성도" 개체가 나타납니다. 개체 옆에 있는 필드 추가를 클릭하여 충성도 관련 필드를 추가합니다. "새 필드"가 나타나고 필드 속성 섹션이 캔버스 오른쪽에 표시됩니다.
각 필드에는 다음 정보가 필요합니다.
  • 필드 이름: 낙타라고 적힌 들판 이름. 예: 충성도 수준
  • 표시 이름: 제목 케이스에 기록된 필드의 이름입니다. 예: 충성도 수준
  • 유형: 필드의 데이터 유형입니다. 여기에는 기본 스칼라 형식과 스키마 레지스트리에 정의된 모든 데이터 유형이 포함됩니다. 예: 문자열, 정수, 부울, 사람, 주소, 전화 번호 등
  • 설명: 문장의 경우 필드에 대한 선택적 설명을 포함해야 합니다. (최대 200자)
충성도 개체의 첫 번째 필드는 "loyaltyId"라는 문자열이 됩니다. 새 필드의 유형을 "문자열"으로 설정하면 필드 속성 창에 기본값 , 형식 ​및 최대 길이 를 비롯한 여러 가지 제약 조건 적용 옵션이 ​채워집니다.
선택한 데이터 유형에 따라 다른 제한 옵션을 사용할 수 있습니다. "loyaltyId"는 이메일 주소이므로 형식 드롭다운 메뉴에서 "email"을 선택합니다. 적용을 선택하여 변경 사항을 적용합니다.

혼합할 필드 추가

이제 "loyaltyId" 필드를 추가했으므로 추가 필드를 추가하여 다음과 같은 충성도 관련 정보를 수집할 수 있습니다.
  • 포인트(정수)
  • 멤버 유효 기간(날짜)
충성도 개체에서 필드 추가를 클릭하고 필요한 정보를 입력하여 각 필드가 추가됩니다.
완료되면 충성도 오브젝트에 다음과 같은 필드가 포함됩니다. 충성도 ID, 포인트 및 이후의 멤버.

혼합에 'enum' 필드 추가

스키마 편집기에서 필드를 정의할 때 필드에 포함할 수 있는 데이터에 대한 추가 제한을 제공하기 위해 기본 필드 유형에 적용할 수 있는 몇 가지 추가 옵션이 있습니다.
예를 들어 "충성도 수준" 필드가 될 수 있습니다. 여기서 값은 네 가지 옵션 중 하나만 사용할 수 있습니다. 이 필드를 스키마에 추가하려면 "충성도" 개체 옆에 있는 필드 추가를 클릭하고 필드 속성 아래에 필요한 필드를 ​채웁니다.
유형 ​의 경우 "문자열"을 선택하면 Array , Enum ​및 IdentityCompetitan에 대한 추가 확인란이 나타납니다 .
열거형 확인란을 선택하여 아래의 열거형 값 섹션을 엽니다. 여기에서 허용 가능한 각 충성도 수준에 대해 (camelCase) 및 레이블 (제목 케이스의 경우 독자가 친근한 이름 선택 사항)을 입력할 수 있습니다.
모든 필드 속성을 완료하면 적용을 클릭하면 "loyaltyLevel" 필드가 "loyalty" 개체에 추가됩니다.
사용 가능한 추가 제한에 대한 자세한 내용:
  • 필수: 데이터 수집에 필드가 필수임을 나타냅니다. 이 필드를 포함하지 않는 이 스키마를 기반으로 데이터 세트에 업로드한 데이터는 수집 시 실패합니다.
  • 배열: 필드에 데이터 유형이 지정된 값 배열을 포함함을 나타냅니다. 예를 들어 "문자열"의 데이터 유형을 선택하고 "배열" 확인란을 선택하면 필드에 문자열 배열이 포함됩니다.
  • 열거형: 이 필드에 가능한 값의 열거형 목록의 값 중 하나가 포함되어야 함을 나타냅니다.
  • ID: 이 필드가 ID 필드임을 나타냅니다. ID 필드에 대한 자세한 내용은 이 자습서 후반부에서 제공됩니다 .

다중 필드 개체를 데이터 형식으로 변환

몇 개의 충성도별 필드를 추가한 후 "충성도" 개체에는 다른 스키마에서 유용할 수 있는 일반적인 데이터 구조가 포함됩니다.
다중 필드 구조가 다시 사용될 수 있고 다른 곳에서 동일한 데이터 구조를 사용할 수 있는 유연성을 갖추고자 할 때 스키마 편집기를 사용하면 해당 구조를 데이터 유형으로 변환할 수 있습니다.
데이터 유형을 사용하면 여러 필드 구조를 일관되게 사용할 수 있으며 스키마 내의 어느 곳에서나 사용할 수 있으므로 혼합보다 더 유연하게 사용할 수 있습니다. 이렇게 하려면 믹싱의 필드 유형 을 레지스트리에 정의된 데이터 유형의 필드에 설정합니다.
"충성도" 개체를 데이터 유형으로 변환하려면 구조 아래의 "충성도" 필드 클릭하고 편집기 오른쪽의 # 에서 # 을 선택합니다. "데이터 유형으로 변환된 개체"를 확인하는 작은 녹색 팝업이 나타납니다.
이제 구조 ​아래에서 보면, "충성도" 필드에 "충성도"의 데이터 유형이 있고 필드 옆에 필드가 작은 잠금 아이콘이 있어서 더 이상 개별 필드가 아니라 다중 필드 구조의 일부임을 알 수 있습니다.
향후 스키마에서, 이제 "충성도"의 유형 필드를 할당할 수 있으며 자동으로 충성도 수준, 포인트, 이후의 멤버 및 충성도 ID 필드를 포함할 수 있습니다.

스키마 필드를 ID 필드로 설정

스키마는 데이터를 Experience Platform으로 인제스트하는 데 사용되며, 이 데이터는 궁극적으로 개인을 식별하고 여러 소스에서 나오는 정보를 통합하는 데 사용됩니다. 이 프로세스에 도움이 되도록 키 필드를 "ID" 필드로 표시할 수 있습니다.
Experience Platform을 사용하면 스키마 편집기에서 ID 확인란을 사용하여 ID 필드를 쉽게 나타낼 수 있습니다.
예를 들어 동일한 "수준"에 속하는 로열티 프로그램의 회원 수가 수천 명에 달할 수 있지만, 로열티 프로그램의 각 멤버에는 고유한 "loyaltyId"가 있습니다(이 경우 개별 멤버의 이메일 주소). "loyaltyId"가 각 구성원의 고유 식별자이므로 ID 필드에 적합한 후보가 되는 반면 "level"은 아닙니다.
편집기의 구조 섹션에서 만든 "loyaltyId" 필드를 클릭하면 필드 속성 아래에 ID ​확인란이표시됩니다. 확인란을 선택하면 기본 ID로 설정할 수 있는 옵션이 표시됩니다 . 그 상자도 확인해 보세요.
다음으로 ID 네임스페이스를 제공해야 합니다 . 미리 정의된 네임스페이스가 여러 개 있지만 "loyaltyId"가 구성원의 이메일 주소이므로 드롭다운 목록에서 "이메일"을 선택합니다. 이제 적용을 클릭하여 "loymentId" 필드의 업데이트를 확인할 수 있습니다.
이제 "loyaltyId" 필드로 인제스트된 모든 데이터는 해당 개인을 식별하고 해당 고객의 단일 뷰를 연결하는 데 사용됩니다.
스키마 필드가 기본 ID로 설정되면 나중에 스키마의 다른 필드를 기본 필드로 설정하려고 하면 오류 메시지가 표시됩니다. 각 스키마에는 기본 ID 필드가 하나만 포함될 수 있습니다.
ID 작업에 대한 자세한 내용은 ID 서비스 설명서를 참조하십시오.

실시간 고객 프로필에서 사용할 스키마 활성화

스키마 편집기에서는 실시간 고객 프로파일에서 사용할 스키마를 활성화할 수 있는 기능을 제공합니다 . 프로파일은 고객 속성에 대한 360° 프로파일 및 Experience Platform과 통합된 모든 시스템에서 고객이 보유한 모든 인터랙션에 대한 타임스탬프가 있는 계정을 구축하여 각 개별 고객의 전체 상황을 파악할 수 있도록 합니다.
실시간 고객 프로파일에서 사용할 수 있도록 스키마를 활성화하려면 기본 ID가 정의되어 있어야 합니다. 주 ID를 먼저 정의하지 않고 스키마를 활성화하려고 하면 "기본 ID 누락" 오류 메시지가 표시됩니다.
프로필에 사용할 "충성도 멤버" 스키마를 활성화하려면 먼저 편집기의 구조 섹션에서 "충성도 구성원"을 클릭합니다.
편집기 오른쪽의 스키마 속성 에서 ​표시 이름, 설명 및 유형을 포함한 스키마에 대한 정보가 표시됩니다. 이 정보 외에 프로필 표시/숨기기 단추도 있습니다 .
# 을 클릭하면 # 에 대한 스키마를 활성화할지 여부를 묻는 팝업 창이 나타납니다.
실시간 고객 프로파일에 대한 스키마가 활성화되고 저장되면 비활성화할 수 없습니다.

다음 단계

이제 "충성도 멤버" 스키마 작성을 마쳤으므로 편집기의 구조 섹션에서 전체 스키마를 볼 수 있습니다. 저장 클릭하면 스키마가 스키마 라이브러리에 저장되고 스키마 레지스트리에서 액세스할 수 있습니다.
이제 새 스키마를 사용하여 데이터를 Platform으로 인제스트할 수 있습니다. 스키마를 사용하여 데이터를 인제스트하면 추가 변경만 가능합니다. 스키마 버전 관리에 대한 자세한 내용은 스키마 구성의 기본 사항을 참조하십시오.
스키마 레지스트리 API를 사용하여 "충성도 멤버" 스키마를 보고 관리할 수도 있습니다. API로 작업을 시작하려면 먼저 스키마 레지스트리 API 개발자 안내서를 읽어 봅니다 .

부록

다음 정보는 스키마 편집기 자습서에 보충 사항입니다.

Create a new class

Experience Platform은 조직에 고유한 클래스를 기반으로 스키마를 정의할 수 있는 유연성을 제공합니다.
스키마 편집기의 클래스 섹션 에서 할당을 클릭하여 클래스 할당 대화상자를 엽니다. 대화 상자에서 새 클래스 만들기를 선택합니다 .
그런 다음 새 클래스에 표시 이름 (클래스에 대한 짧고 설명적이며 고유하며 사용자 친화적인 이름), 설명 및 스키마 ​가 정의하는 데이터에 대한 동작 ("레코드" 또는 "시간 시리즈")을 지정할 수 있습니다.
조직에서 정의한 클래스를 구현하는 스키마를 빌드할 때는 mixins를 호환되는 클래스에서만 사용할 수 있다는 점을 참고하십시오. 정의한 클래스는 새로 만들어지므로 # 대화 상자에 호환되는 믹스가* 없습니다. 대신 # 를 선택하고 해당** 클래스에 사용할 믹신을 정의해야 합니다. 다음에 새 클래스를 구현하는 스키마를 작성할 때 정의한 혼합이 나열되고 사용할 수 있습니다.

스키마 클래스 변경

초기 스키마 작성 프로세스 중에 언제든지 스키마를 저장하기 전에 스키마를 기반으로 하는 클래스를 변경할 수 있습니다.
수업을 변경하기 전에 주의하세요. 믹스는 특정 클래스와 호환되므로 클래스를 변경하면 캔버스가 재설정되고 해당 점에 추가한 모든 필드가 제거됩니다.
클래스를 변경하려면 편집기의 컴포지션 섹션에서 ** 클래스 옆에 있는 할당을클릭합니다.
클래스 할당 대화 상자가 열리면 사용 가능한 목록에서 새 클래스를 선택할 수 있습니다. 클래스 할당을 클릭하면 새 클래스를 할당할지 여부를 확인하는 새 대화 상자가 열립니다.
클래스 변경을 확인하면 캔버스가 재설정되고 모든 컴포지션 진행 상태가 손실됩니다.