Loyalty Details schemaveldgroep
Loyalty Details is een standaardgroep van het schemagebied voor de XDM Individual Profile klasse . Het verstrekt één enkel voorwerp-type gebied, loyalty, dat de staat van het de programmalidmaatschap van een klant van de loyaliteit, met inbegrip van loyaliteit IDs, puntsaldi, rijtaken, beloningen, uitdagingen, en kaartdetails modelleert.
Deze pagina is voor schemaontwerpers en gegevensingenieurs vertrouwd met het Individuele Profiel XDM en groepen van het schemagebied . Nadat u deze pagina hebt gelezen, kunt u de gegevens van het loyaliteitsprofiel toewijzen aan de juiste loyalty -veldpaden.
Wanneer gebruikt u deze veldgroep when-to-use
Gebruik deze veldgroep wanneer alle volgende voorwaarden van toepassing zijn.
- De schemaklasse is Individueel Profiel XDM en vertegenwoordigt de huidige staat van een van het loyaliteitsprogramma lid.
- Het schema slaat blijvende loyaliteitsattributen in het Profiel van de Klant in real time op.
- De downstreamgebruiksgevallen vereisen de status van het loyaliteitslidmaatschap voor segmentatie of personalisatie.
Gebruik XDM ExperienceEvent -schema’s voor op gebeurtenissen gebaseerde loyaliteitsactiviteiten, zoals punten die oplopen, problemen oplossen of gebeurtenissen voor wijzigingen in lagen wijzigen.
Groepsstructuur van veld structure
Het loyalty -object bevat de volgende eigenschappen.
adjustedPointscardsDetailschallengesexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationLijsten loyaliteitspunten, of groepen loyaliteitspunten, die gepland zijn te verlopen. Elk arrayitem bevat:
pointsExpirationDate: De datum en tijd waarop de punten verlopen.pointsExpiring: Het aantal punten dat op de bijbehorende datum vervalt.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled of suspended .tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate . Werk bestaande schema’s en brontoewijzingen bij die naar upgradeDate verwijzen om tierUpgradeDate te gebruiken.In het volgende voorbeeld wordt het object loyalty getoond met representatieve waarden voor de geneste structuren. Zie het bevolkte voorbeeld in de bewaarplaats XDM voor een volledige geldige nuttige lading.
{
"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 is een array met objecten die informatie vastlegt over aan het lid gekoppelde linecards.
numberseriesstatusactive, inactive of suspended .challenges challenges
challenges is een array van objecten die loyaliteitsproblemen vastleggen die aan het lid zijn gekoppeld, waaronder het uitvoeren van taken en vorderingen en verwante taken.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed of expired .tasksMaakt een lijst van taken verbonden aan de loyaliteitsuitdaging. Elk arrayitem bevat:
endDate: De einddatum en -tijd van de taak.entity: De entiteit die aan de taak is gekoppeld.goal: De doelwaarde voor de taak.name: De taaknaam.progress: Huidige vooruitgang in de richting van het taakdoel.startDate: De begindatum en -tijd van de taak.state: Huidige taakstatus.type: Taaktype of -categorie.
rewards rewards
Met het rewards -object worden beloningen vastgelegd die aan het loyaliteitsprogramma zijn gekoppeld.
badgesAankoopbadges verdiend door het lid. Elk arrayitem bevat:
id: Badge-id.name: Naam badge.series: Badge-serie of -verzameling.startDate: Datum en tijdstip waarop de badge actief werd.endDate: Datum en tijdstip waarop de badge verloopt.state: Huidige status badge.
couponsLoyalty-coupons beschikbaar voor het lid. Elk arrayitem bevat:
discountValue: Waarde van monetaire korting.endDate: Vervaldatum coupon.id: Couponid.name: Couponnaam.redemptionCount: Aantal keren dat de coupon is afgelost.redemptionLimit: Maximumaantal couponaflossingen.series: Couponserie of -campagne.startDate: Datum en tijdstip waarop de coupon geldig wordt.state: Huidige status van coupon.storeName: Naam van de bijbehorende opslag.
giveawaysAfgeven van promoties voor het lid. Elk arrayitem bevat:
endDate: Einddatum weggeven.id: Identificatiecode weggeven.name: Naam weggeven.partnerId: Partner-id.partnerName: Partner name.series: Geef serie of campagne weg.startDate: Begindatum weggeven.state: Huidige status van weggeven.type: Afgeven, type of categorie.
referralsVerwijzingsbeloningen van het lid. Elk arrayitem bevat:
endDate: Einddatum verwijzing.id: Referral-id.name: Referral-bonusnaam.recipient: Identificatiecode of naam van de betrokken persoon.series: Referral-serie of -campagne.startDate: Begindatum verwijzing.state: Huidige verwijzingsstaat.
Volgende stappen next-steps
Gebruik de volgende middelen wanneer het uitvoeren van de schema’s van het loyaliteitsprofiel.
- Voeg deze gebiedsgroep aan een XDM Individueel schema van het Profiel toe gebruikend de gids van de het gebiedsgroep van de Redacteur van het Schema alvorens de gegevens van het loyaliteitsprofiel op te nemen.
- Gebruik het bevolkte voorbeeld in de bewaarplaats XDM om loyaliteits ladingstoewijzingen te bevestigen.
- Raadpleeg het volledige schema voor gegevenstype beperkingen en vereiste gebiedsdefinities.