變數和條件

飯店廣告和免費的預訂連結包括到達網頁的連結，供使用者預訂房間。您可以定義 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 變數的值。

部分變數是價格動態饋給元素的子集。舉例來說，系統會從價格動態饋給中的單一 <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：使用者點選了房型套裝組合的商店資訊。
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 組合，套件 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 Bundle。
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 Bundle 清單，則會解析為 true，否則會解析為 false。
IF-CLOSE-RATE-RULE-IDS Optional 如果一或多個條件式費率因使用者不符合資格而無法使用，則會解析為 true，否則會解析為 false。根據預設，如果向使用者顯示不公開費率 ，則為 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 套裝組合的飯店。交易訊息的 <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 套裝組合。

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

<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

如要區分飯店廣告活動點擊流量和其他點擊的流量，這個方法就很實用。

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

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