Groupe de champs de schéma Détails de fidélité
Détails de fidélité est un groupe de champs de schéma standard pour la classe Profil individuel XDM. Il fournit un champ unique de type objet, loyalty, qui modélise l’état d’appartenance au programme de fidélité d’un client, y compris les identifiants de fidélité, les soldes de points, les affectations de niveau, les récompenses, les défis et les détails de carte.
Cette page est destinée aux concepteurs de schémas et aux ingénieurs de données qui connaissent bien XDM Individual Profile et les groupes de champs de schéma. Après avoir lu cette page, vous pouvez mapper les données du profil de fidélité aux chemins d’accès aux champs de loyalty corrects.
Quand utiliser ce groupe de champs ? when-to-use
Utilisez ce groupe de champs lorsque toutes les conditions suivantes s’appliquent.
- La classe de schéma est XDM Individual Profile et représente le statut actuel d’un membre du programme de fidélité.
- Le schéma stocke les attributs de fidélité persistants dans le profil client en temps réel.
- Les cas d’utilisation en aval nécessitent un état d’appartenance de fidélité pour la segmentation ou la personnalisation.
Utilisez des schémas XDM ExperienceEvent pour les activités de fidélité basées sur un événement, telles que l’accumulation de points, les tâches terminées par un défi ou les événements de changement de niveau.
Structure du groupe de champs structure
L’objet loyalty contient les propriétés suivantes.
adjustedPointscardsDetailschallengesexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationRépertorie les points de fidélité, ou groupes de points de fidélité, dont l’expiration est planifiée. Chaque élément de tableau contient :
pointsExpirationDate: date et heure d’expiration des points.pointsExpiring: nombre de points expirant à la date associée.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled ou suspended.tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate à la place. Mettez à jour les schémas existants et les mappages source qui font référence aux upgradeDate à utiliser tierUpgradeDate.L’exemple suivant illustre l’objet loyalty avec des valeurs représentatives pour les structures imbriquées. Voir l’exemple renseigné dans le référentiel XDM pour une payload valide complète.
{
"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 est un tableau d’objets qui recueille les informations sur les cartes de fidélité associées au membre.
numberseriesstatusactive, inactive ou suspended.challenges challenges
challenges est un tableau d’objets qui capture les défis de fidélité associés au membre, y compris la progression du défi et les tâches associées.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed ou expired.tasksRépertorie les tâches associées au défi de fidélité. Chaque élément de tableau contient :
endDate: date et heure de fin de la tâche.entity: entité associée à la tâche.goal: valeur cible de la tâche.name: nom de la tâche.progress: progression actuelle vers l’objectif de la tâche.startDate: date et heure de début de la tâche.state: état actuel de la tâche.type: type ou catégorie de tâche.
rewards rewards
L’objet rewards capture les récompenses associées au programme de fidélité.
badgesBadges d’accomplissement gagnés par le membre. Chaque élément de tableau contient :
id: identifiant du badge.name: nom du badge.series: collection ou série de badges.startDate: date et heure auxquelles le badge est devenu actif.endDate: date et heure d’expiration du badge.state: état actuel du badge.
couponsCoupons de fidélité disponibles pour le membre. Chaque élément de tableau contient :
discountValue: valeur d’escompte monétaire.endDate: date d’expiration du coupon.id: identifiant du coupon.name: nom du coupon.redemptionCount: nombre de fois que le coupon a été échangé.redemptionLimit: nombre maximal de coupons échangés.series: série de coupons ou campagne.startDate: date et heure de validité du coupon.state: état actuel du coupon.storeName: nom du magasin associé.
giveawaysPromotions de cadeau associées au membre. Chaque élément de tableau contient :
endDate: date de fin du cadeau.id: identifiant du cadeau.name: nom du cadeau.partnerId: identifiant du partenaire.partnerName: nom du partenaire.series: série ou campagne de cadeaux.startDate: date de début du cadeau.state: état actuel du cadeau.type: type ou catégorie de cadeau.
referralsRécompenses de référence gagnées par le membre. Chaque élément de tableau contient :
endDate: date de fin du parrainage.id: identifiant de référence.name: nom de la récompense de référence.recipient: identifiant ou nom de la personne à laquelle il est fait référence.series: série de recommandations ou campagne.startDate: date de début de la référence.state: état de référence actuel.
Étapes suivantes next-steps
Utilisez les ressources suivantes lors de l’implémentation de schémas de profil de fidélité.
- Ajoutez ce groupe de champs à un schéma Profil individuel XDM à l’aide du guide Groupe de champs de l’éditeur de schémas avant d’ingérer des données de profil de fidélité.
- Utilisez l’exemple renseigné dans le référentiel XDM pour valider les mappages de payload de fidélité.
- Consultez le schéma complet pour connaître les contraintes de type de données et les définitions de champ requises.