Share via

Create 銷售點摘要

  • 發行項

注意事項

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

若要提供 Bing 的銷售點數據，請為您支援的每個預約網站建立包含銷售點 (POS) 的 XML 檔。 POS 描述 POS 的顯示名稱、URL，以及將使用者與 POS 比對的準則。

文件必須使用UTF-8編碼，而且必須符合 PointsOfSale XSD。

注意事項

Bing 不支援所有 XSD 元素。 Bing 會忽略檔中任何不支援的元素或屬性。 銷售 點參考 僅包含 Bing 支援的元素和屬性。

注意事項

文件必須以 PointsOfSale XSD (或參考) 中所示的順序來指定專案。

摘要中的最上層元素

銷售點摘要包含單一的最上層 PointsOfSale 元素。 元素 PointsOfSale 需要用戶可用來預約房間的每個網站的 PointOfSale 子專案。

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PointOfSale>
    . . .
  </PointOfSale>
  ...
</PointsOfSale>

元素 PointOfSale 描述 POS 的顯示名稱、URL，以及將使用者與 POS 比對的準則。 如需定義 POS 的相關信息，請參閱 定義銷售點。

定義銷售點

元素 PointsOfSale 包含 PointOfSale 元素的清單，每個 POS 網站一個可供使用者用來預約會議室。 此清單必須包含單一合作夥伴的銷售點。

下列顯示 PointOfSale 定義英文用戶銷售點的專案。 第一 PointOfSale 個元素會為任何裝置上的英文用戶定義 POS，而第二 PointOfSale 個元素定義行動裝置上英文使用者的 POS。 POS URL 包含交易的詳細數據，例如簽入和簽出日期、旅館標識碼和用戶語言。 Bing 會使用顯示名稱和 POS URL 來建立新增至廣告的超連結。 當使用者按兩下連結時，系統會將他們帶到預約網站。 如果您使用 追蹤範本 進行效能追蹤，則必須在 POS 摘要檔案中設定登陸頁面 URL LPURL 元素，才能讓追蹤運作。 Bing 會使用顯示名稱和 POS URL 或 LPURL 來建立新增至廣告的超連結。 當使用者按兩下連結時，系統會將他們帶到預約網站。

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

只包含 DisplayNames 在線旅遊機構的專案。 請勿包含 DisplayNames 中央訂房系統 (CRS) 供應商 (也稱為整合合作夥伴) 和直接供應商 (，例如旅館擁有者或連鎖) 。 對於 CRS 供應商和直接供應商，Bing 會使用旅館摘要中的旅館名稱。

如果您包含 DisplayNames，則必須包含 Match 語言準則設定為相同語言的專案。

Bing 會根據 POS 的比對準則，使用最符合使用者的 POS。 根據上述比對準則，行動裝置上的使用者將使用 English-Mobile POS，而其他人則會使用英文 POS。 如需 Bing 如何將使用者與 POS 相符的資訊，請參閱 比對銷售點。 如需可比對的準則清單，請參閱 Match 元素。

元素 URL 會指定使用者可以預約會議室的網站連結。 此範例示範如何使用動態查詢參數。 Bing 會在運行時間取代動態變數的值。 如需使用動態查詢參數的相關信息，請 參閱使用動態查詢參數。

注意事項

如果您指定語言和國家/地區比對準則，則必須將其設定為僅 限 en和美國 。

以下顯示完整的銷售點 XML 檔。

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

比對銷售點

銷售點包含包含 Match Bing 用來比對使用者與 POS 之準則的專案。 以下是 Bing 用來比對使用者與銷售點的準則。 清單依喜好設定順序排列。

  • 國家
  • 貨幣
  • 語言
  • 裝置

