到達網頁檔案的語法

到達網頁檔案的根元素是 <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：與使用者或飯店所在國家/地區的幣別相符。 這項屬性會採用 3 個英文字母的貨幣代碼。例如 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>。 詳情請參閱 為飯店廣告活動設定動態追蹤。

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