Treuedetails Schemafeldgruppe
Treuedetails ist eine Standardschemafeldgruppe für die Klasse XDM Individual Profile . Sie enthält das Feld loyalty mit einem einzigen Objekttyp, das den Mitgliedschaftsstatus eines Kunden im Treueprogramm modelliert, einschließlich Treueprogramm-IDs, Punktesalden, Stufenzuweisungen, Belohnungen, Herausforderungen und Kartendetails.
Diese Seite richtet sich an Schema-Designer und Dateningenieure, die mit individuellen XDM-Profilen und (SchemaFeldergruppen) vertraut . Nach dem Lesen dieser Seite können Sie Treueprogramm-Profildaten den richtigen loyalty-Feldpfaden zuordnen.
Verwendung dieser Feldergruppe when-to-use
Verwenden Sie diese Feldergruppe, wenn alle folgenden Bedingungen zutreffen.
- Die Schemaklasse ist „XDM Individual Profile“ und stellt den aktuellen Status eines Mitglieds des Treueprogramms dar.
- Das Schema speichert persistente Treueprogramm-Attribute im Echtzeit-Kundenprofil.
- Nachgelagerte Anwendungsfälle erfordern einen Treueprogramm-Mitgliedschaftsstatus für die Segmentierung oder Personalisierung.
Verwenden Sie XDM ExperienceEvent-Schemata für ereignisbasierte Treueaktivität wie Punktezuwachs, Challenge-Abschlüsse oder Stufenänderungsereignisse.
Feldgruppenstruktur structure
Das loyalty-Objekt enthält die folgenden Eigenschaften.
adjustedPointscardsDetailschallengesexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpirationListet Treuepunkte oder Gruppen von Treuepunkten auf, deren Gültigkeit geplant ist. Jedes Array-Element enthält:
pointsExpirationDate: Datum und Uhrzeit des Ablaufs der Punkte.pointsExpiring: Die Anzahl der Punkte, die am zugehörigen Datum ablaufen.
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsrewardsstatusactive, disabled oder suspended.tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDate . Aktualisieren Sie vorhandene Schemata und Quellzuordnungen, die auf upgradeDate verweisen, um tierUpgradeDate zu verwenden.Das folgende Beispiel zeigt das loyalty-Objekt mit repräsentativen Werten für die verschachtelten Strukturen. Eine vollständige gültige Payload finden Sie „ausgefülltes " im XDM-Repository.
{
"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 ist ein Array von Objekten, das Informationen über die mit dem Mitglied verknüpften Treuekarten erfasst.
numberseriesstatusactive, inactive oder suspended.challenges challenges
challenges ist ein Array von Objekten, in dem die mit dem Mitglied verbundenen Herausforderungen im Zusammenhang mit der Treue erfasst werden, einschließlich des Challenge-Fortschritts und der damit verbundenen Aufgaben.
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive, completed oder expired.tasksFührt Aufgaben im Zusammenhang mit der Herausforderung „Treue“ auf. Jedes Array-Element enthält:
endDate: Enddatum und -zeit der Aufgabe.entity: Die der Aufgabe zugeordnete Entität.goal: Der Zielwert für die Aufgabe.name: Der Aufgabenname.progress: Aktueller Fortschritt beim Aufgabenziel.startDate: Startdatum und -zeit der Aufgabe.state: Aktueller Aufgabenstatus.type: Aufgabentyp oder -kategorie.
rewards rewards
Das rewards erfasst die mit dem Treueprogramm verbundenen Belohnungen.
badgesVom Mitglied verdiente Leistungsabzeichen. Jedes Array-Element enthält:
id: Kennung des Abzeichens.name: Name des Abzeichens.series: Abzeichenserie oder -kollektion.startDate: Datum und Uhrzeit, zu der das Abzeichen aktiv wurde.endDate: Datum und Uhrzeit, zu der das Abzeichen abläuft.state: Aktueller Abzeichenstatus.
couponsDem Mitglied zur Verfügung stehende Treuecoupons. Jedes Array-Element enthält:
discountValue: Geldmäßiger Abzinsungswert.endDate: Ablaufdatum des Coupons.id: Coupon-Kennung.name: Couponname.redemptionCount: Gibt an, wie oft der Coupon eingelöst wurde.redemptionLimit: Maximale Anzahl an Couponeinlösungen.series: Couponserie oder Kampagne.startDate: Datum und Uhrzeit, zu der der Coupon gültig wird.state: Aktueller Couponstatus.storeName: Name des zugehörigen Stores.
giveawaysWerbegeschenke, die mit dem Mitglied verbunden sind. Jedes Array-Element enthält:
endDate: Enddatum des Werbegeschenks.id: Giveaway-Kennung.name: Name des Werbegeschenks.partnerId: Partner-ID.partnerName: Partnername.series: Giveaway-Serie oder -Kampagne.startDate: Startdatum des Werbegeschenks.state: Aktueller Status des Werbegeschenks.type: Giveaway-Typ oder -Kategorie.
referralsVom Mitglied verdiente Empfehlungsprämien. Jedes Array-Element enthält:
endDate: Enddatum der Empfehlung.id: Empfehlungskennung.name: Name der Empfehlungsbelohnung.recipient: Kennung oder Name der referenzierten Person.series: Empfehlungsreihe oder Kampagne.startDate: Startdatum der Empfehlung.state: Aktueller Empfehlungsstatus.
Nächste Schritte next-steps
Verwenden Sie die folgenden Ressourcen bei der Implementierung von Treueprofilschemata.
- Fügen Sie diese Feldergruppe mithilfe des Feldergruppen-Handbuchs für den -Editor einem Schema für ein individuelles XDM-Profil , bevor Sie Treueprogramm-Profildaten aufnehmen.
- Verwenden Sie das ausgefüllte Beispiel im XDM-Repository, um Treue-Payload-Zuordnungen zu validieren.
- Im vollständigen Schema finden Sie Einschränkungen für Datentypen und erforderliche Felddefinitionen.