變數和條件

飯店廣告和免費的預訂連結會包含可供使用者預訂房間的到達網頁連結。您可以定義 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> 元素。同樣地，PARTNER-HOTEL-ID 變數的值也會在符合使用者搜尋條件的飯店清單動態饋給的 <id> 元素中定義。

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

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

網址變數

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

變數 建議/選用 說明
ADVANCE-BOOKING-WINDOW Optional 預訂日期在入住日期前的提前預訂天數 (以飯店所在時區為準)。例如 36。
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) 房源的備用 ID。您可以在飯店清單動態饋給中指定這個屬性名稱。如果你的動態饋給資訊需要一個房源 ID，並替預訂引擎設定另一個房源 ID，則採用各不相同的專屬 ID 會有所幫助。
CAMPAIGN-ID Recommended 想要與網址建立關聯的 Google Ads 廣告活動 ID。如果點擊與 Google Ads 廣告活動無關，這個欄位就會空白。
CHECKINDAY Recommended 飯店價格動態饋給的 <Checkin> 元素中定義的兩位數日期。例如 20。
CHECKINDAY-OF-WEEK Optional 星期幾 (Monday 至 Sunday)，入住時間 (以飯店所在時區為準)。例如：Tuesday。
CHECKINMONTH Recommended 飯店價格動態饋給的 <Checkin> 元素中定義的二位數月份。例如 05。
CHECKINYEAR Recommended 飯店價格動態饋給的 <Checkin> 元素中定義的四位數年份。例如 2023。
CHECKOUTDAY Recommended 以飯店價格動態饋給的 <Nights> 和 <Checkin> 元素計算得出的兩位數日期。例如：26。
CHECKOUTMONTH Recommended 由飯店價格動態饋給的 <Nights> 和 <Checkin> 元素計算而得的二位數月份。例如：05。
CHECKOUTYEAR Recommended 四位數年份，依據飯店價格動態饋給的 <Nights> 和 <Checkin> 元素計算得出。例如：2023。
CHILD-AGE Recommended (must be provided for child occupancy pricing) 價格動態饋給的 <Child "age"> 元素中指定的每個子項最長年齡。這個變數必須與 FOR-EACH-CHILD-AGE 條件式區塊搭配使用。
CHILD-INDEX Optional 0 索引的迴圈變數，代表行程中指定每個子項乘客和子項年齡的計數器。雖然此變數並非必要，但只能搭配 FOR-EACH-CHILD-AGE 條件式區塊使用。
CLICK-TYPE Optional 指出使用者是否點選了標準飯店房價或房型套裝組合產品資訊。可能的值包括：
  • hotel：使用者點按標準房價的產品資訊。
  • room：使用者點選的 Room 套裝組合產品資訊。
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) 針對無法取得的費率，使用逗號分隔的費率規範 ID 清單，但如果使用者未採取輕微動作，就可能可用。請注意，如果使用者看到對應的 UI 實驗組，系統一律會在這裡填入不公開費率的費率規範 ID。
CUSTOM[1-5] Optional 在 <Result> 元素中定義的自訂欄位值，每個自訂欄位最多 200 個半形字元。詳情請參閱「交易訊息總覽」。使用 ARI 時無法使用自訂欄位。
DATE-TYPE Optional 指出使用者選取的是預設日期還是搜尋中的特定日期。可能的值包括：
  • default：使用者點選預設日期使用的飯店廣告或免費的預訂連結。
  • selected：使用者點擊設有日期的飯店廣告或免費預訂連結。
GOOGLE-SITE Optional 使用者查看飯店價格資料的 Google 資源。 可能的值包括：
  • localuniversal：使用者透過 google.com 搜尋找到飯店預訂連結。
  • mapresults：使用者透過 maps.google.com 找到飯店預訂連結。
  • verification：Google 在網站上執行自動化資料品質測試時，會使用這個值。系統不會向您收取這些查詢的費用。Google Analytics (分析) 可以使用這項參數及其值，識別飯店廣告自動驗證流量。
  • unknown：使用者透過不明來源找到廣告或免費的預訂連結。
