到達網頁檔案語法

到達網頁檔案的根元素是 <PointsOfSale>，可接收一個 子元素、<PointOfSale>，而且沒有屬性。到達網頁檔案 有多個 <PointOfSale> 子元素。

您在到達網頁檔案中定義的每個到達網頁都會包含在 <PointOfSale> 元素。這個元素採用單一屬性 id，也就是 定義到達網頁的專屬 ID。你可以將這個值 (id)，篩選出符合飯店條件的到達網頁。您可以做到 在 <Transaction> 中使用 <AllowablePointsOfSale> 元素。

語法

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

下表將說明 <PointOfSale> 元素的子元素：

元素 必填 說明
<DisplayNames> Optional

包含線上旅行社 (OTA) 的顯示文字。 這個元素採用下列屬性：

  • display_text：包含在 廣告或免費的預訂連結。此欄位應為合作夥伴的名稱。
  • display_language： 雙字母語言代碼：指定廣告的顯示語言 或免費的預訂連結此屬性的值必須符合 「<Match>」指定的支援語言 元素。

以下為法文 OTA 的顯示名稱範例：

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

排除中樞的 <DisplayNames> 元素 保留系統 (CRS) 供應商 (又稱「整合」) 合作夥伴」，以及直接供應商 (例如飯店業主或連鎖店)。適用對象 這些類型的合作夥伴、廣告和免費的預訂連結文字擷取自 飯店在飯店清單中的 <Name> 元素。

注意：如果您已為 OTA 設定預設顯示名稱， 這個欄位就是選填否則，OTA 必須 請提供 <DisplayNames>。
<Match> Required

定義用來篩選廣告和免費預訂連結的篩選器 根據使用者或飯店的各種特徵顯示廣告空間適用對象 舉例來說，您可以指定向使用者顯示廣告或免費的預訂連結 只向特定國家/地區的使用者提供

這個元素採用下列屬性：

  • status：決定比對內容是否包含或排除 傳回結果。有效的值為 yes (必須 ) 或 never (不得相符)。
  • country：相符的 Google 網域 使用者和飯店這項屬性會使用雙字母國家/地區代碼。例如 US 或 FR。
  • language：比對使用者和飯店語言。這個 屬性會採用 雙字母語言代碼。例如 en 或 fr。
  • brand：比對 hotel_brand 的值 屬性。這個篩選器可幫助您 針對你的預訂引擎或各個品牌設定不同的網址。
  • currency：比對使用者或飯店國家/地區的幣別。 這項屬性會使用三字母的貨幣代碼。例如： USD 或 EUR。
  • sitetype：比對與 使用者查看了飯店房價資料。此屬性需要： 值：
    • localuniversal：使用者找到廣告或免費預訂 連結，通常是透過 google.com 搜尋。
    • mapresults：使用者透過 maps.google.com。
  • device：比對使用者使用的裝置類型 搜尋。此屬性需要 mobile、desktop 或 tablet。

    注意：您無法將 status 設為 如果 device 設為 tablet，則為 never。

例如：

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

您可以將 <Match> 元素的屬性合併為 可以簡化比對規則，如以下範例所示：

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

如需更多資訊，請參閱 到達網頁 比對規則
<URL> Required 定義網站連結，讓使用者預訂會議室。個人中心 可插入與使用者及其行程相關的動態資訊，做為查詢內容 字串參數。舉例來說，您可以使用 網址中的 PARTNER-HOTEL-ID 變數： 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

建立並向使用者顯示這個連結後，Google 將 PARTNER-HOTEL-ID 變數替換為適當的 飯店 ID。當使用者點進您的網站時，您的網站可以 然後擷取並處理所有查詢字串參數的值 打造流暢的使用者體驗。如需可用變數的完整清單 請參閱 使用變數和條件。

使用追蹤功能時，請指定含有元件的完整網址 追蹤系統所需的追蹤項目例如：

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

ValueTrack 參數無法用於 <URL>。

每個屬性只能定義一個 <URL> 元素 到達網頁
<LPURL> Optional

用於支援到達網頁網址中的動態追蹤。說明 <URL> 中定義的非追蹤部分元素。 到達網頁網址的追蹤區隔必須使用 Google Google Ads 帳戶提供的廣告追蹤範本 和最終到達網址尾碼如果 Google 中沒有追蹤網址 廣告，系統會忽略 <LPURL> 元素。

<LPURL> 值不需要逸出。A 罩杯 Google Ads 中的 ValueTrack 設定正確會逸出 。例如：

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

ValueTrack 參數無法用於 <LPURL>。 如需詳細資訊，請參閱 設定飯店廣告活動的動態追蹤。

到達網頁檔案架構定義了 到達網頁檔案。如需更多資訊，請參閱 飯店廣告架構