變數和條件

飯店廣告和免費預訂連結會提供到達網頁的連結，使用者可透過這些連結預訂房間。也可以指定 Google 生成連結的方式，以納入更多與使用者及其行程相關的資訊。舉例來說，你可以在網址中加入飯店 ID、語言、幣別代碼和入住日期等資訊。

總覽

您可以在到達網頁檔案中定義到達網頁網址。顯示廣告或免費預訂連結時，系統會將網址中的動態資訊替換為實際值。如要在到達網頁網址中加入動態值，請使用下列語法：

<URL>https://partner_url?param_id=(variable_name)</URL>

以下範例顯示的網址使用 Google 的變數名稱，而非實際的飯店 ID 和行程：

範例 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

範例 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

建立搜尋結果網頁的到達網頁連結時，Google 會將變數替換成實際值，確保網址包含動態資訊。舉例來說，如果使用者預訂第 42 號飯店的客房，從 2023 年 5 月 23 日起入住 6 晚，Google 會以下列方式顯示先前的連結：

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Google 為查詢字串中的變數指派的值，取決於飯店價格動態饋給、飯店清單動態饋給和使用者設定中的對應資料。

舉例來說，系統會將相關行程的價格動態饋給中 LENGTH 變數的值指派給 <Nights> 元素。同樣地，PARTNER-HOTEL-ID 變數的值是在飯店清單動態饋給的 <id> 元素中定義，且符合使用者的搜尋條件。

部分變數是價格動態饋給元素的子集。舉例來說，CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 變數是從價格動態饋給中的單一 <Checkin> 元素擷取而來。其他變數則會根據使用者的語言代碼和其他用戶端設定計算。

如要進一步瞭解變數值的來源，請參閱「價格總覽」和「飯店清單」。

網址變數

下表說明可用於建構到達網頁網址的變數：

網址中的條件式邏輯

您可以在到達網頁檔案的 <URL> 元素中使用特殊指令，有條件地建構端點。

條件式邏輯支援下列陳述式：

• if_statement：如果 true，系統就會將此條件後方的值插入到網址中，否則會插入 ELSE 指令後方的值。

• for_statement：建立 FOR 迴圈條件，根據提供的值數量進行疊代。

IF 和 FOR 陳述式包含下列項目：

IF-AD-CLICK 範例

你可以建構條件區塊，查看使用者點擊的廣告或免費預訂連結，以便重新導向至到達網頁。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

在這個範例中，如果使用者未點按廣告，就會產生下列網址：

https://www.partner.com?hid=123&adType=0

如果使用者點擊廣告，就會產生下列網址：

https://www.partner.com?hid=123&adType=1

IF-CLICK-TYPE-HOTEL 範例

你可以建構條件區塊，查看使用者選取的飯店是否沒有明確的房型組合。Transaction 訊息的 <Room Bundle> 區塊中 <RatePlanID> 元素的價格值，會設為使用者選取的隱含關聯房型組合價格。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在這個範例中，如果使用者選取客房套裝組合，就會產生下列網址：

https://partner.com/landing_room?hid=123

如果使用者未選取 Room Bundle，就會產生下列網址：

https://partner.com/landing?hid=123

IF-CLICK-TYPE-ROOM 範例

你可以建構條件區塊，查看使用者是否選取了房間套裝組合。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在這個範例中，如果使用者未選取 Room Bundle，就會產生下列網址：

https://partner.com/landing?hid=123

如果使用者選取客房套裝組合，就會產生下列網址：

https://partner.com/landing_room?hid=123

IF-DEFAULT-DATE 範例

使用 IF-DEFAULT-DATE 條件陳述式設定非日期參數，如果使用者未選取日期，網站就能使用該參數觸發自訂行為。

以下範例會檢查是否使用了預設日期：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

在這個範例中，如果使用者未選取日期，結果可能類似於下列網址，顯示預設日期選項：

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

如果使用者選取日期，結果可能會類似下列網址，具體取決於他們選取的行程：

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN 範例 (飯店廣告和免費預訂連結點擊)

你可以建構條件區塊，查看使用者點擊的廣告是否來自飯店廣告活動。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

在這個範例中，如果使用者點按飯店廣告活動網址，就會產生下列網址：

https://www.partner.com?hotelID=123&hotel_campaign=12345678

如果點擊的不是飯店廣告活動網址 (例如一般搜尋廣告活動)，則會產生下列網址：

