ロイヤルティ稼ぎのAPI配信
ロイヤルティアーンがあれば、お客様のプログラムロイヤルティRewards。また、保留中のポイントや付与されたポイントをup-to-dateで確認したり、プログラムの傾向を分析したり、関係者向けのレポートを作成したりすることもできます。
配送オプション
弊社のロイヤルティEarnオファーでは、プルメカニズムを介してデータを取得することができ、サポートに詳細な旅程データを提供します：
- データ分析
- お客様へのポイント付与
- ヘルプデスク調査
このサービスは、HTTP GET の2つのエンドポイントで構成されています：
- データの最終更新日をご確認ください。ロイヤルティポイントは毎日更新されます。
transaction_date_start、transaction_date_end、and membership_id、itinerary_idの変数を使用して、指定した時間範囲内で保留または報奨された ロイヤルティ 通貨のリストを作成します。
認証プロセスの詳細については、API setupを参照してください。
利用可能なフィールド
以下の表に、プッシュとプルの配信方法を通じて利用可能なフィールド (ネストされたオブジェクトを含む) の一覧を示します。
| フィールド名 | 定義 | 例 |
|---|---|---|
itinerary_id | 旅程番号または POS 注文参照番号。 | 72622069245694 |
transaction_type | 記録された取引の種類。 | 指定可能な値 : 購入 受賞 変更 CANCEL |
transaction_date* | 予約が最後に変更された日付です。これは、予約が一度も更新されなかった場合のbook date と同じです。ISO 8601の日付フォーマット (YYYY-MM-DD). | 2023-02-05 |
transaction_datetime* | 予約が最後に変更された日時です。更新が行われていない場合、この値は book_date. | 2023-10-21T00:00:00.000Z |
booking_item | 個々の予約要素を表すオブジェクト。ネストされた項目については、booking_item の表を参照してください。 | — |
package_indicator | 予約項目がパッケージの一部であるかどうか（フライト+ホテルなど）。 | 指定可能な値 : パッケージの一部 宿泊単体 不明 |
currency_code | 標準的な国際銀行口座番号（IBAN）の通貨コード形式で表された予約の支払通貨。 | JPY |
gross_booking_value | グロス・ブッキング・バリュー（GBV）、つまり税金や手数料を含む予約総額を、支払いに使用される通貨で表示します。 | 694.89 |
base_price | 付与されるポイントの計算対象となる、税金、手数料、調整額が適用される前のお客様への請求額。支払いに使用される通貨で表示されます。 | 154.78 |
award_date* | ポイントが付与される日付。ISO 8601の日付形式(YYYY-MM-DD). | 2023-03-14 |
point_definition | プログラムの基本収益モデルを変更するキャンペーンやプロモーションの指標。 | Partner_2X_promo |
pending_points | 獲得したがまだ授与されていないポイント数。 | 内訳 合計：-100.11 ベース-90.01 ボーナス：-10.1 |
awarded_points | トランザクションのポイント数 | 内訳 合計：100.11 ベース90.01 ボーナス：10.1 |
program_name | ロイヤルティ プログラムの名称。 | Rewards |
member | 顧客情報を表すオブジェクト。ネストされた項目については、member の表を参照してください。 |
全フィールドの注意事項
* 日付フィールドは太平洋標準時(PST)で、サマータイムを考慮しています。
** 個人を特定できる情報（PII）データ。会社のガイドラインに従って正しく処理し、絶対に必要な場合のみ記載するようにしてください。
API の詳細
このページでエンドポイントの定義を調べてから、API テストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。