變數和條件

飯店廣告和免費的預訂連結包括到達網頁連結，使用者點選後就能前往該頁面 可以預訂會議室。您可以指定 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 會將變數替換成實際值，確保網址包含動態資訊。舉例來說，如果使用者預訂的 自 2023 年 5 月 23 日起，飯店 42 為 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交易訊息 <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>

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

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 點擊的空白廣告活動 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 來設定 這個參數 目標對象名單。您可能會為了追蹤目的，或為目標對象名單成員自訂網站。

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

  您也必須為可能會納入到達網頁網址的特殊字元進行網址編碼。例如：

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

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

• 單一參數的值可透過多個變數建構。以下範例會從 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 做為查詢字串參數的名稱。您的伺服器會處理這些值。不過，您傳遞的值僅限於 可用變數清單。

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