忠诚度详细信息架构字段组
忠诚度详细信息是XDM个人资料类的标准架构字段组。 它提供单个对象类型字段loyalty，用于模拟客户的忠诚度计划会员资格状态，包括忠诚度ID、积分余额、层分配、奖励、挑战和卡详细信息。
本页面向熟悉XDM个人资料和架构字段组的架构设计人员和数据工程师。 阅读本页后，您可以将忠诚度配置文件数据映射到正确的loyalty字段路径。
IMPORTANT
此字段组捕获会员资格状态。 个人忠诚度事件通常在XDM ExperienceEvent架构中建模。
何时使用此字段组 when-to-use
当满足以下所有条件时，请使用此字段组。
- 架构类是XDM Individual Profile，表示忠诚度计划成员的当前状态。
- 架构将永久忠诚度属性存储在实时客户配置文件中。
- 下游用例需要会员资格状态以进行分段或个性化。
将XDM ExperienceEvent架构用于基于事件的忠诚度活动，例如积分累计、挑战完成或层级更改事件。
字段组结构 structure
loyalty对象包含以下属性。
属性
数据类型
描述
adjustedPoints双精度
因校正、返回或其他修改而调整的点数。
expiredPoints双精度
已过期且不再可供使用的点总数。
joinDate日期时间
指示人员何时加入忠诚度计划的ISO 8601日期时间。
lifetimePoints双精度
客户忠诚度计划会员资格获得的总积分。
lifetimePurchases双精度
在客户的忠诚度计划会员资格期间进行的所有购买的总货币价值。
loyaltyID字符串数组
与成员关联的忠诚度计划标识符。
nextTier字符串
成员可以获得的下一个忠诚度级别。
points双精度
成员的忠诚度积分或奖励的当前余额。
pointsExpiration对象数组
列出计划过期的会员积分或会员积分组。 每个数组项包含：
pointsExpirationDate：积分到期的日期和时间。pointsExpiring：在关联日期过期的点数。
pointsRedeemed双精度
用于购买或其他奖励的积分总数。
pointsToNextTier双精度
成员符合下一个忠诚度级别资格之前所需的点数。
program字符串
人员注册的忠诚度计划的名称。
promisedPoints双精度
已向客户承诺但尚未贷记帐户的点数。
returnedPoints双精度
因退款或调整而返回到客户帐户的积分。
status字符串
忠诚度会员的当前状态，如
active、disabled或suspended。tier字符串
成员注册的当前忠诚度级别。
tierExpiryDate日期时间
客户当前忠诚度等级过期的日期和时间。
tierUpgradeDate日期时间
客户升级到下一个忠诚度级别时的日期和时间。
upgradeDate字符串
已弃用。 请改用
tierUpgradeDate。 更新引用upgradeDate的现有架构和源映射以使用tierUpgradeDate。以下示例显示具有嵌套结构代表值的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是一个对象数组，用于捕获与该成员关联的会员卡信息。
属性
数据类型
描述
number字符串
会员卡编号或标识符。
series字符串
会员卡所属的系列或集合。
status字符串
当前会员卡状态，如
active、inactive或suspended。challenges challenges
challenges是一个对象数组，可捕获与该成员关联的忠诚度挑战，包括挑战进度和相关任务。
属性
数据类型
描述
description字符串
忠诚度挑战的详细说明。
endDate日期时间
挑战结束的日期和时间。
frequencyType字符串
与挑战相关的频率，例如每天、每周或每月。
id字符串
忠诚度挑战的唯一标识符。
name字符串
忠诚度质询的名称。
series字符串
挑战所属的系列或集合。
startDate日期时间
挑战开始的日期和时间。
state字符串
当前质询状态，如
active、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：赠送名称。partnerId：合作伙伴标识符。partnerName：合作伙伴名称。series：赠送系列或促销活动。startDate：放弃开始日期。state：当前赠送状态。type：放弃类型或类别。
referrals对象数组
成员获得的推荐奖励。 每个数组项包含：
endDate：反向链接结束日期。id：引用标识符。name：推荐奖励名称。recipient：引用的人员的标识符或名称。series：反向链接系列或营销活动。startDate：反向链接开始日期。state：当前引用状态。
后续步骤 next-steps
实施忠诚度用户档案架构时，请使用以下资源。
- 在摄取忠诚度配置文件数据之前，使用架构编辑器字段组指南将此字段组添加到XDM个人配置文件架构中。
- 使用XDM存储库中的填充示例验证忠诚度有效负载映射。
- 有关数据类型约束和必填字段定义，请参阅完整架构。
recommendation-more-help
experience-platform-help-xdm