忠誠度賺取 API 交付
透過 Loyalty Earn，您可以將客戶的忠誠度 Rewards 與您的計劃相協調。您還可以使用資料提供待定和已授予積分的 up-to-date 視圖、分析計劃趨勢並為您的利害關係人建立報告。
送貨選項
我們的忠誠度賺取服務可讓您透過拉取機制檢索數據，該機制提供詳細的行程數據以支援：
- 數據分析
- 為顧客獎勵積分
- 服務台調查
此服務由兩個 HTTP GET端點組成，讓您：
- 查看資料最後更新的時間。忠誠度積分每天更新。
- 使用
transaction_date_start、transaction_date_end、and membership_id或itinerary_id變數建立指定時間範圍內待定或獎勵的忠誠度貨幣列表
有關身份驗證過程的詳細信息，請參閱API 設定。
可用欄位
下表列出我們推播和提取交付方法所提供的欄位，包括所有嵌入物件。
| 欄位名稱 | 定義 | 範例 |
|---|---|---|
itinerary_id | 行程編號或銷售點訂單參考編號。 | 72622069245694 |
transaction_type | 已記錄交易的類型。 | 可能的值： 購買 獎 修改 取消 |
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) 貨幣代碼格式表示。 | USD |
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 | 會員計畫的名稱。 | 獎勵 |
member | 代表客戶資訊的對象。請參閱 member表以了解嵌套項。 |
所有字段的註釋
* 日期欄位採用太平洋標準時間 (PST)，以節省夏令時。
** 個人識別資訊 (PII) 資料。請務必按照公司的指導方針正確處理此事，並且僅在絕對必要時才包含。
API 詳細資料
在此頁面探索端點的定義，然後使用 API 測試軟體，了解範例和結構描述定義與實際輸出的比較。