Schema Editor을(를) 사용하여 스키마 만들기

Adobe Experience Platform 사용자 인터페이스를 사용하면 Schema Editor이라는 인터랙티브한 시각적 캔버스에서 Experience Data Model (XDM) 스키마를 만들고 관리할 수 있습니다. 이 자습서에서는 Schema Editor을(를) 사용하여 스키마를 만드는 방법을 다룹니다.

데모 목적으로 이 자습서의 단계에는 고객 충성도 프로그램의 구성원을 설명하는 예제 스키마 생성이 포함됩니다. 이러한 단계를 사용하여 고유한 목적에 맞는 다른 스키마를 만들 수 있지만 먼저 예제 스키마를 만드는 과정을 따라 Schema Editor의 기능을 학습하는 것이 좋습니다.

시작하기

이 자습서에서는 스키마 만들기와 관련된 Adobe Experience Platform의 다양한 측면에 대한 작업 이해가 필요합니다. 이 자습서를 시작하기 전에 다음 개념에 대한 설명서를 검토하십시오.

스키마 작업 영역 열기 browse

Platform UI의 스키마 작업 영역은 Schema Library의 시각화를 제공하므로 조직에서 사용할 수 있는 스키마 관리를 볼 수 있습니다. 작업 영역에는 이 자습서 전체에서 스키마를 구성할 수 있는 캔버스인 Schema Editor도 포함됩니다.

Experience Platform에 로그인한 후 왼쪽 탐색에서 스키마 ​를 선택하여 스키마 작업 영역을 엽니다. 찾아보기 탭에는 사용자가 보고 사용자 지정할 스키마 목록(Schema Library 표시)이 표시됩니다. 이 목록에는 스키마의 기반이 되는 이름, 유형, 클래스 및 동작(레코드 또는 시계열)과 스키마가 마지막으로 수정된 날짜 및 시간이 포함됩니다.

자세한 내용은 UI에서 기존 XDM 리소스 탐색에 대한 안내서를 참조하십시오.

스키마 만들기 및 이름 지정 create

스키마 작성을 시작하려면 스키마 작업 영역의 오른쪽 상단 모서리에서 스키마 만들기 ​를 선택하십시오.

스키마 만들기 워크플로가 나타납니다. 그런 다음 스키마의 기본 클래스를 선택합니다. XDM 개인 프로필 및 XDM ExperienceEvent의 핵심 클래스 또는 기타 클래스가 목적에 맞지 않으면 선택할 수 있습니다. 기타 클래스 옵션을 사용하면 새 클래스를 만들거나 기존 다른 클래스에서 선택할 수 있습니다.

이러한 클래스에 대한 자세한 내용은 XDM 개별 프로필 및 XDM ExperienceEvent 설명서를 참조하십시오. 이 자습서에서는 XDM 개별 프로필, 다음 ​을 선택하십시오.

