到達網頁檔案語法

到達網頁檔案的根元素是 <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>。 如需更多資訊，請參閱「 為飯店廣告活動設定動態追蹤」一文。

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