Detalhes de fidelidade grupo de campos de esquema
Detalhes de fidelidade é um grupo de campos de esquema padrão para a classe do Perfil Individual XDM. Ele fornece um único campo de tipo de objeto, loyalty, que modela o estado de associação de um programa de fidelidade do cliente, incluindo IDs de fidelidade, saldos de pontos, atribuições de camada, recompensas, desafios e detalhes do cartão.
Esta página é para designers de esquemas e engenheiros de dados familiarizados com o Perfil individual XDM e grupos de campos de esquema. Depois de ler esta página, você pode mapear os dados do perfil de fidelidade para os caminhos de campo loyalty corretos.
Quando usar este grupo de campos when-to-use
Use este grupo de campos quando todas as condições a seguir se aplicarem.
- A classe de esquema é Perfil Individual XDM e representa o estado atual de um membro do programa de fidelidade.
- O esquema armazena atributos de fidelidade persistentes no Perfil do cliente em tempo real.
- Casos de uso de downstream exigem o estado de associação de fidelidade para segmentação ou personalização.
Use esquemas XDM ExperienceEvent para atividades de fidelidade baseadas em eventos, como pontos acumulados, conclusões de desafio ou eventos de alteração de camada.
Estrutura do grupo de campos structure
O objeto loyalty contém as propriedades a seguir.
adjustedPointscardsDetailschallengesexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationLista pontos de fidelidade, ou grupos de pontos de fidelidade, que estão programados para expirar. Cada item de matriz contém:
pointsExpirationDate: a data e a hora em que os pontos expiram.pointsExpiring: o número de pontos expirando na data associada.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled ou suspended.tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate. Atualize esquemas existentes e mapeamentos de origem que fazem referência a upgradeDate para usar tierUpgradeDate.O exemplo a seguir mostra o objeto loyalty com valores representativos para as estruturas aninhadas. Consulte o exemplo preenchido no repositório XDM para obter uma carga 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 é uma matriz de objetos que captura informações sobre cartões de fidelidade associados ao membro.
numberseriesstatusactive, inactive ou suspended.challenges challenges
challenges é uma matriz de objetos que captura desafios de fidelidade associados ao membro, incluindo o progresso do desafio e tarefas relacionadas.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed ou expired.tasksLista tarefas associadas ao desafio de fidelidade. Cada item de matriz contém:
endDate: A data e hora de término da tarefa.entity: a entidade associada à tarefa.goal: o valor de destino da tarefa.name: O nome da tarefa.progress: Progresso atual em direção à meta da tarefa.startDate: A data e hora de início da tarefa.state: Estado atual da tarefa.type: Tipo ou categoria da tarefa.
rewards rewards
O objeto rewards captura recompensas associadas ao programa de fidelidade.
badgesMedalhas de conquista obtidas pelo membro. Cada item de matriz contém:
id: Identificador de selo.name: Nome da medalha.series: série ou coleção de selos.startDate: Data e hora em que a medalha se tornou ativa.endDate: Data e hora em que a medalha expira.state: Estado atual da medalha.
couponsCupons de fidelidade disponíveis para o membro. Cada item de matriz contém:
discountValue: Valor de desconto monetário.endDate: data de expiração do cupom.id: Identificador do cupom.name: Nome do cupom.redemptionCount: Número de vezes que o cupom foi resgatado.redemptionLimit: Número máximo de resgates de cupom.series: Série ou campanha de cupons.startDate: Data e hora em que o cupom se torna válido.state: Estado atual do cupom.storeName: Nome do armazenamento associado.
giveawaysPromoções de brinde associadas ao membro. Cada item de matriz contém:
endDate: Data de término do brinde.id: Identificador de brinde.name: Nome do brinde.partnerId: Identificador do parceiro.partnerName: Nome do parceiro.series: Série ou campanha de doações.startDate: Data de início do brinde.state: Estado atual do brinde.type: Tipo ou categoria de brinde.
referralsRecompensas de indicação obtidas pelo membro. Cada item de matriz contém:
endDate: Data final da referência.id: Identificador de referência.name: Nome da premiação de referência.recipient: Identificador ou nome da pessoa indicada.series: Série ou campanha de referência.startDate: Data de início da referência.state: Estado de referência atual.
Próximas etapas next-steps
Use os recursos a seguir ao implementar esquemas de perfil de fidelidade.
- Adicione este grupo de campos a um esquema de Perfil individual XDM usando o guia do grupo de campos do Editor de esquemas antes de assimilar dados do perfil de fidelidade.
- Use o exemplo preenchido no repositório XDM para validar os mapeamentos de conteúdo de fidelidade.
- Consulte o esquema completo para obter as restrições de tipo de dados e as definições de campo necessárias.