變數和條件

飯店廣告和免費的預訂連結包括到達網頁連結，使用者點選後就能前往該頁面 可以預訂會議室。您可以設定 Google 建構連結的方式 有關使用者和行程的其他相關資訊。例如： 你可以加入飯店 ID、語言、貨幣代碼等 網址中的入住日期和入住日期。

總覽

您需要在到達網頁檔案中定義到達網頁網址。廣告或免費內容 預訂連結顯示後，網址中的動態資訊會替換成 實際價值如要在到達網頁網址中加入動態值，請使用 語法如下：

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

以下範例網址採用 Google 的變數名稱 實際的飯店 ID 及行程：

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

建立搜尋結果網頁的到達網頁連結時，Google 將變數替換成實際值，以確保網址包含 動態資訊舉例來說，如果使用者預訂的 自 2023 年 5 月 23 日起，飯店 42 為 6 晚，Google 會顯示前一個連結 如下所示：

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

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

舉例來說，LENGTH 變數的值指派給 <Nights> 元素 擷取自相關行程的價格動態饋給同樣地， 已在飯店清單的 <id> 元素中定義 PARTNER-HOTEL-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> 元素 交易訊息的「<Room Bundle>」區塊會間接設為 使用者選取的相關聯房型套裝組合價格。

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

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

在此範例中，如果使用者選取 Room Bundle，結果如下： 網址：

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

如果使用者選取 Room Bundle，結果會是以下網址：

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

如要區分飯店廣告活動點擊的流量，這項功能就相當實用 不會高於 60%

含有 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：

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

• 如果 IATA 號碼已指派給 Google：

  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 範例

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

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

<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 來設定 這個參數 目標對象名單。建議您進行追蹤或是自訂 目標對象名單成員網站

<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)&nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  您也必須將 到達網頁網址。例如：

  • 空格 (「 」)：以「%20;」取代空格字元在 <URL> 元素中
  • 正斜線 (「/」)：以「%2F」取代正斜線<URL> 元素

  並非所有非字母字元都必須經過網址編碼。例如： 連字號 (「-」) 不需要網址編碼。如要進一步瞭解 必須以網址編碼的字元， 網址編碼表：

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

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

  這個範例產生的網址可能如下所示：

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

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

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