Bing 會使用下列規則來尋找最佳的 POS 比對。

  • Bing 提供最高的國家/地區相符專案喜好設定，以及裝置相符專案的最低喜好設定。

  • 如果 Match 未指定其中一個準則，Bing 會隱含地比對準則的所有值。 例如，如果 Match 指定語言和貨幣，Bing 會隱含地比對任何國家/地區和裝置。

  • 如果 Match 指定一或多個準則，Bing 會使用具有最明確相符專案的 POS。

  • 如果使用者符合多個銷售點，Bing 會使用符合品質最佳的 POS。 如果多個銷售點具有相同的比對品質，Bing 會使用它找到的第一個 POS 搭配該相符品質。 比對品質是以下列項目為基礎：

    • 符合最高喜好設定。 例如，如果一個 POS 只符合用戶的貨幣，而另一個僅符合使用者的裝置，Bing 會使用符合用戶貨幣的 POS，因為它的慣用順序較高。
    • 明確相符專案比隱含相符項目優先。 例如，如果一個 POS 明確符合用戶的國家/地區，而另一個則隱含符合用戶的國家/地區，Bing 會使用明確相符的 POS。

元素 Match 的狀態屬性會根據比對來決定是否要包含或排除 POS。 如果 status 為 never 且 Bing 符合所有準則，Bing 將不會使用 POS。 若要排除 POS，所有準則都必須相符。 在下列範例中，如果使用者來自 美國 或法國，Bing 會明確地排除 POS，如果使用者來自任何其他國家/地區，則會隱含包含該 POS。

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

如果狀態為 [是]，Bing 將不會排除任何未明確符合所有準則的銷售點，但會將喜好設定提供給符合最多準則的 POS。 在下列範例中，如果用戶的國家/地區是法國，Bing 會明確地比對使用者與 POS。 如果使用者的國家/地區不是法國，在找到較佳的相符專案之前，仍會考慮使用 POS。 如果找不到較佳的相符專案，Bing 將會使用 POS。

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing 建議針對每個 POS 使用相同的比對準則。 這可將判斷一個 POS 比對另一個 POS 的原因最小化。

使用動態查詢參數

銷售點 (POS) 包含 URL 可識別用戶可預約會議室之網站的專案。 URL 可能包含動態查詢參數，這是使用者定義的參數，其中包含其值的預先定義令牌。 Bing 接著會以值取代令牌，然後再將URL新增至廣告。 藉由使用動態查詢參數，您可以在URL中包含旅館的標識碼、簽入日期、停留時間等。

下列顯示您用來在 POS URL 中指定動態查詢參數的語法。 因為動態查詢參數是查詢參數，所以它們必須遵循 URL 中的問號符號 (？) 。

http://domain.com/path?param-name=(dynamic-variable-name)

以下是您可以在URL中指定的可能區分大小寫動態變數名稱。

名稱 描述
ADGROUP-ID 觸發廣告的廣告群組標識碼。 例如，假設您的 URL 是 www.northwindtraders.com/ (ADGROUP-ID) 。 假設您的廣告群組標識碼已2410012280，則廣告的登陸頁面 URL 會是 www.northwindtraders.com/2410012280。
ADVANCE-BOOKING-WINDOW 預約發生的簽入日期前天數。 例如，36。
BING-SITE 產生廣告要求的 Bing 屬性。 以下是可能的值。
  • localuniversal— 廣告源自搜尋結果頁面。
  • mapresults— 廣告源自地圖網站。
  • PropertyPromotionAd— 廣告源自地圖搜尋中顯示的第一個結果頁面。
  • unknown— 廣告源自未決定的來源。
  • 驗證— Bing 在站臺上執行資料質量測試時會使用此值。 這些查詢不會向您收費。 Bing 分析會使用此參數及其值來識別旅館價格廣告驗證流量。
