Dettagli fedeltà gruppo di campi schema
Dettagli fedeltà è un gruppo di campi dello schema standard per la classe Profilo individuale XDM. Fornisce un singolo campo di tipo oggetto, loyalty, che modella lo stato di iscrizione al programma fedeltà di un cliente, inclusi ID fedeltà, saldi a punti, assegnazioni di livello, premi, sfide e dettagli della carta.
Questa pagina è destinata ai designer di schemi e ai data engineer che hanno familiarità con il profilo individuale XDM e con gruppi di campi di schema. Dopo aver letto questa pagina, puoi mappare i dati del profilo fedeltà sui percorsi dei campi loyalty corretti.
Quando utilizzare questo gruppo di campi when-to-use
Utilizzare questo gruppo di campi quando si applicano tutte le condizioni seguenti.
- La classe dello schema è Profilo individuale XDM e rappresenta lo stato corrente di un membro del programma fedeltà.
- Lo schema memorizza gli attributi di fedeltà persistenti in Real-Time Customer Profile.
- I casi di utilizzo a valle richiedono lo stato di iscrizione alla fidelizzazione per la segmentazione o la personalizzazione.
Utilizza gli schemi XDM ExperienceEvent per l’attività fedeltà basata su eventi, ad esempio l’accantonamento di punti, il completamento di una sfida o eventi di modifica a livello.
Struttura del gruppo di campi structure
L’oggetto loyalty contiene le proprietà seguenti.
adjustedPointscardsDetailschallengesexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationElenca i punti fedeltà, o gruppi di punti fedeltà, con scadenza programmata. Ogni elemento array contiene:
pointsExpirationDate: data e ora di scadenza dei punti.pointsExpiring: numero di punti in scadenza alla data associata.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled o suspended.tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate. Aggiornare gli schemi e i mapping di origine esistenti che fanno riferimento a upgradeDate per utilizzare tierUpgradeDate.Nell’esempio seguente viene illustrato l’oggetto loyalty con valori rappresentativi per le strutture nidificate. Per un payload valido completo, vedi l’esempio popolato nell’archivio 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 è un array di oggetti che acquisisce informazioni sulle carte fedeltà associate al membro.
numberseriesstatusactive, inactive o suspended.challenges challenges
challenges è un array di oggetti che acquisisce le sfide di fidelizzazione associate al membro, inclusi l’avanzamento della sfida e le attività correlate.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed o expired.tasksElenca le attività associate alla sfida fedeltà. Ogni elemento array contiene:
endDate: data e ora di fine dell’attività.entity: entità associata all’attività.goal: valore di destinazione per l’attività.name: nome attività.progress: avanzamento corrente verso l’obiettivo dell’attività.startDate: data e ora di inizio dell’attività.state: stato attività corrente.type: tipo di attività o categoria.
rewards rewards
L’oggetto rewards acquisisce i premi associati al programma fedeltà.
badgesBadge di raggiungimento ottenuti dal membro. Ogni elemento array contiene:
id: identificatore badge.name: nome badge.series: serie o raccolta di badge.startDate: data e ora in cui il badge è diventato attivo.endDate: data e ora di scadenza del badge.state: stato del badge corrente.
couponsCoupon fedeltà disponibili per il membro. Ogni elemento array contiene:
discountValue: valore sconto monetario.endDate: data di scadenza coupon.id: identificatore coupon.name: nome coupon.redemptionCount: numero di volte in cui il coupon è stato riscattato.redemptionLimit: numero massimo di rimborsi coupon.series: serie coupon o campagna.startDate: data e ora di validità del coupon.state: stato coupon corrente.storeName: nome dell’archivio associato.
giveawaysOfferte promozionali associate al membro. Ogni elemento array contiene:
endDate: data di fine del regalo.id: Identificatore Giveaway.name: nome regalo.partnerId: Identificatore partner.partnerName: nome partner.series: serie o campagna Giveaway.startDate: data di inizio del regalo.state: stato giveaway corrente.type: tipo o categoria di donazione.
referralsPremi di riferimento ottenuti dal membro. Ogni elemento array contiene:
endDate: data di fine riferimento.id: identificatore di riferimento.name: nome premio di riferimento.recipient: identificatore o nome della persona a cui si fa riferimento.series: serie o campagna di riferimento.startDate: data di inizio riferimento.state: stato di riferimento corrente.
Passaggi successivi next-steps
Utilizza le risorse seguenti per implementare schemi di profili fedeltà.
- Aggiungi questo gruppo di campi a uno schema XDM per profilo individuale utilizzando la guida per il gruppo di campi dell’editor di schemi prima di acquisire i dati del profilo fedeltà.
- Utilizza l’esempio popolato nel repository XDM per convalidare i mapping del payload fedeltà.
- Consulta lo schema completo per i vincoli del tipo di dati e le definizioni dei campi obbligatori.