스키마의 모델 데이터

이 단원에서는 Luma의 데이터를 스키마에 모델링합니다. 이것은 이 자습서에서 가장 긴 교훈 중 하나이므로 물 한 잔을 마시고 버클을 하세요!

표준화와 상호 운용성은 Adobe Experience Platform의 주요 개념입니다. Adobe 기반의 XDM(경험 데이터 모델)은 고객 경험 데이터를 표준화하고 고객 경험 관리를 위한 스키마를 정의하려는 노력입니다.

XDM은 디지털 경험의 힘을 향상시키기 위해 설계된 문서화된 사양입니다. 플랫폼 서비스와 통신하는 데 사용할 응용 프로그램에 대한 공통 구조 및 정의를 제공합니다. XDM 표준을 준수함으로써 모든 고객 경험 데이터를 보다 빠르고 통합된 방식으로 통찰력을 제공할 수 있는 공통 표현으로 통합할 수 있습니다. 고객 작업을 통해 유용한 통찰력을 얻을 수 있고, 세그먼트를 통해 고객 대상을 정의하고, 개인화를 위해 고객 속성을 표현할 수 있습니다.

XDM은 Experience Platform을 기반으로 하는 Adobe Experience Cloud이 올바른 사람에게 올바른 메시지를 올바른 채널에 정확히 적절한 시점에 전달할 수 있도록 하는 기본 프레임워크입니다. Experience Platform을 빌드하는 방법론인 XDM 시스템​은(는) Platform 서비스에서 사용할 Experience Data Model 스키마를 운영하도록 설정합니다.

데이터 아키텍처는 이 자습서의 외부에서 스키마를 만들어야 하지만 데이터 엔지니어링은 Data Architect에서 만든 스키마와 긴밀하게 작동합니다.

연습을 시작하기 전에 이 짧은 비디오에서 스키마 및 XDM(Experience Data Model)에 대한 자세한 내용을 살펴보십시오.

필요한 권한

권한 구성 단원에서는 이 단원을 완료하는 데 필요한 모든 액세스 컨트롤을 설정합니다.

UI를 통해 충성도 스키마 만들기

노트

최근 플랫폼 인터페이스에서 "mixin"이라는 용어가 "필드 그룹"으로 업데이트되었습니다. 이 일부 스크린샷에는 여전히 표시될 수 있습니다.

이 연습에서는 고객의 충성도 데이터를 수집하기 위한 Luma 충성도 스키마를 만듭니다.

  1. 플랫폼 UI로 이동하고 샌드박스가 선택되어 있는지 확인합니다.

  2. 왼쪽 탐색 영역에서 스키마​로 이동합니다.

  3. 오른쪽 상단에 있는 스키마 만들기 단추를 선택합니다

  4. 드롭다운 메뉴에서 XDM 개별 프로필​을 선택합니다
    OOTB 필드 그룹이 있는 스키마

  5. 화면 오른쪽의 스키마 속성​에 표시 이름 Luma Loyalty Schema을 입력합니다

표준 필드 그룹 추가

필드 그룹을 추가하여 스키마에 필드가 추가됩니다. Adobe이 제공하는 대규모 업계 표준 필드 그룹 중에서 선택하거나 직접 생성할 수 있습니다. Experience Platform에서 자체 데이터를 모델링하기 시작하면 Adobe에서 제공하는 업계 표준 필드 그룹을 잘 알고 있는 것이 좋습니다. 가능하면 고객 AI, Attribution AI 및 Adobe Analytics과 같은 다운스트림 서비스를 제공하는 경우가 있을 때 사용하는 것이 좋습니다.

필드 그룹을 추가하려면 다음을 수행합니다.

  1. 스키마 편집기 왼쪽의 필드 그룹 섹션에서 추가 단추를 선택합니다.

    필드 그룹 추가

  2. 필드 그룹 모달에서 다음 필드 그룹을 선택합니다

    1. 인구 통계 세부 정보
    2. 개인 연락처 세부 정보
  3. 행 오른쪽에 있는 아이콘을 선택하여 필드 그룹의 필드를 미리 볼 수 있습니다.

  4. 필드 그룹 추가​를 선택하여 필드 그룹을 스키마에 추가합니다
    충성도 스키마에 기본 필드 그룹 추가

