簡介

善用全新的商品化 API，更輕鬆地識別優惠活動，並從機器學習技術中獲益

運用機器學習技術，從 Expedia Group's 龐大的全球促銷庫存中，協助您為旅客識別最相關的優惠與折扣。透過使用商品化 API，您可存取各類活動內容與優惠數據，藉此打造成功的 year-long 策略及 traveler-facing 體驗，例如促銷電子郵件、App 小工具、網站橫幅廣告及輪播體驗。

我們亦在合作夥伴入口網站新增了 App 標籤，您可運用此標籤制定商品策略，並規劃、執行及追蹤行銷活動。此 App 位於名為「入口行銷中心」的新區塊中。請聯絡您的客戶經理以獲取更多資訊。

活動內容終端點

提供即將推出的活動詳情，包括活動編號、預訂及住宿起訖日期，以及參與的物業數量。
可直接存取 Expedia-curated 活動素材，例如活動主題圖片、目的地影像、建議文案等。
接收有關限時優惠 (LTO) 活動的資訊，這些活動的預訂窗口期在未來六個月內，同時也包含全年皆可參與的常青活動。

您可以使用活動內容端點，透過下列請求參數搜尋即將推出的活動：

可預訂日期範圍
停留日期範圍
在最低折扣值或以上
LTO 與常青方案之比較

對於預訂窗口超過六個月的長期預訂活動，以下欄位將被排除：

訂房和住宿日期
最低與最高折扣百分比

其他細節

活動內容端點可協助您運用 Expedia-curated 資產，打造 traveler-facing 促銷體驗，例如促銷電子郵件、App 小工具、網站橫幅等。

您可透過活動內容回應中的「property_count」欄位，來判斷活動內提供優惠的屬性數量上限 (up-to-date)。我們建議您在活動預訂開始日期前查閱property_count，因為旅宿參與商品化活動的情況具有動態性，且隨著活動啟動日臨近，各物業的參與度往往會達到最完整且可靠的狀態。

合作夥伴須對其使用新版商品展示 API 或購物 API 建置於自身網站上的行銷活動與訊息傳遞承擔責任，並確保所有相關行銷活動與訊息傳遞均符合適用之法律法規。

促銷活動端點

提供與特定活動相關的所有可用優惠與折扣。
具備透過多種請求參數搜尋與篩選交易的能力，包括可針對特定活動或跨多個活動請求交易。
up-to-date, 讓您能持續發掘最具吸引力的旅宿優惠，打造 high-converting 推廣活動。

您可以使用促銷活動端點，透過請求參數輕鬆篩選和搜尋優惠，例如：

活動識別碼及/或旅宿識別碼
可預訂日期範圍
停留日期範圍
達到或超過最低評分、最低星級評分及／或最低折扣的數值
限時商品與常青商品的區別
Member-only 以及 mobile-only 交易標記
超級區域或特定目的地
機器學習相關性評分排序順序

以下詳細資訊將包含在促銷活動 API 回應中：

交易 ID、對應活動 ID 及旅宿 ID
可預訂日期範圍、入住日期範圍、限制日期及提前購買時段
限時性與常青性的區別
機器 learning-powered 為您的企業量身打造的相關性評分，適用於回應中返回的交易、物業及目的地
特定目的地與鏈結識別碼資訊
將現有 Rapid 旅宿內容 API 的代幣化連結用於提取 property-level 影像，以在您的商品陳列體驗中呈現

其他細節

您可輕鬆搜尋並篩選促銷活動回應，以獲取更精準的優惠方案，從而完全掌控向旅客呈現的優惠內容。您亦可精選這些優惠來打造專屬活動主題，無需使用 Expedia-defined 活動及其相關素材。

若您想針對特定預訂時段搜尋優惠，可同時傳遞「預訂開始日期」（bookable_start）與「預訂結束日期」（bookable_end）的數值。例如，在「bookable_start」欄位輸入 2025-10-15 (2025 年 10 月 15 日)，並在「bookable_end」欄位輸入 2025-10-30 (2025 年 10 月 30 日)，您將獲得所有可於 10 月 15 日至 10 月 30 日期間 (含首尾兩日) 預訂的優惠方案。然而，若您希望查看更廣泛的優惠方案，可使用bookable_start 或bookable_end 進行查詢。

例如：

在「bookable_start」欄位中輸入日期 2025-10-15 (2025 年 10 月 15 日)，您將收到所有可於 10 月 15 日及之後預訂的優惠方案。這將提供更廣泛的優惠方案。
僅在bookable_end 欄位中輸入 2025-10-30 (2025 年 10 月 30 日)，您將收到所有可於 10 月 30 日及之前預訂的優惠方案。這將再次提供更龐大的交易組合。