![XDM 개별 프로필 ] 옵션 및 다음이 강조 표시된 스키마 만들기 워크플로우입니다.(https://experienceleague.adobe.com/images/tutorials/create-schema/individual-profile-base-class.png?lang=ko)

클래스를 선택하면 이름 및 검토 섹션이 나타납니다. 이 섹션에서는 스키마를 식별하기 위한 이름과 설명을 제공합니다. 스키마의 이름을 결정할 때 고려해야 할 몇 가지 중요한 사항이 있습니다.

이 자습서에서는 충성도 프로그램의 구성원과 관련된 데이터를 수집하기 위한 스키마를 구성하므로 스키마 이름이 "Loyalty Members"입니다.

​ 선택한 클래스와 스키마 구조를 검토하고 확인할 수 있도록 스키마의 기본 구조(클래스에서 제공)가 캔버스에 표시됩니다.

텍스트 필드에 사용자에게 친숙한 스키마 표시 이름을(를) 입력하십시오. 그런 다음 스키마를 식별하는 데 도움이 되는 적절한 설명을 입력합니다. 스키마 구조를 검토하고 설정이 마음에 들면 완료 ​를 선택하여 스키마를 만듭니다.

스키마 표시 이름, 설명 및 마침이 강조 표시된 스키마 만들기 워크플로의 이름 및 검토 섹션.

Schema Editor이(가) 나타납니다. 스키마를 구성할 캔버스입니다. 편집기에 도착하면 캔버스의 구조 섹션에 선택한 기본 클래스에 포함된 표준 필드와 함께 자체 제목이 지정된 스키마가 자동으로 만들어집니다. 스키마에 할당된 클래스는 컴포지션 섹션의 클래스 아래에 나열됩니다.

필드 그룹 추가 field-group

이제 필드 그룹을 추가하여 스키마에 필드를 추가할 수 있습니다. 필드 그룹은 특정 개념을 설명하는 데 종종 함께 사용되는 하나 이상의 필드 그룹입니다. 이 자습서에서는 필드 그룹을 사용하여 충성도 프로그램의 구성원을 설명하고 이름, 생일, 전화 번호, 주소 등의 주요 정보를 캡처합니다.

필드 그룹을 추가하려면 필드 그룹 하위 섹션에서 추가 ​를 선택하십시오.

사용 가능한 필드 그룹 목록을 표시하는 새 대화 상자가 나타납니다. 각 필드 그룹은 특정 클래스에서만 사용할 수 있으므로 대화 상자에는 선택한 클래스(이 경우 XDM Individual Profile 클래스)와 호환되는 필드 그룹만 나열됩니다. 표준 XDM 클래스를 사용하는 경우 필드 그룹 목록은 사용 빈도에 따라 지능적으로 정렬됩니다.

왼쪽 레일에서 필터 중 하나를 선택하여 표준 필드 그룹 목록을 소매, 금융 서비스, 의료 등의 특정 산업(으)로 좁힐 수 있습니다.

목록에서 필드 그룹을 선택하면 오른쪽 레일에 표시됩니다. 원할 경우 여러 필드 그룹을 선택하고 확인하기에 앞서 각 필드 그룹을 오른쪽 레일의 목록에 추가할 수 있습니다. 또한 현재 선택한 필드 그룹의 오른쪽에 아이콘이 표시되어 제공되는 필드의 구조를 미리 볼 수 있습니다.

필드 그룹을 미리 볼 때 필드 그룹의 스키마에 대한 자세한 설명이 오른쪽 레일에 제공됩니다. 제공된 캔버스에서 필드 그룹의 필드를 탐색할 수도 있습니다. 다른 필드를 선택하면 오른쪽 레일이 업데이트되어 해당 필드에 대한 세부 정보가 표시됩니다. 미리 보기를 마치면 뒤로 ​를 선택하여 필드 그룹 선택 대화 상자로 돌아갑니다.

이 자습서에서는 인구 통계학적 세부 정보 필드 그룹을 선택한 다음 필드 그룹 추가 ​를 선택하십시오.

스키마 캔버스가 다시 나타납니다. 이제 필드 그룹 섹션에 "인구 통계학적 세부 정보"이(가) 나열되고 구조 섹션에는 필드 그룹에서 제공한 필드가 포함됩니다. 필드 그룹 섹션 아래에서 필드 그룹의 이름을 선택하여 캔버스 내에서 제공하는 특정 필드를 강조 표시할 수 있습니다.

이 필드 그룹은 데이터 형식이 "사람"인 최상위 이름 person 아래에 여러 필드를 기여합니다. 이 필드 그룹은 이름, 생년월일 및 성별을 포함하여 개인에 대한 정보를 설명합니다.

name 필드의 데이터 형식은 "전체 이름"입니다. 이는 일반적인 개념을 설명하고 이름, 성, 호칭 및 접미사와 같은 이름 관련 하위 필드를 포함함을 의미합니다.

캔버스 내에서 다른 필드를 선택하여 스키마 구조에 기여하는 추가 필드를 표시합니다.

더 많은 필드 그룹 추가 field-group-2

이제 동일한 단계를 반복하여 다른 필드 그룹을 추가할 수 있습니다. 이번에 필드 그룹 추가 대화 상자를 볼 때 "인구 통계 세부 정보" 필드 그룹이 회색으로 표시되고 그 옆의 확인란을 선택할 수 없습니다. 이렇게 하면 이미 현재 스키마에 포함된 필드 그룹을 실수로 복제할 수 없습니다.

이 자습서의 경우 목록에서 표준 필드 그룹 개인 연락처 세부 정보 및 충성도 세부 정보 ​를 선택한 다음 필드 그룹 추가 ​를 선택하여 스키마에 추가하십시오.

![필드 그룹 추가] 대화 상자(두 개의 새 필드 그룹이 선택됨)와 필드 그룹 추가 강조 표시됨(https://experienceleague.adobe.com/images/tutorials/create-schema/more-field-groups.png?lang=ko)

캔버스는 컴포지션 섹션의 필드 그룹 아래에 추가된 필드 그룹과 해당 합성 필드가 스키마 구조에 추가된 상태로 다시 나타납니다.

사용자 정의 필드 그룹 정의 define-field-group

충성도 멤버 스키마는 충성도 프로그램의 멤버와 관련된 데이터를 캡처하기 위한 것이며, 스키마에 추가한 표준 충성도 세부 정보 필드 그룹은 프로그램 유형, 포인트, 가입 날짜 등을 포함하여 이러한 항목 대부분을 제공합니다.

그러나 사용 사례를 달성하기 위해 표준 필드 그룹에서 다루지 않는 추가 사용자 정의 필드를 포함하려는 시나리오가 있을 수 있습니다. 사용자 정의 충성도 필드를 추가하는 경우 두 가지 옵션이 있습니다.

새 필드 그룹을 만들려면 이전과 같이 필드 그룹 하위 섹션에서 추가 ​를 선택하지만, 이번에는 표시되는 대화 상자 상단 근처에 있는 새 필드 그룹 만들기 ​를 선택합니다. 그런 다음 새 필드 그룹의 표시 이름과 설명을 입력하라는 메시지가 표시됩니다. 이 자습서에서는 새 필드 그룹 이름을 "Custom Loyalty Details"으로 지정한 다음 필드 그룹 추가 ​를 선택하십시오.

![필드 그룹 추가] 대화 상자에 새 필드 그룹 만들기, 표시 이름 및 설명이 강조 표시되었습니다.(https://experienceleague.adobe.com/images/tutorials/create-schema/create-new-field-group.png?lang=ko)

이제 캔버스의 왼쪽에 있는 필드 그룹 아래에 "Custom Loyalty Details"이(가) 표시되어야 하지만 아직 연결된 필드가 없으므로 구조 ​에 새 필드가 표시되지 않습니다.

필드 그룹에 필드 추가 field-group-fields

이제 "Custom Loyalty Details" 필드 그룹을 만들었으므로 필드 그룹이 스키마에 기여할 필드를 정의할 차례입니다.

시작하려면 캔버스에서 스키마 이름 옆에 있는 더하기(+) 아이콘을 선택합니다.

"제목 없는 필드" 자리 표시자가 캔버스에 나타나고 오른쪽 레일이 업데이트되어 필드에 대한 구성 옵션이 표시됩니다.

이 시나리오에서는 스키마에 개인의 현재 충성도 계층을 자세히 설명하는 오브젝트 유형 필드가 있어야 합니다. 오른쪽 레일의 컨트롤을 사용하여 관련 필드를 보관하는 데 사용할 "Object" 형식의 loyaltyTier 필드를 만듭니다.

할당 대상 ​에서 필드를 할당할 필드 그룹을 선택해야 합니다. 모든 스키마 필드는 클래스 또는 필드 그룹에 속하며 이 스키마는 표준 클래스를 사용하므로 필드 그룹을 선택하는 것이 유일한 옵션입니다. "Custom Loyalty Details" 이름을 입력한 다음 목록에서 필드 그룹을 선택합니다.

완료되면 적용 ​을 선택합니다.

변경 내용이 적용되며 새로 만든 loyaltyTier 개체가 나타납니다. 이 필드는 사용자 지정 필드이므로 조직의 테넌트 ID로 이름이 지정된 개체 내에 자동으로 중첩되며 앞에 밑줄(_tenantId)이 표시됩니다.

하위 필드 추가를 시작하려면 loyaltyTier 개체 옆에 있는 더하기(+) 아이콘을 선택하십시오. 새 필드 자리 표시자가 나타나고 필드 속성 섹션이 캔버스의 오른쪽에 표시됩니다.

각 필드에는 다음 정보가 필요합니다.

loyaltyTier 개체의 첫 번째 필드는 충성도 멤버의 현재 계층의 ID를 나타내는 id(이)라는 문자열입니다. 이 회사는 서로 다른 요인에 따라 각 고객에 대해 서로 다른 충성도 계층 포인트 임계값을 설정하므로 계층 ID는 각 충성도 멤버에 대해 고유합니다. 새 필드의 형식을 "문자열"(으)로 설정하면 필드 속성 섹션이 기본값, 형식 및 최대 길이 등 제약 조건을 적용할 수 있는 여러 옵션으로 채워집니다. 자세한 내용은 데이터 유효성 검사 필드 모범 사례에 대한 설명서를 참조하세요.

id은(는) 임의로 생성된 자유 형식 문자열이므로 추가 제약 조건이 필요하지 않습니다. 변경 내용을 적용하려면 적용 ​을 선택하세요.

필드 그룹에 더 많은 필드 추가 field-group-fields-2

id 필드를 추가했으므로 이제 다음과 같은 충성도 계층 정보를 캡처하는 추가 필드를 추가할 수 있습니다.

스키마에 각 필드를 추가하려면 loyalty 개체 옆의 더하기(+) 아이콘을 선택하고 필요한 정보를 입력하십시오.

완료되면 loyaltyTier 개체에는 id, currentThreshold, nextThreshold 및 effectiveDate에 대한 필드가 포함됩니다.

필드 그룹에 열거형 필드 추가 enum

Schema Editor에서 필드를 정의할 때 필드에 포함될 수 있는 데이터에 대한 추가 제한을 제공하기 위해 기본 필드 형식에 적용할 수 있는 몇 가지 추가 옵션이 있습니다. 다음 표에서는 이러한 제한 사항의 사용 사례에 대해 설명합니다.

이 자습서에서 스키마의 loyaltyTier 개체에는 계층 클래스를 설명하는 새 열거형 필드가 필요합니다. 여기서 값은 네 가지 옵션 중 하나일 수 있습니다. 이 필드를 스키마에 추가하려면 loyaltyTier 개체 옆의 더하기(+) 아이콘을 선택하고 필드 이름 및 표시 이름 ​에 대한 필수 필드를 입력하십시오. Type ​에 대해 "String"을(를) 선택하십시오.

해당 유형을 선택한 후 필드에 대한 추가 확인란이 나타납니다. 여기에는 배열, 열거형 및 제안 값, ID 및 관계 ​에 대한 확인란이 포함됩니다.

열거형 및 제안 값 확인란을 선택한 다음 열거형 ​을 선택합니다. 허용되는 각 충성도 계층 클래스에 대해 값(camelCase의 경우)과 표시 이름(Title Case의 경우 읽기 쉬운 선택적 이름)을 입력할 수 있습니다.

모든 필드 속성이 완료되면 적용 ​을 선택하여 loyaltyTier 개체에 tierClass 필드를 추가합니다.

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

이제 loyaltyTier 개체에 여러 필드가 있으며 다른 스키마에서 유용할 수 있는 일반적인 데이터 구조를 나타냅니다. Schema Editor을(를) 사용하면 재사용 가능한 다중 필드 개체의 구조를 데이터 형식으로 변환하여 쉽게 적용할 수 있습니다.

데이터 유형을 사용하면 다중 필드 구조를 일관되게 사용할 수 있으며, 스키마 내의 모든 위치에서 사용할 수 있으므로 필드 그룹보다 더 유연합니다. 이 작업은 필드의 Type 값을 Schema Registry에 정의된 데이터 형식의 값으로 설정하여 수행됩니다.

loyaltyTier 개체를 데이터 형식으로 변환하려면 캔버스에서 loyaltyTier 필드를 선택한 다음 필드 속성 아래 편집기 오른쪽에서 새 데이터 형식으로 변환 ​을 선택합니다.

객체가 성공적으로 전환되었음을 확인하는 알림이 표시됩니다. 이제 캔버스에서 loyaltyTier 필드에 링크 아이콘이 있음을 확인할 수 있으며 오른쪽 레일은 데이터 형식이 "Loyalty Tier"임을 나타냅니다.

향후 스키마에서 필드를 "Loyalty Tier" 유형으로 할당할 수 있으며 ID, 계층 클래스, 포인트 임계값 및 유효 날짜에 대한 필드가 자동으로 포함됩니다.

스키마 필드 검색 및 필터링

이제 스키마에는 기본 클래스에서 제공한 필드 외에도 여러 필드 그룹이 포함됩니다. 더 큰 스키마로 작업할 때 왼쪽 레일에서 필드 그룹 이름 옆에 있는 확인란을 선택하여 표시된 필드를 관심 있는 필드 그룹에서 제공한 필드로만 필터링할 수 있습니다.

스키마에서 특정 필드를 찾는 경우 검색 창을 사용하면 제공된 필드 그룹에 관계없이 표시된 필드를 이름별로 필터링할 수도 있습니다.

스키마 필드를 ID 필드로 설정 identity-field

스키마가 제공하는 표준 데이터 구조를 활용하여 여러 소스에서 동일한 개인에 속하는 데이터를 식별할 수 있으며, 세그멘테이션, 보고, 데이터 과학 분석 등과 같은 다양한 다운스트림 사용 사례를 허용할 수 있습니다. 개별 ID를 기반으로 데이터를 연결하려면 키 필드를 적용 가능한 스키마 내에서 ID 필드로 표시해야 합니다.

Experience Platform을(를) 사용하면 Schema Editor에서 ID 확인란을 사용하여 ID 필드를 쉽게 표시할 수 있습니다. 그러나 데이터의 특성에 따라 ID로 사용할 가장 적합한 필드를 결정해야 합니다.

예를 들어, 동일한 충성도 수준에 속하는 수천 명의 충성도 프로그램 구성원과 동일한 실제 주소를 공유하는 여러 명의 충성도 프로그램 구성원이 있을 수 있습니다. 그러나 이 시나리오에서는 등록 시 고객 충성도 프로그램의 각 구성원이 자신의 개인 이메일 주소를 제공합니다. 개인 전자 메일 주소는 일반적으로 한 사람이 관리하므로 personalEmail.address 필드(개인 연락처 정보 필드 그룹에서 제공)는 ID 필드에 적합한 후보입니다.

캔버스에서 personalEmail.address 필드를 선택하면 ID 확인란이 필드 속성 아래에 나타납니다. 확인란을 선택하고 이 항목을 기본 ID(으)로 설정하는 옵션을 선택합니다. 이 상자도 선택하십시오.

그런 다음 드롭다운의 미리 정의된 네임스페이스 목록에서 ID 네임스페이스 ​를 제공해야 합니다. 이 필드는 고객의 이메일 주소이므로 드롭다운에서 "이메일"을(를) 선택합니다. 적용 ​을 선택하여 personalEmail.address 필드에 대한 업데이트를 확인합니다.

변경 내용을 적용한 후 personalEmail.address의 아이콘에 지문 기호가 표시되어 현재 ID 필드임을 나타냅니다. 필드는 왼쪽 레일의 ID ​에도 나열됩니다.

이제 personalEmail.address 필드에 수집된 모든 데이터는 해당 개인을 식별하고 해당 고객에 대한 단일 보기를 결합하는 데 사용됩니다. Experience Platform에서 ID를 사용하여 작업하는 방법에 대해 자세히 알아보려면 Identity Service 설명서를 검토하십시오.

Real-Time Customer Profile에서 사용할 스키마 활성화 profile

Real-Time Customer Profile은(는) Experience Platform의 id 데이터를 활용하여 각 개별 고객에 대한 거시적인 보기를 제공합니다. 이 서비스는 Experience Platform과(와) 통합된 모든 시스템에서 고객이 보유한 모든 상호 작용에 대한 타임스탬프가 지정된 계정뿐만 아니라 고객 특성에 대한 강력한 360° 프로필을 빌드합니다.

Real-Time Customer Profile에서 사용할 수 있도록 스키마를 활성화하려면 기본 ID가 정의되어 있어야 합니다. 기본 ID를 먼저 정의하지 않고 스키마를 활성화하려고 하면 오류 메시지가 표시됩니다.

Profile에서 사용할 "충성도 멤버" 스키마를 활성화하려면 캔버스에서 스키마 제목을 선택하여 시작합니다.

편집기의 오른쪽에는 표시 이름, 설명 및 유형을 포함한 스키마에 대한 정보가 표시됩니다. 이 정보 외에 프로필 전환 단추가 있습니다.

프로필 ​을 선택하면 Profile에 대한 스키마를 사용할지 확인하는 팝오버가 나타납니다.

선택을 확인하려면 사용 ​을 선택하세요. 원하는 경우 프로필 전환을 다시 선택하여 스키마를 비활성화할 수 있지만, Profile을(를) 사용하는 동안 스키마를 저장한 후에는 더 이상 비활성화할 수 없습니다.

기타 액션 more

스키마 편집기 내에서 빠른 작업을 수행하여 스키마의 JSON 구조를 복사하거나 스키마를 삭제할 수도 있습니다. 빠른 작업으로 드롭다운을 표시하려면 보기 맨 위에서 자세히를 선택하십시오.

스키마 삭제 delete-a-schema

추가 작업을 사용하여 스키마 편집기의 UI 내에서 스키마를 삭제할 수 있으며 찾아보기 탭의 스키마 세부 정보에서 스키마를 삭제할 수도 있습니다. 스키마가 삭제되지 않도록 하는 특정 조건이 있습니다. 다음과 같은 경우에는 스키마를 삭제할 수 없습니다.

JSON 구조 복사 copy-json-structure

스키마 라이브러리의 모든 스키마에 대한 내보내기 페이로드를 생성하려면 JSON 구조 복사 ​를 선택하십시오. 이 작업은 JSON 구조를 클립보드에 복사합니다. 그런 다음 내보낸 JSON을 사용하여 스키마 및 관련 리소스를 다른 샌드박스 또는 조직으로 가져올 수 있습니다. 이를 통해 서로 다른 환경 간에 스키마를 간단하고 효율적인 방식으로 공유하고 재사용할 수 있습니다.

다음 단계 및 추가 리소스

스키마 작성을 완료했으므로 이제 캔버스에서 전체 스키마를 볼 수 있습니다. 저장 ​을 선택하면 Schema Registry에서 액세스할 수 있도록 스키마가 Schema Library에 저장됩니다.

이제 새 스키마를 사용하여 데이터를 Platform (으)로 수집할 수 있습니다. 스키마를 사용하여 데이터를 수집한 후에는 추가 변경만 수행할 수 있습니다. 스키마 버전 관리에 대한 자세한 내용은 스키마 컴포지션의 기본 사항을 참조하십시오.

이제 UI에서 스키마 관계 정의에 대한 자습서에 따라 "충성도 멤버" 스키마에 새 관계 필드를 추가할 수 있습니다.

Schema Registry API를 사용하여 "충성도 멤버" 스키마를 보고 관리할 수도 있습니다. API 작업을 시작하려면 Schema Registry API 개발자 안내서를 읽는 것부터 시작하십시오.

비디오 리소스

다음 비디오는 Platform UI에서 간단한 스키마를 만드는 방법을 보여 줍니다.

다음 비디오는 현장 그룹 및 수업에 대한 이해를 강화하기 위한 것입니다.

부록

다음 단원에서는 Schema Editor 사용에 대한 추가 정보를 제공합니다.

새 클래스 만들기 create-new-class

Experience Platform은(는) 조직에 고유한 클래스를 기반으로 스키마를 정의할 수 있는 유연성을 제공합니다. 새 클래스를 만드는 방법에 대해 알아보려면 UI에서 클래스 만들기 및 편집에 대한 안내서를 참조하십시오.

스키마 클래스 변경 change-class

스키마가 저장되기 전에 초기 작성 프로세스 동안 언제든지 스키마 클래스를 변경할 수 있습니다.

스키마 클래스를 변경하는 방법에 대해 알아보려면 UI에서 스키마 관리에 대한 안내서를 참조하십시오.