이제 스키마의 현재 상태를 탐색하는 데 시간이 좀 걸립니다. 이 두 필드 그룹은 개인 및 해당 연락처 세부 정보와 관련된 표준 필드를 추가했습니다. 이러한 두 필드 그룹은 회사 데이터에 대한 스키마를 생성할 때 유용할 수 있습니다. 특정 필드 그룹 행을 선택하거나 필드 그룹 이름 옆에 있는 상자를 선택하여 시각화가 어떻게 변경되는지 확인합니다.

OOTB 필드 그룹이 있는 스키마

노트

필드 그룹이 수집하지 않는 데이터 포인트에 대한 필드를 추가해도 됩니다. 예를 들어 "faxPhone"은 Luma가 데이터를 수집하지 않는 필드일 수 있습니다. 괜찮아요. 스키마에 필드가 정의되었다고 해서 에 대한 데이터가 나중에 수집해야 한다는 뜻은 아닙니다.

사용자 지정 필드 그룹 추가

다음으로, Luma의 충성도 시스템에 해당하며 표준 필드 그룹에 존재하지 않는 필드를 추가해야 합니다. 이를 위해 고유한 필드 그룹을 만들 수 있습니다.

  1. 스키마 편집기의 필드 그룹 섹션에서 추가 단추를 다시 선택합니다

  2. 새 필드 그룹 만들기 라디오 단추를 선택합니다.

  3. 표시 이름을 Luma Loyalty field group(으)로 입력하고 필드 그룹 추가 단추를 선택합니다.
    필드 그룹에 필드 추가

  4. 스키마 편집기의 필드 그룹 섹션에서 + 단추가 구조 섹션에 표시되도록 새 필드 그룹의 이름을 선택합니다

  5. 구조 섹션에서 스키마 구조의 최상위 수준에서 +​를 선택합니다. 테넌트 ID(밑줄) 및 'New field' 필드가 있는 개체를 만듭니다.

  6. 필드 속성 섹션에서 다음을 입력합니다

    1. 필드 이름: loyalty
    2. 표시 이름:Loyalty
    3. 유형:개체
  7. 적용​을 선택하여 필드를 추가합니다

    필드 그룹에 필드 추가

  8. 새로 만든 loyalty 개체를 선택하고 개체 옆에 있는 + 단추를 선택하여 개체 내에 필드를 추가합니다

  9. 다음 값을 갖는 필드 만들기

    1. 필드 이름: memberSince
    2. 표시 이름:Member Since
    3. 유형:날짜
  10. 적용​을 선택하여 필드를 추가합니다

  11. 8-10단계를 반복하여 loyalty 개체 내에 두 개의 필드를 더 추가합니다.

    1. 포인트
      1. 필드 이름: points
      2. 디스플레이 이름: Points
      3. 유형:정수
      4. 기본값:0
    2. 수준
      1. 필드 이름: level

      2. 디스플레이 이름: Level

      3. 유형:문자열

      4. 열거형:다음 열거형 값과 함께 선택됨:

        레이블
        청동 청동
        백금 백금
  12. 저장​을 선택하여 스키마의 현재 상태를 저장합니다. 이러한 상태는 다음과 같습니다.

    충성도 필드 그룹 완료

이제 다른 스키마에서 사용할 충성도Id 필드 및 기타 식별자를 포함하는 다른 필드 그룹을 만듭니다. 이제 필드 그룹을 만드는 방법을 잘 알고 있으므로 다음 필드로 Luma Identity Profile field group 이름을 지정하십시오.

  1. 시스템 식별자
    1. 필드 이름: systemIdentifier
    2. 디스플레이 이름: System Identifier
    3. 유형:개체
  2. 충성도 ID(systemIdentifier 개체에 입력)
    1. 필드 이름: loyaltyId
    2. 디스플레이 이름: Loyalty Id
    3. 유형:문자열
  3. CRM Id(systemIdentifier 개체에 입력)
    1. 필드 이름: crmId
    2. 표시 이름:CRM Id
    3. 유형:문자열

새 필드 그룹은 다음과 같아야 합니다. 저장 단추를 선택하여 스키마를 저장하지만 다음 연습에 대해서는 스키마를 열어 두십시오.
충성도 필드 그룹 완료

데이터 유형 만들기

Luma Loyalty field group 과 같은 필드 그룹을 다른 스키마에서 다시 사용할 수 있으므로, 여러 시스템에 표준 데이터 정의를 적용할 수 있습니다. 그러나 클래스​를 공유하는 스키마에서 필드 그룹을 다시 사용할 수만 있습니다(이 경우 XDM 프로필 클래스).

