ロイヤルティの詳細 スキーマフィールドグループ
ロイヤルティの詳細は、XDM個人プロファイル クラス の標準スキーマフィールドグループです。 ロイヤルティ ID、ポイント残高、階層の割り当て、報酬、課題、カードの詳細など、顧客のロイヤルティプログラムのメンバーシップ状態をモデル化する、単一のオブジェクトタイプのフィールド loyaltyを提供します。
このページは、XDM個人プロファイルと スキーマフィールドグループ に精通しているスキーマデザイナーおよびデータエンジニア向けです。 このページを読み終えると、ロイヤルティプロファイルデータを正しいloyalty フィールドパスにマッピングできます。
このフィールドグループを使用するタイミング when-to-use
次のすべての条件が適用される場合は、このフィールドグループを使用します。
- スキーマクラスはXDM Individual Profileで、ロイヤルティプログラムメンバーの現在の状態を表します。
- このスキーマは、永続的なロイヤルティ属性をリアルタイム顧客プロファイルに保存します。
- ダウンストリームのユースケースでは、セグメンテーションやパーソナライゼーションにロイヤルティメンバーシップの状態が必要です。
ポイント獲得、チャレンジ完了、階層変更イベントなど、イベントベースのロイヤルティアクティビティにXDM ExperienceEvent スキーマを使用します。
フィールドグループ構造 structure
loyalty オブジェクトには、次のプロパティが含まれています。
adjustedPointsexpiredPointsjoinDatelifetimePointslifetimePurchasesloyaltyIDnextTierpointspointsExpiration有効期限が切れる予定のロイヤルティポイント（ロイヤルティポイントのグループ）を一覧表示します。 各配列項目には、次のものが含まれます。
pointsExpirationDate: ポイントの有効期限が切れる日時。pointsExpiring：関連する日付に有効期限が切れるポイントの数。
pointsRedeemedpointsToNextTierprogrampromisedPointsreturnedPointsstatusactive、disabled、またはsuspendedなど）。tiertierExpiryDatetierUpgradeDateupgradeDatetierUpgradeDateを使用してください。 upgradeDateを参照する既存のスキーマとソースマッピングを更新して、tierUpgradeDateを使用します。次の例は、ネストされた構造の代表値を持つloyalty オブジェクトを示しています。 完全な有効なペイロードについては、XDM リポジトリのpopulated exampleを参照してください。
{
"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は、メンバーに関連付けられたロイヤルティカードに関する情報をキャプチャするオブジェクトの配列です。
numberseriesstatusactive、inactive、suspendedなど）。challenges challenges
challengesは、チャレンジの進捗状況や関連タスクなど、メンバーに関連するロイヤルティの課題をキャプチャするオブジェクトの配列です。
descriptionendDatefrequencyTypeidnameseriesstartDatestateactive、completed、expiredなど）。tasksロイヤルティチャレンジに関連するタスクを一覧表示します。 各配列項目には、次のものが含まれます。
endDate: タスクの終了日時。entity: タスクに関連付けられているエンティティ。goal: タスクのターゲット値。name: タスク名。progress: タスク目標に向けた現在の進行状況。startDate: タスクの開始日時。state：現在のタスク状態。type: タスクの種類またはカテゴリ。
rewards rewards
rewards オブジェクトは、ロイヤルティプログラムに関連する報酬をキャプチャします。
badgesメンバーが獲得した達成バッジ。 各配列項目には、次のものが含まれます。
id: バッジ ID。name: バッジ名。series: バッジシリーズまたはコレクション。startDate: バッジがアクティブになった日時。endDate: バッジの有効期限が切れる日時。state：現在のバッジ状態。
coupons会員限定のロイヤルティクーポン。 各配列項目には、次のものが含まれます。
discountValue：金銭的割引の値。endDate: クーポンの有効期限id: クーポン ID。name: クーポン名。redemptionCount: クーポンが利用された回数。redemptionLimit: クーポン引き換えの最大数。series: クーポンシリーズまたはキャンペーン。startDate: クーポンが有効になる日時。state：現在のクーポン状態。storeName：関連付けられたストアの名前。
giveaways会員に関連するプレゼント特典プロモーション。 各配列項目には、次のものが含まれます。
endDate：ギブアウェイ終了日。id：プレゼント識別子。name：プレゼント名。partnerId: パートナーID。partnerName: パートナー名。series：景品シリーズまたはキャンペーン。startDate：プレゼントの開始日。state：現在のプレゼントの状態。type：プレゼントの種類またはカテゴリ。
referrals会員が獲得したリファラル報酬。 各配列項目には、次のものが含まれます。
endDate：参照終了日。id：参照識別子。name：参照報酬の名前。recipient：参照されたユーザーの識別子または名前。series：紹介シリーズまたはキャンペーン。startDate：参照開始日。state：現在の参照状態。
次の手順 next-steps
ロイヤルティプロファイルスキーマを実装する際には、次のリソースを使用します。
- ロイヤルティプロファイルデータを取り込む前に、 スキーマエディターフィールドグループガイド を使用して、このフィールドグループをXDM個人プロファイルスキーマに追加します。
- XDM リポジトリのpopulated exampleを使用して、ロイヤルティペイロードマッピングを検証します。
- データタイプの制約と必須フィールド定義については、完全スキーマ を参照してください。