到達網頁檔案語法

到達網頁檔案的根元素為 <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"
  />

請為中央預訂系統 (CRS) 供應商 (也稱為「整合合作夥伴」) 和直接供應商 (例如飯店業主或連鎖店) 排除 <DisplayNames> 元素。針對這類合作夥伴，廣告和免費的預訂連結文字取自飯店清單中飯店的 <Name> 元素。

注意：針對 OTA，如果設有 Google 支援團隊的預設顯示名稱，則這個欄位是選填欄位。否則 OTA 須提供 <DisplayNames>。
<Match> Required

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

這個元素採用下列屬性：

  • status：判斷比對項目是否包含或排除指定條件的結果。有效值為 yes (必須相符) 或 never (不得相符)。
  • country：比對使用者和飯店的 Google 網域。這項屬性會採用雙字母的國家/地區代碼。例如 US 或 FR。
  • language：比對使用者和飯店語言。這個屬性會採用 雙字母的語言代碼。例如 en 或 fr。
  • brand：比對飯店清單中指定的 hotel_brand 屬性值。如果你針對預訂引擎或多個品牌設有不同網址，這個篩選器就能派上用場。
  • currency：比對使用者或飯店國家/地區的貨幣。這項屬性會採用三個字母的貨幣代碼。例如 USD 或 EUR。
  • sitetype：與使用者查看飯店價格資料時使用的 Google 房源進行比對。這個屬性會採用下列值：
    • localuniversal：使用者透過搜尋找到廣告或免費的預訂連結，通常是透過 google.com 搜尋。
    • mapresults：使用者透過 maps.google.com 找到飯店預訂連結。
  • device：與使用者用來搜尋的裝置類型相符。這項屬性會採用 mobile、desktop 或 tablet。

    注意：如果將 device 設為 tablet，則無法將 status 設為 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 變數來加入飯店 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 Ads 追蹤範本和最終到達網址尾碼，在 Google Ads 帳戶內指定到達網頁網址的追蹤區隔。如果 Google Ads 中沒有追蹤網址，系統將忽略 <LPURL> 元素。

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

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

ValueTrack 參數無法在 <LPURL> 中使用。 詳情請參閱「 為飯店廣告活動設定動態追蹤」一文。

到達網頁檔案結構定義定義了到達網頁檔案的結構和限制。詳情請參閱飯店廣告結構定義