데이터 형식은 여러 클래스 의 스키마에서 다시 사용할 수 있는 다른 다중 필드 구성입니다. 새 systemIdentifier 개체를 데이터 형식으로 변환하겠습니다.

Luma Loyalty Schema이 여전히 열려 있는 상태에서 systemIdentifier 개체를 선택하고 새 데이터 형식으로 변환​을 선택합니다

충성도 필드 그룹 완료

이 데이터 유형은 나중에 단원에서 사용할 것입니다.

API를 통해 CRM 스키마 만들기

이제 API를 사용하여 스키마를 만들겠습니다.

노트

API 연습을 건너뛰려면 UI 방법을 사용하여 다음 스키마를 생성할 수 있습니다.

  1. XDM 개별 프로필 클래스 사용
  2. 이름을 Luma CRM Schema 로 지정합니다.
  3. 다음 필드 그룹을 사용합니다.인구 통계 세부 사항, 개인 연락처 세부 사항 및 Luma Identity 프로필 필드 그룹

먼저 빈 스키마를 만듭니다.

  1. 열기 Postman

  2. 지난 24시간 동안 요청을 하지 않은 경우 인증 토큰이 만료되었을 수 있습니다. 요청 Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token​을 열고 전송​을 선택하여 새 JWT 및 액세스 토큰을 요청합니다.

  3. 환경 변수를 열고 CONTAINER_ID 값을 global에서 tenant(으)로 변경합니다. 스키마 만들기와 같이 Platform에서 고유한 사용자 지정 요소와 상호 작용하려면 항상 tenant을 사용해야 합니다.
    CONTAINER_ID를 테넌트 로 변경

  4. 요청 Schema Registry API > Schemas > Create a new tenant-defined schema​을 엽니다.

  5. Body 탭을 열고 다음 코드를 붙여 넣은 다음 Send 를 선택하여 API를 호출합니다. 이 호출은 충성도 스키마에 사용된 것과 동일한 XDM Individual Profile 기본 클래스를 사용하여 새 스키마를 만듭니다.

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    노트

    표준 클래스 및 필드 그룹 개체의 네임스페이스 참조는 이 및 후속 코드 샘플에서 스키마 레지스트리 API > 스키마 > 지정된 컨테이너의 모든 클래스 나열 등의 목록 API 호출을 사용하여 가져올 수 있습니다. 또는 Schema Registry API > Field groups > Return a list of all field groups within the specified container.CONTAINER_ID 로 설정하고 global 수락 헤더를 application/vnd.adobe.xdm+json사용합니다.

  6. 201 Created 응답이 있어야 합니다.

  7. 응답 본문에서 meta:altId 를 복사합니다. 나중에 또 다른 연습에 사용하겠습니다
    CRM 스키마 만들기

  8. 새 스키마는 UI에 표시되어야 하지만 필드 그룹은 표시되지 않습니다
    CRM 스키마 만들기

노트

meta:altId 또는 스키마 ID는 CONTAINER_ID​가 tenant로 설정된 API 요청 Schema Registry API > Schemas > List all schemas within the specified container.​과 수락 헤더 application/vnd.adobe.xdm+json로 설정하여 가져올 수도 있습니다.

이 호출의 일반적인 문제 및 가능한 수정 사항:

  • 인증 토큰이 없습니다.IMS 실행:JWT 사용자 토큰 호출을 통해 새 토큰을 생성하는 + 인증 생성
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/:CONTAINER_ IDenvironment 변수를 에서 로 global 업데이트 tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control:Admin Console에서 사용자 권한 확인

표준 필드 그룹 추가

이제 스키마에 필드 그룹을 추가할 차례입니다.

  1. Postman에서 요청 Schema Registry API > Schemas > Modify or update part of a tenant-defined schema​을 엽니다.

  2. Params 탭에서 이전 응답의 meta:altId 값을 $id 로 붙여 넣습니다.

  3. Body 탭을 열고 다음 코드를 붙여 넣은 다음 Send 를 선택하여 API 를 호출합니다. 이 호출은 표준 필드 그룹을 Luma CRM Schema에 추가합니다.

    [{
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
        }
      },
      {
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
        }
      }
    ]
    
  4. 응답에 대한 200 확인 상태가 있어야 하며 필드 그룹이 UI에서 스키마의 일부로 표시되어야 합니다

    표준 필드 그룹이 추가되었습니다