優惠活動上線 (i.e. 可供預訂) 將依據旅宿的時區進行。因此，若某項優惠於 3 月 21 日在澳洲雪梨啟動，針對旅宿的優惠將於雪梨時間凌晨 12:01 起，開放全球所有合作夥伴進行預訂。

您可以在促銷活動端點上使用include 請求參數，自訂您所接收回應的大小。因此，若您僅需返回特定欄位，而非接收所有回應欄位，可將這些特定欄位名稱加入include 參數中。

您可提前向促銷 API 發送請求，但為確保獲取最精準且符合 up-to 的房源優惠日期資訊，建議盡可能在活動可預訂開始日當天提交請求。這是因為隨著活動啟動日期的臨近，物業參與的完整度與可靠性往往達到最高。

我們也建議您在活動開始後數日再申請促銷，如此便能持續取得最新更新的優惠清單。此外，我們建議您每日調用促銷活動 API，以獲取由各物業提供的最新更新優惠清單。

若您有興趣建立 destination-based 商品推廣活動，可透過 Rapid Geography API 中的相關region_id，發送 region-specific 促銷 API 請求。促銷端點僅接受以下區域類型：city。其他區域類型 (例如：multi_city_vicinity、point_of_interest、neighbourhood 等) 將返回空白回應。

機器學習推薦

促銷活動回應中提供的機器 learning-powered 相關性評分是針對每個組織獨一無二的，因此您收到的評分/排名將與他人所獲結果不同。您可運用機器學習推薦功能，識別最適合在商品推廣活動中宣傳的優惠方案、房產及旅遊目的地。Higher-scoring 優惠方案、房產與目的地將有機會提升您獨特旅客群體的轉化率。

目前，您將收到每個廣告活動中排名前一萬筆交易的相關性評分。在我們的測試中，我們發現此評分在超過首 10,000 筆交易後，其價值與影響力便變得微不足道。

根據您的使用情境，可透過設定參數sort_by 來定義促銷活動回應的排序順序。您可選擇依交易項目、旅宿編號，或由我們的機器學習模型判定之目的地相關性進行排序，藉此在旅客能見度與預訂量兩方面，最大化商品化策略的效益。

若您通過sort_by = promotion 驗證，將根據我們的專有機器學習演算法，獲得所有交易結果的排名結果 high-to-low (1 至 10,000 名次)。您可以使用此排序功能，獲取模型預測轉換率最高的頂尖推薦優惠。
若您通過sort_by = property 驗證，將依據我們專有的機器學習演算法，獲取所有從 high-to-low 排序的房產交易結果。
若您通過sort_by = destination 連結進行預訂，您將根據我們專有的機器學習演算法，收到所有目的地行程結果的排序資訊，該演算法會將行程依 high-to-low 的順序排列。

註：機器學習推薦功能亦可在 Portal Marketing Hub 上使用。請聯絡您的帳戶經理以獲取更多詳情。

購物可用性 API 的變更

若需獲取最新庫存狀態、即時定價、退款政策、佣金資訊等詳情，請向 Rapid 的購物庫存 API 發出標準查詢請求：為支援商品銷售流程並使您能順暢整合商品銷售 API，我們已對購物 API 進行以下調整：

使用 Rapid Shopping Availability 端點中新增的deal 篩選器，僅接收包含有效促銷活動的費率。這使您能夠靈活地建立以商品陳列為核心的購物請求，並確保所有返回的費率都具備「deal」屬性。
Rapid 的購物可用性端點現已新增名為Campaign-Id 的請求標頭，供您標示當前發起的購物可用性 API 呼叫並非常規請求，而是源於您的商品促銷活動 (換言之，此標頭將表明該購物可用性 API 請求是在旅客因促銷活動進入購物體驗時觸發的)。我們僅接受每次購物 API 呼叫中傳入一個活動 ID。此活動識別碼將協助我們追蹤您的活動成效，並為您設計更優質的機器學習模型與 API 功能強化方案。
若您想在 Portal Marketing Hub 上查看您的廣告活動成效，則需在購物 API 呼叫中傳遞廣告活動 ID 參數。如有任何疑問，請聯繫您的客戶經理。

註：您可透過購物庫存 API 每次查詢最多 250 項屬性的詳細資訊。

範例回應

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

註：商品資訊 API 響應中提供的id 與description，與購物 API 響應中返回的資訊有所不同。我們強烈建議您使用商品管理 API 回傳的id 及description。

建議的最低折扣金額不包含稅金與手續費。您有責任確保擬宣傳的折扣符合相關價格廣告法規。

API 詳細資料

請參閱本頁的 merchandising-related 端點定義，接著使用 API Explorer 或其他測試軟體，以了解範例與架構定義如何與實際輸出結果相互對照。

其他資源

無論您是想嘗試所有 Rapid API 端點，還是下載其 OpenAPI 規格或我們的 Postman Collection，我們都可協助您完成。