Detalles de fidelización grupo de campos de esquema
Detalles de fidelización es un grupo de campos de esquema estándar para la clase XDM Individual Profile. Proporciona un único campo de tipo de objeto, loyalty, que modela el estado de pertenencia de un cliente al programa de fidelidad, incluidos los ID de fidelidad, los saldos de puntos, las asignaciones de niveles, las recompensas, los desafíos y los detalles de tarjetas.
Esta página es para diseñadores de esquemas e ingenieros de datos familiarizados con el perfil individual de XDM y grupos de campos de esquema. Después de leer esta página, puede asignar datos de perfil de fidelidad a las rutas de campo loyalty correctas.
Cuándo utilizar este grupo de campos when-to-use
Utilice este grupo de campos cuando se apliquen todas las condiciones siguientes.
- La clase de esquema es XDM Individual Profile y representa el estado actual de un miembro del programa de fidelidad.
- El esquema almacena atributos de lealtad persistentes en el perfil del cliente en tiempo real.
- Los casos de uso descendente requieren el estado de pertenencia de fidelidad para la segmentación o personalización.
Utilice los esquemas XDM ExperienceEvent para la actividad de lealtad basada en eventos, como la acumulación de puntos, las finalizaciones de desafíos o los eventos de cambio de nivel.
Estructura del grupo de campos structure
El objeto loyalty contiene las siguientes propiedades.
adjustedPointscardsDetailschallengesexpiredPointsjoinDateyyyy-MM-dd'T'HH:mm:ssXXX) que indica cuándo se unió la persona al programa de fidelidad.lifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationEnumera los puntos de lealtad o grupos de puntos de lealtad que están programados para caducar. Cada elemento de matriz contiene:
pointsExpirationDate: la fecha y hora en que caducan los puntos.pointsExpiring: el número de puntos que caducan en la fecha asociada.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled o suspended.tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate en su lugar. Actualice los esquemas y asignaciones de origen existentes que hacen referencia a upgradeDate para usar tierUpgradeDate.El ejemplo siguiente muestra el objeto loyalty con valores representativos para las estructuras anidadas. Consulte el ejemplo completado en el repositorio XDM para obtener una carga útil válida completa.
{
"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 es una matriz de objetos que captura información sobre las tarjetas de fidelidad asociadas con el miembro.
numberseriesstatusactive, inactive o suspended.challenges challenges
challenges es una matriz de objetos que captura los desafíos de lealtad asociados con el miembro, incluido el progreso del desafío y las tareas relacionadas.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed o expired.tasksEnumera las tareas asociadas con el desafío de fidelidad. Cada elemento de matriz contiene:
endDate: la fecha y hora de finalización de la tarea.entity: la entidad asociada con la tarea.goal: valor de destino de la tarea.name: nombre de la tarea.progress: progreso actual hacia el objetivo de la tarea.startDate: la fecha y hora de inicio de la tarea.state: estado de la tarea actual.type: tipo o categoría de tarea.
rewards rewards
El objeto rewards obtiene recompensas asociadas con el programa de fidelidad.
badgesInsignias de éxito obtenidas por el miembro. Cada elemento de matriz contiene:
id: Identificador de distintivo.name: nombre del distintivo.series: serie o colección de distintivos.startDate: fecha y hora en que se activó el distintivo.endDate: fecha y hora en que caduca el distintivo.state: estado actual del distintivo.
couponsCupones de fidelización disponibles para el abonado. Cada elemento de matriz contiene:
discountValue: valor de descuento monetario.endDate: Fecha de caducidad del cupón.id: Identificador de cupón.name: Nombre del cupón.redemptionCount: Número de veces que se ha canjeado el cupón.redemptionLimit: Número máximo de canjes de cupones.series: serie de cupones o campaña.startDate: Fecha y hora en que el cupón se vuelve válido.state: estado del cupón actual.storeName: nombre del almacén asociado.
giveawaysPromociones de sorteo asociadas con el miembro. Cada elemento de matriz contiene:
endDate: Fecha de finalización del sorteo.id: Identificador de regalo.name: nombre del sorteo.partnerId: Identificador de socio.partnerName: nombre del socio.series: serie o campaña de regalos.startDate: fecha de inicio del sorteo.state: estado actual del sorteo.type: tipo o categoría de regalo.
referralsRecompensas de reenvío obtenidas por el miembro. Cada elemento de matriz contiene:
endDate: fecha de finalización de la referencia.id: Identificador de referencia.name: nombre de recompensa de referencia.recipient: identificador o nombre de la persona de referencia.series: serie de remisiones o campaña.startDate: fecha de inicio de la referencia.state: estado de referencia actual.
Próximos pasos next-steps
Utilice los siguientes recursos al implementar esquemas de perfil de lealtad.
- Agregue este grupo de campos a un esquema de perfil individual XDM utilizando la guía de grupo de campos del Editor de esquemas antes de ingerir datos de perfil de lealtad.
- Utilice el ejemplo completado en el repositorio XDM para validar asignaciones de carga útil de fidelidad.
- Consulte el esquema completo para conocer las restricciones de tipo de datos y las definiciones de campo requeridas.