到達網頁檔案語法

到達網頁檔案的根元素是 <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> 元素。

注意：如果您已向 Google 支援團隊設定預設顯示名稱，則 OTA 的這個欄位為選填欄位。否則 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 找到飯店預訂連結。

      • 注意：系統不允許將所有網站類型設為 never。這會導致系統忽略 sitetype。

  • 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 參數設定正確，就會自動逸出 LPURL。例如：

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

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

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