LENGTH Recommended 入住天數取決於飯店價格動態饋給中 <Nights> 元素定義的住宿天數。例如：3。
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) 使用者為行程指定的成人入住數量。 這個變數必須與 NUM-CHILDREN 和/或 FOR-EACH-CHILD-AGE 搭配使用。
NUM-CHILDREN Recommended 使用者在行程中指定的子項可住人數 (0 至 17 歲)。NUM-CHILDREN 和/或 FOR-EACH-CHILD-AGE 必須同時參與兒童可住人數的行程。
NUM-GUESTS Recommended (if you don't send child occupancy pricing) 使用者為行程指定的可住人數 (成人和兒童總數)。這個值是 NUM-ADULTS 和 NUM-CHILDREN 值的總和。如要盡可能提高參與度，強烈建議您同時使用 NUM-ADULTS 和 NUM-CHILDREN。
PACKAGE-ID Recommended (applies if you use Room Bundles) 飯店價格動態饋給中包裹的專屬 ID。如果是標準套件，套件 ID 是 <Result> 區塊中 <PackageID> 元素的值。如果是 Room Bundle，套件 ID 是指交易訊息 <RoomBundle> 或 <PackageData> 區塊中 <PackageID> 元素的值。
PARTNER-CURRENCY Optional 飯店價格動態饋給中 <Baserate> 元素的 currency 屬性定義了 3 個字母的貨幣代碼。例如 USD 或 CAD 。
PARTNER-HOTEL-ID Recommended 飯店清單動態饋給中 <id> 元素定義的飯店專屬 ID。
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 飯店價格動態饋給中客房的專屬 ID。如果是標準房間，房間 ID 是 <Result> 區塊中 <RoomID> 元素的值。以 Room Bundle 來說，房間 ID 是指在交易訊息的 <RoomBundle> 或 <RoomData> 區塊內指派給 <RoomID> 元素的值。
PAYMENT-ID Optional (only applies to Ads) 如果您使用佣金收款代理機構，則會解析為預先定義的字串 commission 或 Google 指派的 IATA 號碼 (例如「01234567」)。如要變更 IATA 號碼或預先定義字串的格式，請與您的客戶技術顧問 (TAM) 聯絡。
PRICE-DISPLAYED-TAX (Optional) 向使用者顯示的稅額，以使用者當地幣別顯示。PRICE-DISPLAYED-TAX 的值是飯店價格動態饋給中 <Tax> 元素的值。例如「3.14」。
PRICE-DISPLAYED-TOTAL (Optional) 向使用者顯示的客房總費用，以使用者當地幣別顯示。PRICE-DISPLAYED-TOTAL 的值是飯店價格動態饋給中 <Baserate>、<Tax> 和 <OtherFees> 元素的總和。 例如「152.13」。
PROMO-CODE (Optional)

如果使用 ARI 促銷活動，系統會將這個變數的值指派給已套用 <Promotion> 的 id 屬性。如果已套用多個促銷活動，則會以任意順序排列促銷 ID 的清單 (以半形逗號分隔)。

如果使用 費率規範，如果套用了相應的費率規範，系統會將這個變數的值指派給 PromoCode 元素。
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) 在價格動態饋給的 <RoomBundle> 區塊中，<RatePlanID> 元素定義的 ID。<RatePlanID> 代表房間和套件資料組合的專屬 ID。詳情請參閱「 Room 套件」。
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) 價格動態饋給 <Rate> 區塊中 rate_rule_id 屬性定義的 ID。詳情請參閱 條件式費率。
USER-COUNTRY Recommended 雙字母的國家/地區代碼，指出使用者位置。這項資訊會擷取自使用者的用戶端設定。例如 US 或 FR。
USER-CURRENCY Recommended 由三個字母組成的貨幣代碼，用來表示使用者的當地幣別。USER-CURRENCY 變數的值是從使用者的用戶端設定推測得出。例如 USD 或 CAD 。
USER-DEVICE Recommended 使用者的裝置類型。USER-DEVICE 的值可以是下列任一值：
  • mobile
  • tablet
  • desktop
  • unknown

USER-DEVICE 變數的值是從使用者的用戶端設定推測得出。
USER-LANGUAGE Recommended 雙字母 ISO 639-1 語言代碼，用來指定廣告或免費預訂連結的顯示語言。USER-LANGUAGE 變數的值是從使用者的用戶端設定推測得出。例如 en 或 fr。
USER-LIST-ID (在 Google Ads 中定義) Optional (only applies if you use Audience Lists in Google Ads) 內含目標對象名單或使用者資訊的 Google Ads 使用者名單 ID。使用目標對象名單做為設定出價調整幅度的基礎。如果使用者屬於多份目標對象名單，系統會選取出價調整幅度最大的目標對象名單。系統會隨機決定出價調整幅度幅度最大的目標對象。
VERIFICATION Optional 檢查 Google 是否為了測試或自動驗證而產生連結的布林值。如果連結是由 Google 為了測試或自動驗證而產生，則為 true，否則為 false。

