變數和條件

飯店廣告和免費的預訂連結包括到達網頁連結，使用者點選後就能前往該頁面 可以預訂會議室。您可以指定 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> 元素。計算其他變數 根據使用者的語言代碼和其他用戶端設定進行調整

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

網址變數

下表說明您可以使用哪些變數 建構到達網頁網址：

變數 建議/選用 說明
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-ADS-CLICK-SOURCE Optional 表示點擊的來源是 Google Ads。可能的值包括：
  • bl：付費預訂連結
  • tpa：旅遊促銷廣告
  • tfsa：搜尋廣告中的旅遊動態饋給
  • pm：最高成效廣告活動或旅遊專用最高成效廣告活動 目標廣告活動。

    • 注意：如果點擊源自 這個參數空白，不是 Google 搜尋 (而非 Google Ads)
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 會是 元素中的 <PackageID> 元素 <RoomBundle> 或 <PackageData> 個方塊 訊息內容。
PARTNER-CURRENCY Optional 由 <Baserate> 元素的 currency 屬性 。例如 USD 或 CAD 。
PARTNER-HOTEL-ID Recommended 飯店的專屬 ID，由飯店清單動態饋給中的 <id> 元素定義。
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 飯店價格動態饋給中的客房專屬 ID。換 那麼房間 ID 就是 <Result> 中的 <RoomID> 元素 封鎖。對於房型套裝組合，房型 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) 中 <RatePlanID> 元素定義的 ID 價格動態饋給的 <RoomBundle> 區塊<RatePlanID> 代表房型和套裝行程資料組合的專屬 ID。如要 資訊，請參閱 房型套裝組合。
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) 由 rate_rule_id 屬性中定義的 ID， 價格動態饋給的 <Rate> 區塊詳情請參閱「條件式費率」。

注意：系統只會顯示未隱藏的條件式費率或不公開費率。
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 產生， 測試或自動驗證如果連結已產生，則為 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 如果使用者點選房型套裝組合的房源資訊，會解析為 true；否則會解析為 false。
IF-CLOSE-RATE-RULE-IDS Optional 如果一或多個條件式費率為 true，就會解析為 true 不符合資格，否則會解析為 false。預設值為 true 不公開費率 已向使用者顯示 UI 樣式。
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 如果使用者點擊的費率為 true，就會解析為 true 取決於指定 PromoCode 的 ARI 促銷活動或費率規範 否則就會解析為 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>

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

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&amp;booking_source=commissions
  • 如果 Google 已指派 IATA 編號：
    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 來設定 這個參數 目標對象名單。您可能會為了追蹤目的，或為目標對象名單成員自訂網站。

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

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