CAMPAIGN-ID 觸發廣告之營銷活動的標識碼。 例如，假設您的 URL 是 www.northwindtraders.com/ (CAMPAIGN-ID) 。 假設您的行銷活動標識碼已2410012280，則廣告的登陸頁面 URL 會是 www.northwindtraders.com/2410012280。
CHECKINDAY 在交易訊息的 元素中Checkin指定的兩位數日期。 例如，20。
CHECKINDAY-OF-WEEK 一周中發生簽入的日期。 Bing 使用數位 0 到 6 來代表星期一到星期日。 例如，1 是星期二。
CHECKINMONTH 在交易訊息的 元素中 Checkin 指定的兩位數月份。 Bing 使用數位 00 到 11 來代表 1 月到 12 月。 例如，05 是 June。
CHECKINYEAR 在交易訊息的 元素中 Checkin 指定的四位數年份。 例如，2021。
CHECKOUTDAY 用戶簽出的兩位數日期。Bing 會使用 Nights TransactionMessage 的 和 Checkin 元素來計算日期。 例如，23。
CHECKOUTMONTH 用戶簽出的兩位數月份。Bing 會使用 Nights 交易訊息的 和 Checkin 元素來計算月份。 例如，07。
CHECKOUTYEAR 用戶簽出的四位數年份。Bing 會使用 Nights 交易訊息的 和 Checkin 元素來計算年份。 例如，2021。
CLICK-TYPE 指出使用者是單擊旅館廣告還是會議室套件組合廣告。 以下是可能的值。
  • hotel— 使用者按兩下旅館廣告。
  • room— 使用者按兩下會議室套件組合廣告。
注意： Bing 不支援會議室選項。
CUSTOM[1-5] 自定義欄位的值 (例如，Custom1) 在交易訊息的 Result 元素中指定。
DATE-TYPE 指出使用者是否指定簽入和簽出日期。 以下是可能的值。
  • default— 使用者按兩下使用預設日期的旅館廣告。
  • 已選取 — 使用者按兩下具有特定簽入和簽出日期的旅館廣告。
HOTELGROUP_ID 注意：HOTELGROUP_ID是參照飯店中心的舊版參數。 請改用 ADGROUP-ID。

旅館廣告所屬的旅館群組標識符。
長度 在交易訊息的 元素中 Nights 指定的停留長度。 例如，3。
NETWORK 提供廣告的廣告網路類型。
  • o = 擁有和操作 (Bing、AOL 和 Yahoo 搜尋結果)
  • s = 已同步 (搜尋夥伴網站結果)
  • a = microsoft 物件網络位置 (物件)
例如，假設您的 URL 是 www.northwindtraders.com/network= (NETWORK) 。 假設您的網路 (廣告發佈) 是 Bing、AOL 和 Yahoo 搜尋 (僅擁有及操作) ，則廣告的登陸頁面 URL 會是 www.northwindtraders.com/network=o。
NUM-一起 佔用房間的成人人數。 預設值為 2。
PARTNER-CURRENCY 在交易訊息中 專案之貨幣屬性中指定的 Baserate 三個字母貨幣代碼。 例如，美元。
PARTNER-HOTEL-ID 在旅館摘要的 元素中 id 指定的旅館標識碼。
PARTNER-ROOM-ID 可唯一識別會議室的標識碼。 這是在 Result>、<RoomBundle> 或 <RoomData> 區塊的 <RoomID> 元素中<指定的標識符，視使用量而定。
PRICE-DISPLAYED-TAX 用戶當地貨幣的稅額。 稅額是以交易訊息中指定的項目為基礎 Tax 。 例如 3.14。
PRICE-DISPLAYED-TOTAL 房間的總成本，以用戶的當地貨幣為單位。 金額是以交易訊息中指定之 Baserate、 Tax和 OtherFees 項目的總和為基礎。 例如，152.13。
SLOT_TYPE 廣告在結果頁面上的位置。 參數可能包含下列可能的值：
  • A— 載入廣告時，在結果頁面上顯示廣告的優先順序位置。
  • B— 只有當使用者按兩下 [ 更多費率] 之後，才會顯示廣告的次要位置。
SUBACCOUNT_ID 注意：SUBACCOUNT_ID是參照飯店中心的舊版參數。 請改用 CAMPAIGN-ID。

飯店價格廣告營銷活動所屬的子帳戶標識碼。
USER-COUNTRY 使用者所在國家/地區的兩個字母國家/地區代碼。 此值會從使用者的用戶端設定中擷取。 例如，美國。
USER-CURRENCY 使用者所使用之本機貨幣的三個字母貨幣代碼。 此值是從使用者的用戶端設定推斷而來。 例如，美元。
USER-DEVICE 使用者的裝置類型。 以下是可能的值。
  • 行動電話
  • 片
  • 桌面
  • 未知
