飯店廣告和免費的預訂連結包括到達網頁連結,使用者點選後就能前往該頁面 可以預訂會議室。您可以設定 Google 建構連結的方式 有關使用者和行程的其他相關資訊。例如: 你可以加入飯店 ID、語言、貨幣代碼等 網址中的入住日期和入住日期。
總覽
您需要在到達網頁檔案中定義到達網頁網址。廣告或免費內容 預訂連結顯示後,網址中的動態資訊會替換成 實際價值如要在到達網頁網址中加入動態值,請使用 語法如下:
<URL>https://partner_url?param_id=(variable_name)</URL>
以下範例網址採用 Google 的變數名稱 實際的飯店 ID 及行程:
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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>
元素。計算其他變數
根據使用者的語言代碼和其他用戶端設定進行調整
網址變數
下表說明您可以使用哪些變數 建構到達網頁網址:
變數 | 建議/選用 | 說明 |
---|---|---|
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 | 指出使用者是否點擊了標準飯店的產品資訊
房價或客房套裝組合可能的值包括:
|
CLOSE-RATE-RULE-IDS | Optional (only applies if you are using conditional or private rates) | 針對已啟用費率的費率規範,並以半形逗號分隔的費率規範 ID 清單 而該資料或許能正常使用 微小的行動並特別留意 不公開費率 在顯示相對應的 UI 樣式時,一律在這裡填入 以便傳達給使用者 |
CUSTOM[1-5] | Optional | 在 <Result> 中定義的自訂欄位值
元素,每個自訂欄位的長度上限為 200 個字元。如要
資訊,請參閱
總覽
交易訊息中所述。使用自訂欄位時
ARI。 |
DATE-TYPE | Optional | 指出使用者是否選取預設日期或特定日期
搜尋中提供的日期。可能的值包括:
|
GOOGLE-SITE | Optional | 使用者查看飯店價格資料的 Google 資源。
可能的值包括:
|
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 | 指定
行程。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 就是指派給
元素中的 <RoomID> 元素
<RoomBundle> 或 <RoomData> 個方塊
。 |
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
促銷活動,這個變數的值會指派給已套用 如果您使用
費率規範,如果套用相應的費率規範,系統就會將這個變數的值指派給 |
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> 區塊如需更多資訊
參照
條件式費率:
注意:僅限條件式費率或不公開費率 不會顯示任何未隱藏的 Cookie |
USER-COUNTRY | Recommended | 雙字母
國家/地區代碼,表示使用者位置。這個
這項資訊是從使用者的用戶端設定擷取。適用對象
例如 US 或 FR |
USER-CURRENCY | Recommended | 由三個字母組成的貨幣代碼,用於表示使用者的當地幣別
貨幣。USER-CURRENCY 變數的值是
根據使用者的用戶端設定推斷。例如:USD
或 CAD 。 |
USER-DEVICE | Recommended | 使用者的裝置類型。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
使用者按下的商家資訊
Room Bundle,否則會解析為 false 。 |
IF-CLOSE-RATE-RULE-IDS | Optional | 如果一或多個條件式費率為 true ,就會解析為 true
不符合資格,否則會解析為
false 。預設值為 true
不公開費率
已向使用者顯示 UI 樣式。 |
IF-DEFAULT-RATE | Optional | 如果使用者點按飯店商家資訊,則會解析為 true
使用預設日期,否則會解析為 false 。 |
IF-HOTEL-CAMPAIGN | Optional | 如果使用者的點擊來源是 true
飯店廣告活動,否則會解析為 false 。這個
合作夥伴擁有多種廣告活動類型,因此可以特別留意。
來分配歸因資訊 |
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 成員,則會解析為 true
設定目標對像出價調節係數時指定的客戶名單 ID
清單,否則會解析為 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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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>
元素
並非所有非字母字元都必須經過網址編碼。例如: 連字號 (「-」) 不需要網址編碼。如要進一步瞭解 必須以網址編碼的字元, 網址編碼表:
- 空格 (「 」):以「%20;」取代空格字元在
單一參數的值可透過多個變數建構。 下列範例會從
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 做為查詢字串參數的名稱。您的伺服器 會處理這些值不過,您傳遞的值僅限於 可用變數清單。
除了可用清單,您還可以使用最多五個自訂變數 變數。