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

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

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

시작

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

Schemas 작업 영역 열기 browse

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

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

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

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

스키마 작성을 시작하려면 Create schema 작업 영역의 오른쪽 상단 모서리에서 Schemas​을(를) 선택합니다.

Create a schema 대화 상자가 나타납니다. 이 대화 상자에서 필드와 필드 그룹을 추가하여 스키마를 수동으로 만들도록 선택하거나 CSV 파일을 업로드하고 ML 알고리즘을 사용하여 스키마를 생성할 수 있습니다. 대화 상자에서 스키마 생성 워크플로우를 선택합니다.

[Beta]{class="badge informative"} 수동 또는 ML 지원 스키마 만들기 manual-or-assisted

ML 알고리즘을 사용하여 업로드된 파일을 기반으로 스키마 구조를 추천하는 방법은 머신 러닝 지원 스키마 만들기 안내서를 참조하십시오. 이 UI 안내서는 수동 만들기 워크플로에 중점을 둡니다.

기본 클래스 선택 choose-a-class

Create schema 워크플로가 나타납니다. 그런 다음 스키마의 기본 클래스를 선택합니다. XDM Individual Profile과(와) XDM ExperienceEvent의 핵심 클래스 또는 Other이(가) 목적에 맞지 않으면 선택할 수 있습니다. Other 클래스 옵션을 사용하면 새 클래스를 만들거나 기존 다른 클래스에서 선택할 수 있습니다.

이러한 클래스에 대한 자세한 내용은 XDM individual profile 및 XDM ExperienceEvent 설명서를 참조하십시오. 이 자습서에서는 XDM Individual Profile​을(를) 선택한 후 Next​을(를) 선택하십시오.

이름 및 검토 name-and-review

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

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

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

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

스키마 구성 compose-your-schema

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

필드 그룹 추가 field-group

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

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

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

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

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

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

이 자습서에서는 Demographic Details 필드 그룹을 선택한 다음 Add field group​을(를) 선택하십시오.

스키마 캔버스가 다시 나타납니다. 이제 Field groups 섹션에 "Demographic Details"이(가) 나열되고 Structure 섹션에는 필드 그룹에서 제공한 필드가 포함됩니다. Field groups 섹션 아래에서 필드 그룹의 이름을 선택하여 캔버스 내에서 제공하는 특정 필드를 강조 표시할 수 있습니다.

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

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

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

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

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

이 자습서의 경우 목록에서 표준 필드 그룹 Personal Contact Details 및 Loyalty Details​을(를) 선택한 다음 Add field groups​을(를) 선택하여 스키마에 추가합니다.

추가된 필드 그룹이 Field groups 섹션의 Composition 아래에 나열되고 합성 필드가 스키마 구조에 추가된 상태로 캔버스가 다시 나타납니다.

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

Loyalty Members 스키마는 충성도 프로그램의 구성원과 관련된 데이터를 캡처하기 위한 것이며, 스키마에 추가한 표준 Loyalty Details 필드 그룹은 프로그램 유형, 포인트, 조인 날짜 등을 포함하여 이러한 기능 대부분을 제공합니다.

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

새 필드 그룹을 만들려면 이전과 같이 Add 하위 섹션에서 Field groups​을(를) 선택하십시오. 하지만 이번에는 표시되는 대화 상자의 위쪽에 있는 Create New Field group​을(를) 선택하십시오. 그런 다음 새 필드 그룹의 표시 이름과 설명을 입력하라는 메시지가 표시됩니다. 이 자습서의 경우 새 필드 그룹 이름을 "Custom Loyalty Details"로 지정한 다음 Add field groups​을(를) 선택하십시오.

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

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

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

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

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

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

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

완료되면 Apply​을(를) 선택합니다.

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

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

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

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

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

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

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

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

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

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

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

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

해당 유형을 선택한 후 필드에 대해 Array, Enum & Suggested Values, Identity 및 Relationship​에 대한 확인란을 포함하여 추가 확인란이 표시됩니다.

Enum & Suggested Values 확인란을 선택한 다음 Enum​을(를) 선택합니다. 허용되는 각 충성도 계층 클래스에 대해 Value(camelCase의 경우) 및 Display Name(Title Case의 경우 읽기 쉬운 선택적 이름)을 입력할 수 있습니다.

모든 필드 속성을 완료했으면 Apply​을(를) 선택하여 tierClass 필드를 loyaltyTier 개체에 추가합니다.

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

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

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

loyaltyTier 개체를 데이터 형식으로 변환하려면 캔버스에서 loyaltyTier 필드를 선택한 다음 Convert to new data type 아래 편집기 오른쪽의 Field properties​을(를) 선택하십시오.

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

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

스키마 필드 검색 및 필터링

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

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

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

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

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

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

캔버스에서 personalEmail.address 필드를 선택하면 Identity 확인란이 Field properties 아래에 나타납니다. 상자를 선택하면 Primary identity(으)로 설정하는 옵션이 나타납니다. 이 상자도 선택하십시오.

그런 다음 드롭다운의 미리 정의된 네임스페이스 목록에서 Identity namespace​을(를) 제공해야 합니다. 이 필드는 고객의 전자 메일 주소이므로 드롭다운에서 "Email"을(를) 선택합니다. Apply 필드에 대한 업데이트를 확인하려면 personalEmail.address을(를) 선택하십시오.

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

이제 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​을(를) 선택하면 Profile에 대한 스키마를 사용할지 확인하는 팝오버가 나타납니다.

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

기타 액션 more

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

스키마 삭제 delete-a-schema

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

JSON 구조 복사 copy-json-structure

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

다음 단계 및 추가 리소스

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

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

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

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

비디오 리소스

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

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

부록

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

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

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

스키마 클래스 변경 change-class

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

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