Show Menu
화제×

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

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

시작하기

이 자습서에서는 스키마 편집기 사용과 관련된 Adobe Experience Platform의 다양한 측면을 파악해야 합니다. 이 자습서를 시작하기 전에 다음 개념에 대한 설명서를 참조하십시오.
  • XDM(Experience Data Model) :플랫폼이 고객 경험 데이터를 구성하는 표준화된 프레임워크입니다.
  • 스키마 컴포지션의 기본 사항:클래스, 믹싱, 데이터 유형 및 필드를 비롯한 XDM 스키마 및 해당 구성 요소에 대한 개요입니다.
  • 실시간 고객 프로필 :다양한 소스의 데이터를 집계하여 통합된 실시간 고객 프로파일을 제공합니다.
이 튜토리얼을 사용하려면 Experience Platform에 액세스해야 합니다. Experience Platform에서 IMS 조직에 액세스할 수 없는 경우 시스템 관리자에게 문의하십시오.

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

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

스키마 만들기 및 이름 지정

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

클래스 할당

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

혼합 추가

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

다른 믹스 추가

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

새로운 믹싱 정의

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

믹스에 필드 추가

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

혼합할 필드 추가

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

혼합에 'enum' 필드 추가

스키마 편집기에서 필드를 정의할 때 필드에 포함할 수 있는 데이터에 대한 추가 제한을 제공하기 위해 기본 필드 유형에 적용할 수 있는 몇 가지 추가 옵션이 있습니다.
예를 들어 "충성도 수준" 필드가 될 수 있습니다. 이 필드는 값이 가능한 네 가지 옵션 중 하나일 수 있습니다. 이 필드를 스키마에 추가하려면 "충성도" 개체 옆에 있는 필드 추가를 클릭하고 필드 속성 아래에 필요한 필드를 채웁니다 .
Type ​경우 "String"을 선택하면 Array , Enum , Identity ​에 대한 추가 확인란이 ​표시됩니다.
열거형 확인란을 선택하여 아래의 열거형 값 섹션을 엽니다. 여기에서 허용되는 각 충성도 수준에 대해 (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° 프로필뿐만 아니라 Adobe Experience Platform과 통합된 모든 시스템에서 고객이 경험하는 모든 인터랙션에 대한 타임스탬프가 지정된 계정을 구축하여 각 개별 고객의 전체적인 관점을 제공합니다.
실시간 고객 프로파일에서 사용할 수 있도록 스키마를 활성화하려면 기본 ID가 정의되어 있어야 합니다. 주 ID를 먼저 정의하지 않고 스키마를 활성화하려고 하면 "기본 ID 누락" 오류 메시지가 표시됩니다.
프로파일에서 사용하기 위해 "충성도 멤버" 스키마를 활성화하려면 먼저 편집기의 구조 섹션에서 "충성도 멤버"를 클릭합니다.
편집기 오른쪽의 #에서 ​해당 표시 이름, 설명 및 유형을 포함한 스키마에 대한 정보가 표시됩니다. 이 정보 외에 프로필 표시/숨기기 단추가 있습니다 .
프로필을 클릭하면 프로필의 스키마를 활성화할지 확인하는 팝업이 나타납니다.
실시간 고객 프로필에 대해 스키마가 활성화되고 저장되면 비활성화할 수 없습니다.

다음 단계

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

부록

다음 정보는 스키마 편집기 자습서를 보완하는 것입니다.

Create a new class

Experience Platform을 사용하면 조직에 고유한 클래스를 기반으로 스키마를 유연하게 정의할 수 있습니다.
스키마 편집기의 클래스 섹션에서 할당을 클릭하여 클래스 할당 대화상자를 엽니다. 대화 상자에서 새 클래스 만들기를 선택합니다 .
그런 다음 새 클래스에 스키마에 대해 표시 이름 (클래스에 대해 짧고 설명적이며 고유하며 사용자에게 친숙한 이름) , 설명 비헤이비어("레코드" 또는 "시간시리즈")를 지정할 수 있습니다.
조직에서 정의한 클래스를 구현하는 스키마를 빌드할 때는 호환 가능한 클래스에서만 믹싱을 사용할 수 있습니다. 정의한 클래스는 새로운 것이므로 # 대화 상자에 나열된 호환 가능한 믹스가 없습니다. 대신 # 를 선택하고 해당 클래스에서 사용할 믹싱을 정의해야 합니다. 다음에 새 클래스를 구현하는 스키마를 작성할 때 정의한 혼합이 나열되고 사용할 수 있습니다.

스키마 클래스 변경

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