變數和條件

飯店廣告和免費預訂連結會附上到達網頁的連結，方便使用者預訂房間。您可以指定 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 範例

您可以建構條件區塊，檢查使用者是否選取了沒有明確房型組合的飯店。交易訊息 <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

如果使用者未選取房間組合，結果會是下列網址：

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

IF-CLICK-TYPE-ROOM 範例

您可以建構條件區塊，檢查使用者是否選取了 Room 套件。

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

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

在這個範例中，如果使用者未選取房間套裝組合，結果會是下列網址：

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

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

含有 FBL 點擊的空白 CAMPAIGN-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-PAYMENT-ID 範例 (僅限飯店廣告)

使用 IF-PAYMENT-ID 條件式陳述式，根據點擊是否來自 PPS 佣金計畫，變更網址。以下範例會檢查點擊是否來自 PPS 佣金計畫，並根據結果為 booking_source 參數指派值：

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

如果飯店是佣金計畫的一部分，則會產生下列其中一個網址：

• 如果 Google 尚未指派 IATA 編號：

  https://partner.com?hid=123&booking_source=commissions

• 如果 Google 已指派 IATA 編號：

  https://partner.com?hid=123&booking_source=01234567

否則，結果會是下列網址：

https://partner.com?hid=123&booking_source=cpc

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 做為查詢字串參數的名稱。您的伺服器會處理這些值。不過，您傳遞的值僅限於可用變數清單。

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