網址中的條件邏輯

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

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

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

  • for_statement：建立 FOR 迴圈條件，針對提供的值進行疊代作業。

IF 和 FOR 陳述式包括：

條件 建議/選用 說明
IF-AD-CLICK (僅限飯店廣告) Optional 如果點擊來自廣告，會解析為 true。當使用者點擊來自免費的預訂連結時，此函式會解析為 false。
IF-CLICK-TYPE-HOTEL Optional 如果使用者點選飯店商家資訊，則會解析為 true，否則會解析為 false。
IF-CLICK-TYPE-ROOM Optional 當使用者點選 Room 套裝組合的產品資訊時，會解析為 true，否則會解析為 false。
IF-CLOSE-RATE-RULE-IDS Optional 如果使用者不符合資格，因而無法使用一或多項條件式費率，就會解析為 true，否則會解析為 false。根據預設，如果系統向使用者顯示不公開費率 UI 處理方式，則預設值為 true。
IF-DEFAULT-RATE Optional 如果使用者在點選預設日期使用的飯店資訊，則會解析為 true，否則會解析為 false。
IF-HOTEL-CAMPAIGN Optional 如果使用者點擊來自飯店廣告活動，則會解析為 true，否則會解析為 false。如果合作夥伴在 Google Ads 中有多種廣告活動類型來分配歸因，這項差異就非常實用。
IF-PAYMENT-ID (僅限飯店廣告) Recommended (if you use pay-per-stay Google Ads campaigns) 至於採用按入住付費 (PPS) 佣金計畫的飯店，飯店會解析為 true，否則會解析為 false。
IF-PROMO-CODE Optional 如果使用者點選根據 ARI 促銷活動或具有指定 PromoCode 的費率規範點選的費率，就會解析為 true；否則會解析為 false。
IF-PROMOTED (僅限飯店廣告) Recommended (if you use Promoted hotels) 如果使用者點按住宿宣傳廣告，就會解析為 true，否則會解析為 false。
IF-RATE-RULE-ID Optional 如果使用者選取條件式費率 ，就會解析為 true，否則會解析為 false。
IF-USER-LIST-ID (在 Google Ads 中定義) Optional 如果使用者是您在設定目標對象名單出價調節係數時指定的 Google Ads 顧客名單 ID 成員， 會解析為 true。 否則會解析為 false。
IF-VERIFICATION Optional 如果連結是由 Google 為進行測試或自動驗證而產生，則會解析為 true；否則會解析為 false。
ELSE Recommended (if you use any conditional IF statements) 如果未符合先前的條件，系統會將遵循該條件的值插入網址中。
END-IF Optional (required if you have any IF conditional statements) 結束 IF 陳述式條件式區塊。
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) 針對價格動態饋給中的每個 <Child "age"> 元素執行一次。舉例來說，如果 <OccupancyDetails> 包含 <Child age="17"> 和 <Child age= "17"> 這兩個元素，則指令會執行兩次。
END-FOR-EACH Optional (required if using FOR-EACH block) 結束 FOR-EACH 陳述式條件式區塊。

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>

在這個範例中，如果使用者選取 Room Bundle，結果為以下網址：

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

如果使用者未選取 Room Bundle，則結果為以下網址：

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

IF-CLICK-TYPE-ROOM 範例

您可以建立條件式區塊，檢查使用者是否選取 Room Bundle。

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

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

在此範例中，如果使用者未選取 Room 套裝組合，則結果為以下網址：

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

如要區分飯店廣告活動點擊的流量和其他點擊的流量，這項功能就能派上用場。

含有 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&amp;booking_source=commissions
  • 如果 IATA 號碼已指派給 Google：
    https://partner.com?hid=123&amp;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。因此，您必須使用編碼實體「&amp;」。最終的輸出內容會轉譯實際的「&」字元。例如：

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

    您也必須針對在到達網頁網址中加入的特殊字元進行網址編碼。例如：

    • 空格 (「 」)：將 <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 做為查詢字串參數的名稱。您的伺服器會處理這些值。不過，您傳送的值僅限於可用變數清單。

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