開始使用交易訊息

注意事項

此 Beta 版的旅館價格廣告僅供選取參與者使用。 如需參與 Beta 發行計畫的相關資訊，請連絡您的帳戶管理員或 在這裡註冊。

如果您在 Microsoft Advertising 中建立旅館廣告活動，請使用交易訊息來更新您的路線資料， (定價和可用性) 。

您必須先連絡帳戶管理員以註冊，才能傳送 Microsoft 交易訊息。

傳送 Microsoft 路線資料的不同模式

Microsoft 支援下列模式，您可以使用這些模式來提供您的路線資料。

• 推送模式
• 提取模式
• 具有提示的提取模式

使用 推送模式時，您會以您選擇的間隔傳送未經要求的更新給 Microsoft。 若要使用此模式，您必須提供 IPv4 位址 (或 CIDR 格式的位址範圍，) 您將用來傳送交易訊息的所有伺服器。 如需詳細資訊，請 參閱將交易訊息推送至 Microsoft。

使用 提取模式 選項時，Microsoft 會傳送 查詢訊息 ，指定您應該傳回的旅館路線資料。 兩種提取模式之間的差異在於您傳送給 Microsoft 的資料量。 使用 提取模式時，您會傳回所有路線和所有旅館的資料。 但是，使用 含提示的提取，您會告訴 Microsoft 哪些資料已變更，而且它只要求該資料。 如需詳細資訊，請 參閱擁有 Microsoft 提取交易訊息。

什麼是交易訊息

交易訊息是一份 XML 檔，其中包含一或多個旅館屬性的定價和可用性資料。 針對每個旅館屬性，為每個 Checkin 指定一個 Result 元素，並 Nights 組合 (也知道為進階預約視窗中的路線) 。 如果您允許五天的進階預約，且最多保留三天，則您的訊息會包含 15 個 Result 元素。 下列範例顯示一天的行程。

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">100.00</Baserate>
    <Tax currency="USD">10.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">8.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">300.00</Baserate>
    <Tax currency="USD">30.00</Tax>
    <OtherFees currency="USD">12.00</OtherFees>
  </Result>
</Transaction>

您可以指定最多 180 天的進階預約，最多可保留 14 個夜間。 例如，如果訊息的 timestamp 是 2017-06-10，則訊息可能指定的最後 Checkin 一個日期是 2017-09-08。

檔必須使用 UTF-8 編碼。

深入瞭解

在傳送訊息之前先驗證訊息

在傳送交易訊息給 Microsoft 之前，請使用 交易 XSD 來驗證訊息。 這可藉由攔截 XSD 所載入的檔語法錯誤和條件約束，來節省時間和來回行程。

下列範例示範如何使用 xmllint 來驗證封裝含在 SampleTransaction.xml 中的訊息。

xmllint.exe --schema transaction.xsd SampleTransaction.xml

注意事項

XSD 未定義一些條件約束，可能會在 Microsoft 處理訊息時產生錯誤。 請確定您的訊息符合本檔中定義的所有條件約束。