建立登陸頁面摘要
若要提供 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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&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)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
</PointOfSale>
</PointsOfSale>
比對登陸頁面
登陸頁面包含包含 Match Bing 用來比對使用者與 POS 之準則的專案。 以下是 Bing 用來比對使用者與登陸頁面的準則。 清單依喜好設定順序排列。
- 國家
- 貨幣
- 語言
- 裝置
- sitetype
Bing 會使用下列規則來尋找最佳的 POS 比對。
Bing 提供最高的國家/地區相符專案喜好設定，以及裝置相符專案的最低喜好設定。
如果
Match未指定其中一個準則，Bing 會隱含地比對準則的所有值。 例如，如果Match指定語言和貨幣，Bing 會隱含地比對任何國家/地區和裝置。如果
Match指定一或多個準則，Bing 會使用具有最明確相符專案的 POS。如果沒有明確的規則相符專案，則選取 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 屬性。 以下是可能的值。
|
| CAMPAIGN-ID | 觸發廣告之營銷活動的標識碼。 例如，假設您的 URL 是 www.northwindtraders.com/ (CAMPAIGN-ID) 。 假設您的行銷活動標識碼已2410012280，則廣告的登陸頁面 URL 會是 www.northwindtraders.com/2410012280。 |
| CHECKINDAY |
在 Price 摘要的 元素中Checkin指定的兩位數日期。 例如，20。 |
| CHECKINDAY-OF-WEEK | 一周中發生簽入的日期。 Bing 使用數位 0 到 6 來代表星期一到星期日。 例如，1 是星期二。 |
| CHECKINMONTH | 在 Price 摘要的 元素中 Checkin 指定的兩位數月份。 Bing 使用數位 00 到 11 來代表 1 月到 12 月。 例如，05 是 June。 |
| CHECKINYEAR | 在 Price 摘要的 元素中 Checkin 指定的四位數年份。 例如，2021。 |
| CHECKOUTDAY | 用戶簽出的兩位數日期。Bing 會使用 Nights TransactionMessage 的 和 Checkin 元素來計算日期。 例如，23。 |
| CHECKOUTMONTH | 用戶簽出的兩位數月份。Bing 會使用 Nights Price 摘要的 和 Checkin 元素來計算月份。 例如，07。 |
| CHECKOUTYEAR | 用戶簽出的四位數年份。Bing 會使用 Nights Price 摘要的 和 Checkin 元素來計算年份。 例如，2021。 |
| CLICK-TYPE | 指出使用者是單擊旅館廣告還是會議室套件組合廣告。 以下是可能的值。
|
| CUSTOM[1-5] | 自定義欄位的值 (例如，Custom1) 在 Price 摘要的 Result 元素中指定。 |
| DATE-TYPE | 指出使用者是否指定簽入和簽出日期。 以下是可能的值。
|
| HOTELGROUP_ID |
注意：HOTELGROUP_ID是參照飯店中心的舊版參數。 請改用 ADGROUP-ID。 旅館廣告所屬的旅館群組標識符。 |
| 長度 | 在 Price 摘要的 元素中 Nights 指定的停留長度。 例如，3。 |
| NETWORK | 提供廣告的廣告網路類型。
|
| NUM-一起 | 佔用房間的成人人數。 預設值為 2。 |
| PARTNER-CURRENCY | 在 Price 摘要中元素的貨幣屬性中指定的 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 | 廣告在結果頁面上的位置。 參數可能包含下列可能的值：
|
| 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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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 Price 摘要中的 元素，而 PARTNER-HOTEL-ID 變數的值則來自 id Property 摘要中的 元素。
有些變數是 Price 摘要元素的子集。 例如，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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)
&nights=(LENGTH)(IF-DEFAULT-DATE)&popup_datepicker=true(ELSE)
&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 進行驗證。
要求您的帳戶管理員匯入摘要檔案。
請務必也匯入旅館數據。 如需建立屬性摘要檔案的相關信息，請參閱 屬性摘要。
成功匯入登陸頁面摘要和屬性摘要之後，您可能會開始傳送旅館價格和可用性數據。 如需詳細資訊，請 參閱價格摘要。