此值是從使用者的用戶端設定推斷而來。
USER-LANGUAGE 指定廣告顯示語言的兩個字母語言代碼。 此值是從使用者的用戶端設定推斷而來。 例如，en。
驗證 布爾值，指出 Bing 是否產生連結。 如果 Bing 產生連結，則值為 true。 否則為 false。

所有日期，例如 CHECKINDAY，都位於旅館的時區中。

下列範例 URL 包含動態查詢參數和編碼實體。

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

在 Bing 使用廣告中的 URL 之前，它會將值取代為動態變數名稱。 例如，如果使用者從 2021 年 6 月 7 日開始為旅館 #42 預訂 6 個房間，Bing 會將 URL 轉譯為：

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing 會從您的交易訊息和旅館摘要，以及使用者特定設定取得動態參數的值。 例如，LENGTH 變數的值來自 Nights 交易訊息中的 元素，而 PARTNER-HOTEL-ID 變數的值則來自 id Hotel 摘要中的 元素。

某些變數是交易訊息元素的子集。 例如，CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 變數會從 元素中 Checkin 擷取。 其他變數是根據用戶的地區設定和其他客戶端設定來計算。

一般 URL 規則

以下是使用動態變數時要遵循的一般規則。

  • 所有動態參數都是選擇性的。 您不需要在 POS URL 中插入任何動態參數。 不過，使用變數來傳遞反覆專案和使用者特定資訊，通常會為用戶創造更好的體驗。

  • 以開啟和關閉括弧括住動態變數名稱。

  • 針對特殊字元使用編碼實體。 例如，以 & 取代 ampersands (&) ，將空格取代為 %20，並將斜線 (/) 取代為 %2F。

  • 單一參數的值可以從多個變數建構。 例如，您可以從 CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 變數建構 checkinDate 查詢參數的值。

    <URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

  • 針對 Bing 辨識但不支援的動態變數，Bing 會以空字串取代變數字串。

  • 因為動態查詢參數是查詢參數，所以它們必須遵循 URL 中的問號符號 (？) 。

使用條件指示詞

除了上面所列的變數之外，您也可以使用下列指示詞來建立條件式邏輯。

  • IF-DEFAULT-DATE — 如果使用者按兩下使用預設日期的旅館廣告， (使用者未挑選日期) ，則解析為 true 。 如果 為 true，Bing 會將遵循此指示詞的值插入 URL。 否則，Bing 會在 ELSE 指示詞後面插入值。

  • ELSE— 如果不符合先前的條件，Bing 會插入遵循此指示詞的值。

  • ENDIF— 結束條件區塊。

例如，如果使用者使用預設日期，而不是指定日期，下列URL會將popup_datepicker查詢參數設定為 true 。

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

如果 為 true，Bing 會將 URL 轉譯為：

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

否則，Bing 會將URL轉譯為：

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

一般規則

  • 在將銷售點摘要檔案傳送至 Bing 之前，請使用 PointsOfSale XSD 來驗證該檔案。

  • 銷售點摘要文件必須使用UTF-8編碼。

  • 摘要必須包含使用者用來預訂會議室之所有網站的銷售點，摘要程序不支援部分更新。

  • Bing 會忽略它不支援的任何元素或屬性。

  • 元素必須是 PointsOfSale XSD 中指定的順序。

  • 如果您的數據包含像是單引號或引號等特殊字元，請將其逸出或使用 CDATA 區段。 如果您逸出它們，您可以使用實體代碼或字元代碼。 例如，您可以將Paul的逸出為paul's 或 Paul's.

  • 請勿包含不包含資料的專案。 例如，如果您未提供旅館的顯示名稱，請勿包含空 <的 DisplayNames> 元素。

  • 請勿在 XML 元素中使用 HTML。

後續步驟

建立摘要檔案之後，請使用 PointsOfSale XSD 進行驗證。

要求您的帳戶管理員匯入摘要檔案。

請務必也匯入旅館數據。 如需建立旅館摘要檔案的相關信息，請參閱 旅館摘要。

成功匯入銷售點摘要和旅館摘要之後，您可能會開始傳送旅館價格和可用性數據。 如需詳細資訊，請 參閱交易訊息。