https://www.partner.com?hotelID=123&utm_campaign=87654321

如果您想區分飯店廣告活動點擊流量與其他點擊，這項功能就相當實用。

免費預訂連結點擊次數的廣告活動 ID 為空白

如果點擊來自免費預訂連結，則 IF-HOTEL-CAMPAIGN 會傳回 TRUE，且 CAMPAIGN-ID 值會設為空白，如下列網址所示：

https://www.partner.com?hotelID=123&hotel_campaign=

您可以如以下範例所示，使用 IF-AD-CLICK 條件式陳述式，防止廣告活動 ID 為空白：

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-PROMOTED 範例 (僅限飯店廣告)

你可以建構條件區塊，查看使用者點擊的廣告是否為房源宣傳廣告。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

在這個範例中，如果使用者選取住宿宣傳廣告，就會產生下列網址：

https://partner.com/1?hid=123

如果使用者未選取住宿宣傳廣告，則會產生下列網址：

https://partner.com/0?hid=123

IF-RATE-RULE-ID 範例

你可以建構條件區塊，檢查使用者是否選取條件式費率，如果是，則使用交易訊息 <Rate> 區塊中 <RateRuleID> 元素的價值。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

在這個範例中，如果使用者未選取條件式費率，就會產生下列網址：

https://www.partner.com?hid=123

如果使用者選擇條件式費率，就會產生下列網址：

https://www.partner.com?hid=123&customerType=42

IF-USER-LIST-ID 範例 (在 Google Ads 中定義)

如果您在 Google Ads 的飯店廣告活動中為目標對象名單設定出價調節係數，可以搭配使用 IF-USER-LIST-ID 和 USER-LIST-ID，為屬於特定 Google Ads 目標對象名單的顧客，在網站上設定參數。您可能基於追蹤目的，或是為了向目標對象名單成員提供個人化網站體驗，而想這麼做。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

在這個範例中，如果使用者不是目標對象名單的成員，就會產生下列網址：

https://www.partner.com?hid=123

如果使用者是目標對象名單 12345678 的成員，結果會是下列網址：

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION 範例

如要檢查 Google 是否產生網址以進行測試或自動驗證，可以使用 IF-VERIFICATION。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

在本例中，如果 Google 未產生用於測試或驗證的網址，結果會是下列網址：

https://www.partner.com?hid=123

如果 Google 產生了用於測試或驗證的網址，結果會是下列網址：

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE 範例

您可以建構條件式區塊，填入飯店價格動態饋給中指定的每位兒童入住者的最大年齡。

以下是在到達網頁檔案中使用這個指令的範例：

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

在這個範例中，如果行程包含 2 位成人和 2 位兒童，年齡分別為 0 歲和 17 歲，則產生的網址如下：

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

如果行程包含 2 位成人和 0 位兒童，則結果會是下列網址：

https://www.partner.com?adults=2&children=0&hid=123

建立網址時的一般規則

所有變數都是選填。您不必在到達網頁網址中插入任何變數。不過，使用變數傳遞行程和使用者資訊通常能提供更優質的使用者體驗，並協助您遵守 Google 政策。

在到達網頁檔案中定義建構的網址時，請遵守下列一般規則：

• 所有變數都以左括號和右括號括住。

• 最終輸出內容中的查詢字串參數必須以 & 符號分隔。因為在 XML 中，連字號是特殊字元，而到達網頁檔案格式為 XML。因此，您必須改用編碼後的實體「&」。最終輸出內容會顯示實際的「&」字元。 例如：

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  您也必須對到達網頁網址中可能包含的特殊字元進行網址編碼。例如：

  • 空格 (「 」)：在 <URL> 元素中，將空格字元替換為「%20;」
  • 正斜線 (「/」)：在 <URL> 元素中，將正斜線替換為「%2F;」

  並非所有非英文字母的字元都必須經過網址編碼。舉例來說，連字號 (「-」) 不必進行網址編碼。如需必須進行網址編碼的常見字元清單，請參閱「網址編碼」。

• 單一參數的值可由多個變數建構而成。下列範例會從 CHECKINDAY、CHECKINMONTH 和 CHECKINYEAR 變數建構單一參數 checkinDate：

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  這個範例會產生類似下列的網址：

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• 查詢字串參數的名稱可以使用任何 ID。伺服器會處理這些值。不過，您傳遞的值僅限於可用變數清單。

• 除了可用變數清單外，您最多還可使用五個自訂變數。