사용자 지정 필드 그룹 추가

이제 ID 프로필 필드 그룹을 스키마에 추가하겠습니다. 마지막 호출의 요청 본문을 확인하는 동안 사용자 지정 필드 그룹에 사용할 $ref 값을 어떻게 알 수 있습니까? 목록 API를 사용하여 값을 찾을 수 있습니다.

  1. 요청 Schema Registry API > Field groups > Return a list of all field groups within the specified container.​을 엽니다.

  2. Headers 탭에서 Accept 헤더를 application/vnd.adobe.xed-id+json로 업데이트하십시오

  3. 계정에 있는 모든 사용자 지정 필드 그룹의 목록을 검색하려면 보내기 단추를 선택하십시오

  4. Luma Identity Profile field group$id 값을 가져오십시오(이 스크린샷의 값과 다릅니다.)
    필드 그룹 목록 검색

  5. 이제 요청 Schema Registry API > Schemas > Modify or update part of a tenant-defined schema​을 다시 엽니다.

  6. Params 탭에는 여전히 스키마의 $id가 있어야 합니다

  7. Body 탭을 열고 다음 코드를 붙여 넣고 $ref 값을 자신의 Luma Identity Profile field group $id로 바꿉니다.

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_MIXIN_ID"
      }
    }]
    
  8. Send 선택

    ID 필드 그룹 추가

UI를 확인하여 필드 그룹이 스키마에 추가되었는지 확인합니다. 보너스 포인트의 경우 Postman 컬렉션에서 Lookup a specific schema by its unique ID 호출을 사용하여 스키마에 있는 필드 그룹을 나열하는 방법을 알 수 있는지 확인하십시오.

오프라인 구매 이벤트 스키마 만들기

이제 Luma의 오프라인 구매 데이터에 대해 XDM ExperienceEvent 클래스를 기반으로 스키마를 만들겠습니다. 이제 스키마 편집기 UI에 익숙해지므로 다음 지침에 따라 스크린샷 수를 줄이겠습니다.

  1. XDM ExperienceEvent 클래스를 사용하여 스키마를 만듭니다. Luma Offline Purchase Events Schema

  2. 이를 저장하고 XDM 프로필 클래스 스키마에서 기본 구조의 차이를 검토하십시오. XDM ExperienceEvent 클래스를 사용할 때 알림 _id 및 타임스탬프는 필수 필드입니다.

    경험 이벤트 기본 구조

다음으로 표준 필드 그룹과 사용자 지정 필드 그룹을 추가합니다.

표준 필드 그룹 추가

상거래 상세 정보는 공통 주문 세부 사항을 캡처하기 위한 표준 필드 그룹을 나타냅니다. 계속하여 스키마에 추가합니다. 안에 있는 개체를 탐색하는 데 몇 분 정도 소요됩니다.

사용자 지정 필드 그룹 추가

이제 새 스키마에 ID를 추가하겠습니다.

  1. 필드 그룹 섹션에서 추가 단추를 선택합니다.
  2. Luma Identity Profile field group을 검색합니다. 사용할 수 없습니다! 필드 그룹은 클래스에만 해당되며 이 스키마에서는 XDM 개별 프로필 클래스 대신 XDM ExperienceEvent 클래스를 사용합니다. 데이터 유형 덕분에 동일한 정확한 ID 필드를 포함하는 XDM ExperienceEvent 클래스에 대한 새 필드 그룹을 추가합니다
  3. 새 필드 그룹 만들기 라디오 단추를 선택합니다
  4. 이름Luma Identity ExperienceEvent Field group(으)로 입력하고 필드 그룹 추가 단추를 선택합니다
  5. 새 필드를 추가할 수 있도록 + 단추가 구조 섹션에 표시되어야 합니다
  6. 구조 섹션에서 스키마의 최상위 수준에서 +​를 선택합니다
  7. 필드 이름​으로 systemIdentifier를 입력합니다.
  8. 표시 이름​으로 System Identifier를 입력합니다
  9. Type​으로 이전에 만든 사용자 지정 데이터 유형인 시스템 식별자​를 선택합니다
  10. 적용 단추를 선택합니다.
  11. 저장 단추를 선택하여 스키마를 저장합니다

데이터 유형에 모든 필드가 추가된 방법을 확인합니다.

필드 그룹에 데이터 유형 추가

