簡介

利用新的商品銷售 API 更輕鬆地識別交易並受益於機器學習技術

利用機器學習幫助您從 Expedia Group 龐大的全球促銷庫存中找出最適合旅行者的優惠和折扣。透過使用 Merchandising API，您可以存取各種活動內容並處理數據，以建立成功的 year-long 策略和 traveler-facing 體驗，例如促銷電子郵件、應用程式小部件、網站橫幅和輪播體驗。

我們還在合作夥伴入口網站中添加了一個新應用程序，您可以使用它來製定行銷策略以及計劃、執行和追蹤活動。該應用程式位於名為「門戶行銷中心」的新部分。請聯絡您的客戶經理以獲取更多資訊。

活動內容端點

提供即將舉行的活動詳情，包括活動 ID、預訂和住宿開始和結束日期以及參與的酒店數量。
可以直接存取 Expedia-curated 活動資產，例如活動主題圖像、目的地圖像、建議副本等。
接收有關限時優惠 (LTO) 活動的信息，這些活動的預訂窗口在未來六個月內，以及全年可用的常青活動。

您可以使用 Campaign Content 端點透過請求參數搜尋即將進行的活動，包括：

可預訂日期範圍
入住日期範圍
等於或高於最低折扣值
LTO 與常青優惠

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

訂房和住宿日期
最小和最大折扣百分比

其他細節

活動內容端點可以幫助您利用 Expedia-curated 資產來建立 traveler-facing 行銷體驗，例如促銷電子郵件、應用程式小工具、網站橫幅等。

您可以使用活動內容回應中的 property_count欄位來決定參與屬性的最大 up-to-date 數量。飯店對促銷活動的參與是動態的，因此我們建議您在活動開始前約 4-6 週評估property_count，以更準確地了解有多少飯店將作為活動的一部分提供優惠。

促銷端點接受的唯一區域類型是city。其他區域類型如multi_city_vicinity、point_of_interest、neighbourhood等將傳回空白回應。

合作夥伴仍負責使用新的 Merchandising API 或 Shopping API 建立的網站上的行銷和訊息活動，並確保所有此類行銷和訊息傳遞符合適用的法律法規。

促銷端點

提供與特定活動相關的所有可用交易和折扣。
能夠藉助多個請求參數搜尋和過濾交易，包括能夠為特定活動或跨多個活動請求交易。
使您能夠始終展示最具 up-to-date 吸引力的房地產交易，以建立 high-converting 活動。

您可以使用促銷端點透過請求參數輕鬆過濾和搜尋交易，例如：

廣告活動 ID 和/或媒體資源 ID
可預訂日期範圍
入住日期範圍
等於或高於最低評分、最低星級和/或最低折扣的值
限時與常青的區別
Member-only 和 mobile-only 交易標誌
超級區域或特定目的地
機器學習相關性分數排序順序

以下詳細資訊將在促銷 API 回應中傳回：

交易 ID、對應的廣告活動 ID 和屬性 ID
可預訂日期範圍、入住日期範圍、不適用日期和提前購買期限
限時與常青的區別
機器 learning-powered 針對回應中傳回的交易、屬性和目的地，為您的業務提供獨特的相關性分數
特定目的地和連鎖店 ID 訊息
標記化連結到現有的快速財產內容 API，以提取 property-level 圖像，並將其融入您的行銷體驗中

其他細節

您可以輕鬆搜尋和過濾促銷回應以獲得更有針對性的優惠，從而完全控制向旅客展示的優惠。您也可以規劃這些交易來建立您自己的活動主題，而不是使用 Expedia-defined 活動和相關資產。

您可以在 Promotions 端點上使用 include請求參數來自訂收到的回應的大小。因此，如果您只需要傳回幾個字段，而不是接收所有回應字段，則可以在 include參數中添加那些特定的字段名稱。

您可以使用活動內容回應中的 property_count欄位來決定參與屬性的最大 up-to-date 數量。飯店參與促銷活動是動態的，因此我們建議您評估property_count大約在活動開始前 4-6 週，以便更準確地了解有多少房產將作為活動的一部分提供優惠。

與活動內容指南一樣，我們建議您盡可能接近活動可預訂開始日期提出促銷請求，以確保您獲得最多的 up-to-date 優惠。

如果您有興趣建立 destination-based 行銷活動，您可以使用相關的region_id來自快速地理 API。

機器學習建議

促銷回應中提供的機器 learning-powered 相關性分數對於每個組織都是唯一的，因此您收到的分數/排名將與其他人收到的分數/排名不同。您可以使用機器學習建議來確定在商品推銷活動中要推廣的最佳交易、房產和目的地。Higher-scoring 優惠、酒店和目的地將有可能推動您獨特的旅行者群體的轉換。

目前，您將收到每個活動中前 10,000 個交易的相關性分數。在我們的測試中，我們發現在前 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 的目的地的所有交易結果。

**筆記：**門戶行銷中心也提供機器學習建議。請聯絡您的客戶經理以了解更多詳細資訊。

對購物可用性 API 所做的更改

要獲取有關可用性、實時定價、可退款性、佣金信息等的最新詳細信息，您應該向 Rapid 提出標準請求購物可用性 API我們對購物 API 進行了以下更改，以支援商品銷售流程並盡可能順利地整合商品銷售 API：

使用新的deal快速購物可用性端點中可用的過濾器僅接收具有有效促銷的價格。這使您可以靈活地建立以商品銷售為重點的購物請求，並確保返回的所有費率都具有 deal 屬性。
Rapid 的購物可用性端點上提供了一個名為 Campaign-Id 的新請求標頭，您可以用它指示您正在進行的特定購物可用性 API 調用不是常規調用，而實際上是由於您的商品購物活動而進行的 (換句話說，這將表示當旅行者因活動促銷而進入商店體驗時，提出了可用性 API 請求)。每次購物 API 呼叫我們只接受一個活動 ID。此活動 ID 將幫助我們追蹤您的活動效果並為您設計更好的機器學習模型和 API 增強功能。
如果您想查看入口網站行銷中心上的行銷活動效果，您需要在購物 API 呼叫中傳遞行銷活動 ID 參數。如果您有任何疑問，請聯絡您的客戶經理。

**注意：**您一次最多可以從購物可用性 API 請求 250 個屬性的詳細資訊。

範例回應

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

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

建議的最低折扣不含稅費。您有責任確保所宣傳的折扣符合必要的價格廣告法。

API 詳細資料

探索此頁面上的 merchandising-related 端點定義，然後使用 API Explorer 或其他測試軟體來了解範例和模式定義與實際輸出的比較。

其他資源

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