簡介

learning-powered 善用全新的商品推廣 API，更輕鬆地找出優惠活動，並透過機器學習推薦功能獲益

商品推廣 API 可讓您直接存取 Expedia-sourced 旅宿的折扣資訊、相關活動與素材，以及由機器學習驅動的個人化優惠、目的地及旅宿排行榜。利用 Merchandising API 來建置針對旅客或 agent-facing 的行銷體驗，例如促銷電子郵件、App 小工具、網站橫幅以及輪播體驗，並執行一套成功的 year-long 商品化策略。

您還可以在您的合作夥伴入口網站此帳戶讓您能瀏覽即將推出的行銷活動、匯出自訂的優惠清單、選擇要使用的行銷文案與圖片，並追蹤旅遊趨勢及行銷活動成效。如果您在入口網站中未看到「行銷」區塊，請提交一份支援單。

活動內容端點

活動內容端點會提供即將推出的活動詳情，包括活動 ID、預訂日期、入住起訖日期，以及參與的住宿點數量。您可直接存取「Expedia-curated」活動資源，例如活動主題圖片、目的地影像及建議文案，藉此打造「traveler-facing」或「agent-facing」的行銷體驗，包括促銷電子郵件、App 小工具以及網站橫幅。此外，您將收到關於限時優惠 (LTO) 活動的資訊，這些活動的預訂期限為未來六個月內；同時也會收到全年皆可參與的常青活動資訊。

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

可預訂日期範圍
住宿日期範圍
等於或高於最低折扣的金額
LTO 與常青方案的比較

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

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

其他詳情

您可以利用「活動內容」回應中的「property_count」欄位，來確定某個活動中提供優惠的屬性數量最多的是哪一個。up-to-date 我們建議您在活動預訂開始日期前，查閱property_count，因為旅宿參與商品推廣活動的情況會隨時變動，且隨著活動啟動日期的臨近，各物業的參與資訊通常會更加完整且可靠。

您可以透過活動內容回應中的 min_discount` ` 和 max_discount 欄位，來確認該活動中可提供的最低與最高折扣百分比。例如，若旅宿在該活動中提供的最高折扣為 60% 折，則 API 回應中的max_discount 值將為 60%；反之，若旅宿在該活動中提供的最低折扣為 4%，則min_discount 欄位的值將為 4%。

合作夥伴仍須負責其網站上透過 Merchandising API 或 Shopping API 建立之活動的行銷與訊息傳達，並確保所有此類行銷與訊息均符合適用之法律及法規。

促銷端點

您可以輕鬆搜尋並篩選「促銷」結果，以找到更符合目標的優惠，從而完全掌控向旅客展示哪些優惠。您也可以自行精選這些優惠，以此建立專屬的活動主題，而非使用「Expedia-defined」活動及其相關素材。

提供與特定活動相關的優惠與折扣。
能夠透過多種查詢參數搜尋和篩選交易，包括查詢特定活動或跨多個活動的交易。
up-to-date, 讓您隨時能挖掘出最具吸引力的旅宿優惠，用以打造 high-converting 行銷活動。

您可以使用「促銷」端點，透過以下請求參數輕鬆篩選和搜尋優惠：

活動 ID 及／或旅宿 ID
可預訂日期範圍
住宿日期範圍
達到或超過最低評論分數、最低星級評分及／或最低折扣的門檻
「限時」與「常青」的區別
Member-only 以及 mobile-only 的交易標記
大區域或特定目的地
機器學習相關性排序的排序順序

以下詳細資訊將包含在「促銷」API 的回應中：

促銷 ID、對應的活動 ID 以及旅宿 ID
可預訂日期範圍、住宿日期範圍、限制日期及預購時限
「限時」與「常青」的區別
針對回應中顯示的優惠、房產及目的地，系統會根據您的企業特性，生成專屬的「learning-powered」相關性排名
特定目的地與鏈 ID 資訊
這是現有 Rapid 旅宿內容 API 的代幣化連結，可用於擷取 property-level 的影像，並將其融入您的商品展示體驗中

其他詳情

若您想搜尋特定預訂時段的優惠，可以同時傳入 bookable_start` ` 和 bookable_end 的日期值。例如，在「bookable_start」欄位中輸入 2025-10-15 (2025 年 10 月 15 日)，並在「bookable_end」欄位中輸入 2025-10-30 (2025 年 10 月 30 日)，您將獲得所有在 2025 年 10 月 15 日至 10 月 30 日 (含) 期間可預訂的優惠。不過，如果您想查看更多優惠，可以使用bookable_start 或bookable_end date。例如：
- 在「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 優惠、房源和旅遊目的地，可能更有助於提升您獨特旅客群體的轉換率。

目前，您將收到每個活動中前 1 萬筆交易的相關性排名。在我們的測試中，我們發現當交易數量超過最初的 1 萬筆後，此排名的價值與影響便變得微乎其微。
根據您的使用情境，您可以使用 ``sort_by 參數來定義「促銷活動」回應的排序順序，選擇依據優惠方案、旅宿，或是由我們的機器學習模型所決定的目的地相關性進行排序，藉此在旅客的曝光率與預訂量方面，從商品推廣中獲得最大效益。
- 若傳入sort_by = promotion，您將收到所有交易結果，這些結果會根據我們的專有機器學習演算法進行排序 high-to-low (排名從 1 到 10,000)。您可以使用此排序功能，查看我們的模型預測轉化率較高的熱門推薦優惠。
- 若您傳入sort_by = property，您將收到根據我們專有的機器學習演算法，針對 high-to-low 所列房產所產生的所有交易結果。
- 若您傳入sort_by = destination，您將收到根據我們專有的機器學習演算法，針對 high-to-low 所列目的地所排序的所有優惠結果。

註：機器學習建議亦可在入口網站中的行銷專區。如需更多詳情，請聯絡您的客戶經理。

對「購物庫存」API 所做的變更

若要取得有關庫存狀況、即時價格、退款政策、佣金資訊等最新詳情，您應向 RapidShopping API 發出標準請求。我們已對購物 API 進行以下變更，以支援商品陳列流程，並讓您能盡可能順暢地整合商品陳列 API：

請使用 Rapid Shopping Availability 端點中新增的「deal」篩選器，僅接收包含有效促銷活動的價格。這讓您能夠靈活地建立一個專注於商品陳列的採購請求，並確保所有返回的報價都具備「deal」屬性。

注意：您一次最多可向「購物庫存 API」查詢 250 項商品的詳細資訊。

範例回應

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

注意： Merchandising API 回應中提供的id 和description 與 Shopping API 回應中返回的有所不同。我們強烈建議您使用 Merchandising API 所回傳的id 和description。

建議的最低折扣不包含稅金和其他費用。您有責任確保所宣傳的折扣遵守必要的價格廣告法。

啟動條件

合規責任

您須全權負責確保在執行行銷活動時，遵守所有適用的法律及行銷準則。

內容完整性

Expedia-provided 不得修改圖片。若您願意，可使用您自己的創意素材；然而，您須自行確保完全遵守所有適用的著作權及智慧財產權法規。

API 詳細資料

請瀏覽本頁面的 merchandising-related 端點定義，然後使用 API Explorer 或其他測試軟體，以了解範例與架構定義與實際輸出結果的對比情況。

其他資源

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