웹 이벤트 스키마 만들기

이제 Luma의 웹 사이트 데이터에 대해 한 개의 스키마를 더 추가하겠습니다. 이 시점에서는 스키마를 만드는 데 전문가여야 합니다! 이러한 속성을 사용하여 다음 스키마 작성

속성
스키마 이름 Luma 웹 이벤트 스키마
클래스 XDM ExperienceEvent
필드 그룹 AEP 웹 SDK ExperienceEvent Mixin
필드 그룹 소비자 경험 이벤트 필드 그룹

스키마 편집기의 구성 섹션에서 소비자 경험 이벤트 필드 그룹​에서 을 선택합니다. 이 필드 그룹에는 상거래 세부 정보​에도 있었던 상거래 및 productListItems 개체도 포함되어 있습니다. 실제로 소비자 경험 이벤트 필드 그룹​은 별도로 사용할 수 있는 여러 다른 표준 필드 그룹의 조합입니다.

이 스키마에 Luma Identity ExperienceEvent Field group을 추가하지 않았습니다. 웹 SDK에는 다른 방식으로 ID를 수집하는 방법이 있기 때문입니다. 스키마 편집기의 Composition 섹션에서 XDM ExperienceEvent 클래스를 선택하면 기본적으로 추가하는 필드 중 하나가 IdentityMap​이라는 것을 알 수 있습니다. IdentityMap 다양한 Adobe 애플리케이션에서 Platform에 연결하는 데 사용됩니다. 스트리밍 수집 단원에서 identityMap을 통해 Platform으로 ID가 전송되는 방법을 확인할 수 있습니다.

제품 카탈로그 스키마 만들기

Luma는 Experience 이벤트 상거래 세부 사항 및 소비자 경험 이벤트 필드 그룹을 사용하여 표준 productListItems 데이터 유형을 통해 제품 관련 이벤트의 세부 사항을 보고합니다. 또한 Platform에 전송할 추가 제품 세부 사항 필드가 있습니다. Luma는 판매 지점 및 전자 상거래 시스템에서 이러한 모든 필드를 캡처하고 생성한 스키마를 사용하여 Platform으로 수집하는 대신 제품 카탈로그 시스템에서 이러한 필드를 직접 수집하는 것을 선호합니다. Platform의 "관계 스키마"를 사용하면 분류를 위해 두 스키마 간의 관계를 정의할 수 있습니다. Luma는 관계 스키마를 사용하여 제품 세부 사항을 분류합니다. 지금 프로세스를 시작하고 다음 단원이 끝날 때 완료합니다.

노트

기존 Analytics 또는 Target 고객의 경우 관계 스키마로 엔티티를 분류하는 것은 SAINT 분류 또는 Recommendations용 제품 카탈로그를 업로드하는 것과 유사합니다

먼저 사용자 지정 클래스를 사용하여 Luma의 제품 카탈로그에 대한 스키마를 만들어야 합니다.

  1. 스키마 만들기 단추를 선택하고 드롭다운에서 찾아보기 옵션을 선택합니다
    새 스키마 만들기
  2. 새 클래스 만들기 라디오 단추를 선택합니다
  3. 이름을 Luma Product Catalog Class 로 지정합니다.
  4. Behavior​을 Record​로 둡니다.
  5. Assign Class 단추를 클릭합니다.
    새 클래스 만들기
  6. 스키마 이름 Luma Product Catalog Schema(올바른 필드를 업데이트하고 클래스 이름을 업데이트하지 마십시오.)
  7. 다음 필드를 사용하여 Luma Product Catalog Field group라는 필드 그룹을 추가합니다.
    1. productName:제품 이름:문자열
    2. productCategory:제품 카테고리:문자열
    3. productColor:제품 색상:문자열
    4. productSku:제품 SKU:문자열 | 필수
    5. productSize:제품 크기:문자열
    6. productPrice:제품 가격:이중
  8. 스키마 저장

새 스키마는 다음과 같습니다. productSku 필드가 필수 필드 섹션에 어떻게 나열되는지 확인합니다.
제품 스키마

다음 단계는 두 ExperienceEvent 스키마와 Luma Product Catalog Schema 간의 관계를 정의하는 것입니다. 하지만 다음 단원에서 수행해야 하는 몇 가지 추가 단계가 있습니다.

추가 리소스

스키마가 있으므로 ID를 매핑할 수 있습니다.

이 페이지에서는