충성도 세부 정보 스키마 필드 그룹
충성도 세부 정보은(는) XDM 개인 프로필 클래스의 표준 스키마 필드 그룹입니다. 충성도 ID, 포인트 잔고, 계층 할당, 보상, 문제 및 카드 세부 정보를 포함하여 고객의 충성도 프로그램 멤버십 상태를 모델링하는 단일 개체 유형 필드 loyalty을(를) 제공합니다.
이 페이지는 XDM 개인 프로필 및 스키마 필드 그룹에 익숙한 스키마 디자이너 및 데이터 엔지니어를 위한 페이지입니다. 이 페이지를 읽고 충성도 프로필 데이터를 올바른 loyalty 필드 경로에 매핑할 수 있습니다.
이 필드 그룹을 사용해야 하는 경우 when-to-use
다음 조건이 모두 적용되는 경우 이 필드 그룹을 사용합니다.
- 스키마 클래스는 XDM 개인 프로필이며 충성도 프로그램 멤버의 현재 상태를 나타냅니다.
- 이 스키마는 실시간 고객 프로필에 영구 충성도 속성을 저장합니다.
- 다운스트림 사용 사례에서는 세분화 또는 개인화를 위해 충성도 멤버십 상태가 필요합니다.
포인트 적립, 도전 완료 또는 계층 변경 이벤트와 같은 이벤트 기반 충성도 활동에 XDM ExperienceEvent 스키마를 사용하십시오.
필드 그룹 구조 structure
loyalty 개체에 다음 속성이 있습니다.
adjustedPointsexpiredPointslifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpiration만료 예정인 충성도 포인트 또는 충성도 포인트 그룹을 나열합니다. 각 배열 항목에는 다음이 포함됩니다.
pointsExpirationDate: 포인트가 만료되는 날짜 및 시간입니다.pointsExpiring: 연결된 날짜에 만료되는 포인트 수.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsstatusactive, disabled 또는 suspended).tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate을(를) 사용합니다. tierUpgradeDate을(를) 사용하도록 upgradeDate을(를) 참조하는 기존 스키마 및 원본 매핑을 업데이트하십시오.다음 예제에서는 중첩된 구조에 대한 대표 값이 있는 loyalty 개체를 보여 줍니다. 전체 유효한 페이로드는 XDM 저장소에서 채워진 예제를 참조하십시오.
{
"loyalty": {
"program": "Acme Rewards",
"tier": "gold",
"points": 4200,
"pointsExpiration": [
{ "pointsExpirationDate": "2026-12-31T00:00:00Z", "pointsExpiring": 500 }
],
"cardsDetails": [
{ "number": "LC-0042", "status": "active" }
],
"challenges": [
{
"id": "CH-001",
"state": "active",
"tasks": [{ "name": "Make 3 purchases", "goal": 3, "progress": 1 }]
}
],
"rewards": {
"badges": [
{ "id": "BDG-100", "state": "active" }
]
}
}
}
cardsDetails cardsDetails
cardsDetails은(는) 멤버와 연결된 고객 충성도 카드에 대한 정보를 캡처하는 개체 배열입니다.
numberseriesstatusactive, inactive 또는 suspended과(와) 같은 현재 로열티 카드 상태입니다.challenges challenges
challenges은(는) 과제 진행 상황 및 관련 작업을 포함하여 멤버와 관련된 충성도 과제를 캡처하는 오브젝트 배열입니다.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed 또는 expired과(와) 같은 현재 챌린지 상태입니다.tasks충성도 문제와 관련된 작업을 나열합니다. 각 배열 항목에는 다음이 포함됩니다.
endDate: 작업 종료 날짜 및 시간입니다.entity: 작업과 연결된 엔터티입니다.goal: 작업의 대상 값입니다.name: 작업 이름입니다.progress: 작업 목표에 대한 현재 진행률입니다.startDate: 작업 시작 날짜 및 시간입니다.state: 현재 작업 상태입니다.type: 작업 유형 또는 범주.
rewards rewards
rewards 개체는 충성도 프로그램과 관련된 보상을 캡처합니다.
badges멤버가 획득한 성과 배지. 각 배열 항목에는 다음이 포함됩니다.
id: 배지 식별자.name: 배지 이름입니다.series: 배지 시리즈 또는 컬렉션startDate: 배지가 활성화된 날짜 및 시간입니다.endDate: 배지가 만료되는 날짜 및 시간입니다.state: 현재 배지 상태입니다.
coupons회원이 사용할 수 있는 충성도 쿠폰입니다. 각 배열 항목에는 다음이 포함됩니다.
discountValue: 통화 할인 값.endDate: 쿠폰 만료일.id: 쿠폰 식별자.name: 쿠폰 이름.redemptionCount: 쿠폰을 상환한 횟수입니다.redemptionLimit: 최대 쿠폰 상환 수.series: 쿠폰 시리즈 또는 캠페인.startDate: 쿠폰이 유효하게 되는 날짜 및 시간입니다.state: 현재 쿠폰 상태입니다.storeName: 연결된 저장소의 이름입니다.
giveaways멤버와 연결된 프로모션 제공. 각 배열 항목에는 다음이 포함됩니다.
endDate: 경품 제공 종료 날짜입니다.id: 경품 식별자.name: Giveaway 이름입니다.partnerId: 파트너 식별자.partnerName: 파트너 이름.series: Giveaway 시리즈 또는 캠페인.startDate: 경품 시작 날짜입니다.state: 현재 경품 상태입니다.type: 경품 유형 또는 범주.
referrals회원이 획득한 추천 보상. 각 배열 항목에는 다음이 포함됩니다.
endDate: 조회 종료일.id: 참조 식별자.name: 참조 보상 이름.recipient: 참조된 사람의 식별자 또는 이름입니다.series: 추천 시리즈 또는 캠페인startDate: 조회 시작일.state: 현재 참조 상태입니다.
다음 단계 next-steps
충성도 프로필 스키마를 구현할 때 다음 리소스를 사용하십시오.
- 충성도 프로필 데이터를 수집하기 전에 스키마 편집기 필드 그룹 안내서를 사용하여 XDM 개인 프로필 스키마에 이 필드 그룹을 추가하십시오.
- XDM 저장소에서 채워진 예제를 사용하여 충성도 페이로드 매핑의 유효성을 검사합니다.
- 데이터 형식 제약 조건 및 필수 필드 정의에 대해서는 전체 스키마을(를) 참조하십시오.