Vrbo 站外連結
輕輕鬆鬆將 Vrbo 上 2 百萬間出租度假屋提供給您的旅客。
目前我們正和 Vrbo 合作,將透過 Rapid 為您和旅客提供 2 百萬間出租度假屋預訂。
出租度假屋空間寬敞、設施服務高級完善,能帶來不同於飯店的住宿享受,因此成為許多旅客的首選。出租度假屋的旅客通常入住時間較長,且平均預訂價值較高,因此值得多花心力吸引旅客。
出租度假屋
Vrbo 站外連結是一套整合容易的解決方案,能排除促銷出租度假屋時最主要的疑難,為您增加收益。旅客會先造訪您的網站,再導向 Vrbo 網站完成預訂;也就是旅客可在您的網站盡情瀏覽 Vrbo 上 2 百萬間出租度假屋,享受最佳使用者經驗。
Vrbo 可提供以下支援:
- 將旅宿資訊完整詳盡地傳達給旅客。
- 為旅客精選整理最相關的搜尋結果。
- 負責處理訂金和付款安排。
- 透過客戶服務工具解答旅客的疑問。
您還可和 Vrbo 聯合品牌,主打其購物和付款體驗;更可透過 Vrbo 報告系統來追蹤並查看交易記錄。
如何快速入門?
您可以根據想達成的系統開發程度,選擇以下三種整合方式。
1. 基本站外連結
將出租度假屋標籤超連結到您網站的導覽列,或在搜尋結果頁面新增度假屋的提示訊息框,把頁面重新導向 Vrbo 網站。此方式不需 API 整合,因此可立即提供出租度假屋預訂。
2. 出租度假屋登陸頁面小工具
用 Vrbo 搜尋小工具建立登陸頁面的好處是較能靈活運用,可在重新導向到 Vrbo 網站前,先提供旅客一些內容概要。此方式也不需要 API 整合,因此也可快速入門。
3. 出租度假屋登陸頁面小工具 + 搜尋結果
選擇了第 2 個方式後,您還可在網站上再建立一個搜尋結果頁面來顯示 Vrbo 上的旅宿。當旅客點擊出租度假屋查詢細節時,會被重新導向到 Vrbo 網站。
此方式需要整合 Rapid「內容 API」和「購物 API」。然而,選擇此方式將來獲益會更大,因為 Rapid 會開發更多 API 功能來取得 Vrbo 的支援。
Vrbo 站外連結整合指南
1. 一般
下方的整合說明假設使用者已取得 Rapid API,並且熟悉其操作。Vrbo 站外連結功能可透過 Rapid 內容與購物 API 取得。存取這項庫存需要取得核准並與 EPS、Vrbo 和 Partnerize 簽訂合約。取得核准後,Partner Connect 將啟用存取權限。
啟用前,需要審查 EPS 和 Vrbo 聯盟夥伴計畫之間的合作夥伴執行情況。如需查看啟動條件,請按此處。
1.1 API 流程
合作夥伴能夠透過多種方式將客戶連接到 Vrbo 結帳:
- 行銷活動橫幅/直接連接到 Vrbo 搜尋頁面。
- 搜尋小工具到 Vrbo 搜尋結果頁面。
- 整合 Rapid 內容/購物。從合作夥伴搜尋結果頁面連接到 Vrbo。
- 推薦目標:建議將所選旅宿釘選於 Vrbo 搜尋結果頁面最上方,即可獲取最佳預訂率。
- 備案目標:Vrbo 旅宿詳情頁面 (PDP)。Vrbo PDP 提供了 Rapid 無法提供的資訊與工具,例如額外庫存選項、旅宿管理者對話、費用明細、詳細付款安排和旅宿供應情況行事曆。
- 備案目標:Vrbo 結帳頁面。
- 請注意,結帳頁面無法提供出租度假屋旅客在 Vrbo PDP 上享有的所有功能,包括:
- 費用明細。
- 單位配置詳情,包括每個房間的床型。
- 付款時間表與完整的取消規定詳情。
- 旅宿管理者溝通。
- 首要旅宿識別碼。
- 供應情況行事曆。
- 請注意,結帳頁面無法提供出租度假屋旅客在 Vrbo PDP 上享有的所有功能,包括:
合作夥伴搜尋結果包括多達 1 百萬間能夠即時預訂的旅宿,但旅客能夠在站外連結後輕鬆查看 Vrbo 約 2 百萬間旅宿中其中一間。
1.2 旅客體驗
合作夥伴網站:旅客輸入搜尋條件。
合作夥伴網站:旅客評論與搜尋結果中的旅宿/價格相匹配。
合作夥伴網站:旅客被告知與 Vrbo 合作關係,並連接到 Vrbo 網站。
Vrbo:旅客查看所選旅宿以及其他 Vrbo 庫存 (SERP)。
Vrbo:旅客查看所選 (或備案) 旅宿詳情頁面。
- 查看房價詳情、規定、入住規則、供應情況行事曆和旅宿管理者資訊。
- 必要時,向旅宿管理者提出任何問題 (旅客聯絡資訊受到保護)。
Vrbo:旅客透過 Vrbo 結帳流程預訂。
- 查看付款安排、損壞押金和租賃合約。
- 提供聯絡資訊和付款詳情。
- 送出預訂。
- Vrbo 和/或第三方旅宿管理公司根據付款安排向信用卡收費。
Vrbo Post-Book:旅客收到 Vrbo 的確認電子郵件與說明和支援。
- 收到 Vrbo 和/或旅宿管理者的確認電子郵件。
- 在 Vrbo 網站上管理預訂 (向旅宿管理者提出任何問題、查看付款發票、付款安排或預付下次預定付款)。
- 若需取消預訂。
1.3 合作夥伴體驗
與 Partnerize/Vrbo 達成的協議提供了站外連結 URL 中使用的聯盟夥伴識別碼。
使用 Vrbo 庫存開發/測試 Rapid。
請求存取聯名品牌。
若需要,請求存取結帳忠誠度欄位與報告。
透過啟動條件檢查。
對合作夥伴支援團隊進行升級程序培訓 (請參閱下方的支援章節)。
確保旅客了解他們將被引導至另一個網站繼續購物和預訂。
存取 Partnerize 報告檢視旅客流量 (無 PII),包括點擊次數、預訂率數據與總計/合作夥伴毛利。
2. API
2.1 地理 API
- EPS Rapid 地理 API 支援 Vrbo 庫存。
2.2 Content 檔案
- 透過在請求中提供
beta=vrbo_srp
標頭,Vrbo 庫存即可在 Rapid Content 檔案顯示。 - 僅顯示 Vrbo 旅宿。
2.3 內容 API
- 能透過在請求中提供
beta=vrbo_srp
標頭,請求顯示 Vrbo 庫存。 - 僅顯示 Vrbo 旅宿。
- Vrbo 庫存注意事項:
- 旅宿名稱通常比較長,例如「步行即可到達梅亞普拉亞海灘的超棒出租公寓」。
- Vrbo 旅宿目前僅是單一單位。
- 旅宿管理者管理的通常是自己的私宅,因此維護隱私非常重要。以下兩項刻意模糊處理的屬性,是旅宿管理者在合作夥伴網站上出租旅宿的偏好設定,因此必須依照設定顯示:
- 當 Vrbo 旅宿地址標示為
obfuscation_required=true
時,我們會在 Content 回應中把街道名稱擋起來。然而,合作夥伴仍可顯示旅宿地址的城市/州別。
- 當 Vrbo 旅宿地址標示為
範例:
"obfuscated_coordinates": {
"latitude": 47.417954,
"longitude": 12.42106
},
"obfuscation_required": true
registry_number
是顯示全部出租度假屋庫存時的必要欄位,包含 Vrbo。請在該值出現時顯示。private_host_property
(屬性 ID 1073745102) 是顯示出租度假屋旅宿的必要欄位,故來自 Vrbo 的旅宿也一樣。所有歐洲銷售點皆須遵守此項規定。請在該值出現時顯示。
範例:
"general": {
"1073745021": {
"id": "1073745102",
"name": "Private host property"
},
- Vrbo 的旅宿可能不會有下列內容欄位:
- 旅宿評分 - Vrbo 旅宿目前尚無評分功能。
- 房型說明 - 不適用於獨立出租度假屋旅宿。檢視飯店簡介。
- 房價計畫 - 不適用 Vrbo 的旅宿。
- 房型層級資料 - 旅宿等級包含所有房型層級詳細資訊。
- 內容納入以下新欄位:
- 統計數字:
- 1073743378 臥室數量
- 1073743379 浴室數量
- 統計數字:
house_rules
- 簡述度假屋的規定,包括是否允許兒童入住、寵物規定、能否舉辦派對、是否禁煙等。
範例:
"policies": {
"house_rules": [
"Children welcome",
"No pets",
"No smoking",
"No parties or events"
]
},
- 一般簡介 - Vrbo 網站上許多旅宿管理者會提供關於度假屋的簡介。
範例:
「尋找獨特住宿?不妨入住位於基茨比厄爾附近奧拉赫的出租公寓。這間 2 房出租公寓不但舒適便利,還附設壁爐等特別設施。公寓距離哈寧卡姆滑雪區僅 1.3 英里,距基茨布和勒洪滑雪區 2.7 英里,距離基茨比厄爾網球場也僅 1.9 英里。現場附設室外網球場,讓您大展身手。此外還有電視,小朋友們一定會喜歡。住宿期間可使用現場停車位。」
- 旅宿管理者姓名、可使用的語言,以及圖片 URL。
範例:
"property_manager": {
"name": "HHD AG | INTERHOME",
"links": {
"image": {
"method": "GET",
"href": "https://imageseu-ssl.homeaway.com/vd2/files/vv/profiles/1165196_use_1564652167.png"
}
}
},
"spoken_languages": {
"de": {
"id": "de",
"name": "German"
},
"en": {
"id": "en",
"name": "English"
},
platform_property:TRUE
- 表示旅宿為平台旅宿 (Vrbo 是記錄商戶) 而不是 IPM 旅宿 (整合旅宿管理者與第三方記錄商戶)。這些資訊可用於按平台篩選旅宿,旅客將直接獲取 Vrbo 和 Vrbo 工具支援。針對預訂試用合作夥伴,這些資訊亦可用於限制平台旅宿的可預訂庫存。vrbo_srp_id
- 表示建立 Vrbo SRP 站外連結 URL 所需的 Vrbo 旅宿編號格式。
範例:
"vrbo_srp_id": "651.2748905.3300127",
listing_id
- 建立 PDP 站外連結 URL 所需。
範例:
"listing_id": "2748905",
listing_number
- 建立 PDP 站外連結 URL 所需。
範例:
"listing_number": "3300127",
listing_source
- 建立 PDP 站外連結 URL 所需。
範例:
"listing_source": "abritel",
unit_number
- 建立 CXO 站外連結 URL 所需。
範例:
"unit_number": "/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d",
2.4 購物 API
- 可以從供應情況 API 獲取 Vrbo 旅宿供應情況,包括價格資訊。
- 供應情況 API 顯示的總價應與旅客連接到 Vrbo.com 後看到的價格一致。
- 針對站外連結的合作夥伴,購物回應中的 Vrbo 庫存價格檢查連結將是空白。
- 購物回應的部分資料與 Vrbo 的旅宿無關,包括:
- 客房 (包括床組和入住人數)。
- 房價 (包括房價計畫設施服務和優惠房價說明)。
- 購物回應注意事項:
- 僅限單一客房預訂。不支援多間客房預訂,因為 Vrbo 網站上都是單一獨立度假屋。
- 不支援當天預訂 (因此會回傳「沒有空房」)。
- 支援的房價類型:
- 僅顯示純訂房價格,不顯示底價/淨價或套裝價格。
- 純訂房價格。
- 可能與 Vrbo 庫存無關的欄位:
- 客房編號
- 客房名稱
- 房價編號
- 可訂客房:Vrbo 旅宿永遠顯示為 0。
- 房價類型:Vrbo 旅宿只有一種房價類型,因為目前皆為獨立單位房型。
- 床組和配置:不適用於 Vrbo,因為沒有偏好選項。
- 訂金規定連結:尚未開放 Vrbo 預訂,稍後會在試用中公開。同時 (一旦開放預訂),應顯示新增的額外訊息,在預訂後告知旅客,Vrbo 或旅宿管理者將在確認電子郵件中提供完整的付款安排。
- 旅宿費用:不包含 Vrbo 庫存的住宿費用。
- 促銷 ID 和詳情:不適用於 Vrbo 庫存。
- 備案旅宿:與 Vrbo 庫存無關。
- 交叉銷售建議:與 Vrbo 庫存無關。
- 「購物回應」新增欄位:
property_fee
範例:
{
"type": "property_fee",
"value": "34.75",
"currency": "USD"
},
traveler_service_fee
範例:
{
"type": "traveler_service_fee",
"value": "30.25",
"currency": "USD"
}
refundable_damage_deposit
:透過信用卡向旅客收取的費用,也是付款時間表上的最後階段。如果預訂日期已近,且需立即支付 100% 房價,便可同時收取 RDD。若旅宿沒有任何損壞,RDD 會在旅客退房後約 10 天退款。
範例:
"fees": {
"refundable_damage_deposit": {
"request_currency": {
"value": "150.00",
"currency": "USD"
},
"billable_currency": {
"value": "150.00",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_stay"
}
},
card_on_file_fee
:使用存檔的旅客信用卡扣款而不收取 RDD,表示若旅宿遭損壞,Vrbo 有權直接從旅客提供的信用卡收費。
範例:
"fees": {
"card_on_file_fee": {
"request_currency": {
"value": "1382.74",
"currency": "USD"
},
"billable_currency": {
"value": "1000.00",
"currency": "GBP"
},
"scope": "per_accommodation",
"frequency": "per_stay"
}
},
2.5 其他
- 針對 Vrbo 站外連結合作夥伴,不支援下列 Rapid API:
- 訂金規定
- 付款選項
- 推薦 (交叉銷售/備案旅宿)
- 價格檢查
- 預訂
- 行程
- 無價差變更
- 取消
- 通知服務
3. Vrbo 站外連結 URL 建立
Vrbo 的連結由兩大部分組成:
Partnerize URL、包含 Partnerize 上線流程中收到的 camref。
Vrbo 目標 URL。
完整站外連結 URL 範例:
https://prf.hn/click/camref:12...
3.1 合作夥伴網址
請參閱 Partnerize 協議中從 Vrbo 收到的文件。本檔案將包含 Partnerize 連結格式更詳細的說明。
基本上,它採用以下格式:其中「##########」替換為從 Partnerize 收到的特定合作夥伴的 camref:
https://prf.hn/click/camref:##########/destination:
3.2 Vrbo 目標 URL
Vrbo 目標 URL 將根據您希望旅客進入 Vrbo 網站的頁面而有所不同。建議使用 SRP (釘選所選旅宿於頁面最上方的搜尋結果頁面) 選項,獲取最佳旅客預訂率,並存取最完整約 2 百萬間 Vrbo 旅宿。
**1. ** SRP:將所選旅宿釘選於搜尋結果頁面最上方。
好處:旅客將進入 Vrbo 搜尋結果頁面,所選旅宿置頂。他們有機會在地圖上確認旅宿的位置,並查看附近的其他旅宿 (擁有逾 2 百萬間 Vrbo 旅宿的完整選項,包括未立即確認的旅宿)。
範例:
**2. ** 旅宿詳情頁面 (PDP):旅客將進入所選旅宿詳情頁面。
範例:
**3. ** 結帳 (CXO):旅客將進入 Vrbo 結帳頁面。這是一個試用產品,應與 Partner Connect 討論。
3.3 連結建立
聯盟夥伴網路提供商 URL 建立
請參閱簽約聯盟夥伴追蹤供應商提供的建立 URL 文件。
釘選搜尋結果 (SRP)
SRP URL 由以下部分組成:
- 聯盟夥伴網路追蹤 URL
- Vrbo 基本 URL:https://www.vrbo.com/
- 非美國語言/銷售點 (請參閱附錄中的語言環境列表):en-ca/
- 日期:"results/arrival:[yyyy-mm-dd]/departure:[yyyy-mm-dd]
- 旅客:?adultsCount=3
- 置頂目標住宿:&pinnedPropertyListing=
- 品牌編號:321 (包含在
vrbo_srp_id
Rapid 內容內) - 刊登內容編號:4654022 (包含在
vrbo_srp_id
Rapid 內容內) - 刊登內容編號:5414675 (包含在
vrbo_srp_id
Rapid 內容內) - 針對非美國銷售點:&preferlocale=true
範例:
https://www.vrbo.com/results/arrival:2020-11-02/departure:2020-11-06?adultsCount=3&pinnedPropertyListing=121.4654022.5414675
非美國範例:
https://www.vrbo.com/en-ca/results/arrival:2020-11-02/departure:2020-11-06?adultsCount=3&pinnedPropertyListing=121.4654022.5414675&preferlocale=true
旅宿詳情頁面 (PDP)
SRP URL 由以下部分組成:
- 聯盟夥伴網路追蹤 URL
- Vrbo 基本 URL:https://www.vrbo.com/
- 非美國銷售點 (請參閱附錄中的語言環境列表):en-ca/
- **「p」**代表非美國銷售點
listing_id
- 刊登內容來源 (見底下附錄)。請注意美國和國際銷售點的後綴是不同的。
- 旅客:?adultsCount=[3]
- 日期:"&arrival:[YYYY-MM-DD]&departure:[YYYY-MM-DD]
範例:
https://www.vrbo.com/4809266ha?adultsCount=2&arrival=2021-04-19&departure=2021-04-22
非美國範例:
https://www.vrbo.com/en-gb/p4809266?adultsCount=2&arrival=2021-04-19&departure=2021-04-22
結帳頁面 (CXO)
CXO URL 由下列幾個部分組成:
- 聯盟夥伴網路追蹤 URL
- Vrbo 基本 URL:https://www.vrbo.com/
- 非美國語言/銷售點 (請參閱附錄中的語言環境列表):en-ca/
- "/td/tc/checkout/?"
vrbo_srp_id
- 刊登內容_單位:?unitLink=/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d"
- 日期:"&arrivaDatel:mm/dd/yyyy&departureDate=mm/dd/yyyyy
- 旅客:&adultsCount=[3]&childrenCount=[0]
範例:
https://www.vrbo.com/td/tc/checkout/121.210223.3004988?unitLink=/units/0000/51b4650b-8f69-4813-bf2e-0ec13f6502b5&arrivalDate=03/09/2021&departureDate=03/12/2021&adultsCount=2&childrenCount=0
非美國範例:
https://www.vrbo.com/en-gb/td/tc/checkout/121.210223.3004988?unitLink=/units/0000/51b4650b-8f69-4813-bf2e-0ec13f6502b5&arrivalDate=03/09/2021&departureDate=03/12/2021&adultsCount=2&childrenCount=0
4. 支援
客戶教育
做為站外連結流程環節之一,應告知客戶:
- 他們將被引導至另一個網站繼續購物和預訂。
- 使用 Vrbo 進行的預訂將得到 Vrbo 支援。旅客應參考與獲取客戶服務相關的 Vrbo 通訊,因為合作夥伴沒有預訂記錄,也沒有協助解決任何問題的工具。
API 整合
有關本文件中包含的主題以及與 Rapid 內容和購物 API 相關的問題,應直接向 EPS Partner Connect 客服專員提出。
Vrbo 連結和 Vrbo 購物體驗
與 Partnerize 連結、目標 Vrbo 頁面、聯名品牌或旅客的商店/書籍/預訂後體驗相關的問題,請聯絡專屬 Vrbo 聯盟夥伴團隊客服專員。
預訂後問題
與預訂相關的問題應直接向旅宿管理者提出 (聯絡詳細資訊請參閱預訂確認電子郵件) 或直接洽詢 Vrbo 客服專員。EPS 目前無法存取 Vrbo 支援工具,因此所有與預訂相關的問題都應直接洽詢 Vrbo 團隊。
報告
與購物及預訂報告相關的問題都應直接聯絡 Vrbo 聯盟夥伴團隊或您的 Partnerize 客服專員。
5. 附錄
支援語言:
支援貨幣:
基本 URL
下方的基本 URL 代表 Vrbo 連結中旅宿編號之前的連結部分。
銷售點 | locale | SRP 基本 URL |
---|---|---|
美國 | us-en | https://www.vrbo.com/ |
巴西 | pt-br | https://www.vrbo.com/pt-br/ |
加拿大 (英文) | en-ca | https://www.vrbo.com/en-ca/ |
加拿大 (法文) | en-ca | https://www.vrbo.com/fr-ca/ |
丹麥 | da-dk | https://www.vrbo.com/da-dk/ |
西班牙 | es-es | https://www.vrbo.com/es-es/ |
義大利 | li-it | https://www.vrbo.com/it-it/ |
墨西哥 | es-mx | https://www.vrbo.com/es-mx/ |
荷蘭 | nl-nl | https://www.vrbo.com/nl-nl/ |
挪威 | no-no | https://www.vrbo.com/no-no/ |
波蘭 | pl-pl | https://www.vrbo.com/pl-pl/ |
葡萄牙 | pt-pt | https://www.vrbo.com/pt-pt/ |
新加坡 | en-sg | https://www.vrbo.com/en-sg/ |
芬蘭 | fi-fi | https://www.vrbo.com/fi-fi/ |
瑞典 | sv-se | https://www.vrbo.com/sv-se/ |
英國 | en-gb | https://www.vrbo.com/en-gb/ |
奧地利 | de-at | https://www.vrbo.com/de-at/ |
希臘 | el-gr | https://www.vrbo.com/el-gr/ |
日本 | ja-jp | https://www.vrbo.com/ja-jp/ |
PDP URL 的旅宿編號後綴
美國 vrbo.com 旅宿編號 + 後綴
欄位:listing_source | 美國銷售點後綴 | 旅宿編號 + 後綴 | 完整 URL 範例 |
---|---|---|---|
vrbo | [無] | 899933 | https://www.vrbo.com/899933 |
abritel | a | 1340429a | https://www.vrbo.com/1340429a |
HomeAway_** | ha | 1223018ha | https://www.vrbo.com/1223018ha |
非美國 vrbo.com 旅宿編號 + 後綴
欄位:listing_source | 非美國銷售點後綴 | 旅宿編號 + 非美國後綴 | 完整 URL 範例 |
---|---|---|---|
vrbo | vb | 899933vb | https://www.vrbo.com/en-ca/p899933vb |
abritel | a | 1340429a | https://www.vrbo.com/en-ca/p1340429a |
HomeAway_** | [無] | 1223018 | https://www.vrbo.com/en-ca/p1223018 |
Vrbo Partnerize 連結指南可在此下載: