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 上享有的所有功能，包括：
      • 費用明細。
      • 單位配置詳情，包括每個房間的床型。
      • 付款時間表與完整的取消規定詳情。
      • 旅宿管理者溝通。
      • 首要旅宿識別碼。
      • 供應情況行事曆。

合作夥伴搜尋結果包括多達 1 百萬間能夠即時預訂的旅宿，但旅客能夠在站外連結後輕鬆查看 Vrbo 約 2 百萬間旅宿中其中一間。

1.2 旅客體驗

1. 合作夥伴網站：旅客輸入搜尋條件。

2. 合作夥伴網站：旅客評論與搜尋結果中的旅宿/價格相匹配。

3. 合作夥伴網站：旅客被告知與 Vrbo 合作關係，並連接到 Vrbo 網站。

4. Vrbo：旅客查看所選旅宿以及其他 Vrbo 庫存 (SERP)。

5. Vrbo：旅客查看所選 (或備案) 旅宿詳情頁面。

   • 查看房價詳情、規定、入住規則、供應情況行事曆和旅宿管理者資訊。
   • 必要時，向旅宿管理者提出任何問題 (旅客聯絡資訊受到保護)。

6. Vrbo：旅客透過 Vrbo 結帳流程預訂。

   • 查看付款安排、損壞押金和租賃合約。
   • 提供聯絡資訊和付款詳情。
   • 送出預訂。
   • Vrbo 和/或第三方旅宿管理公司根據付款安排向信用卡收費。

7. Vrbo Post-Book：旅客收到 Vrbo 的確認電子郵件與說明和支援。

   • 收到 Vrbo 和/或旅宿管理者的確認電子郵件。
   • 在 Vrbo 網站上管理預訂 (向旅宿管理者提出任何問題、查看付款發票、付款安排或預付下次預定付款)。
   • 若需取消預訂。

1.3 合作夥伴體驗

1. 與 Partnerize/Vrbo 達成的協議提供了站外連結 URL 中使用的聯盟夥伴識別碼。

2. 使用 Vrbo 庫存開發/測試 Rapid。

3. 請求存取聯名品牌。

4. 若需要，請求存取結帳忠誠度欄位與報告。

5. 透過啟動條件檢查。

6. 對合作夥伴支援團隊進行升級程序培訓 (請參閱下方的支援章節)。

7. 確保旅客了解他們將被引導至另一個網站繼續購物和預訂。

8. 存取 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 回應中把街道名稱擋起來。然而，合作夥伴仍可顯示旅宿地址的城市/州別。

範例：

"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 的連結由兩大部分組成：

1. Partnerize URL、包含 Partnerize 上線流程中收到的 camref。

2. 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 由以下部分組成：

1. 聯盟夥伴網路追蹤 URL
2. Vrbo 基本 URL：https://www.vrbo.com/
3. 非美國語言/銷售點 (請參閱附錄中的語言環境列表)：en-ca/
4. 日期："results/arrival:[yyyy-mm-dd]/departure:[yyyy-mm-dd]
5. 旅客：?adultsCount=3
6. 置頂目標住宿：&pinnedPropertyListing=
7. 品牌編號：321 (包含在 vrbo_srp_id Rapid 內容內)
8. 刊登內容編號：4654022 (包含在 vrbo_srp_id Rapid 內容內)
9. 刊登內容編號：5414675 (包含在 vrbo_srp_id Rapid 內容內)
10. 針對非美國銷售點：&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 由以下部分組成：

1. 聯盟夥伴網路追蹤 URL
2. Vrbo 基本 URL：https://www.vrbo.com/
3. 非美國銷售點 (請參閱附錄中的語言環境列表)：en-ca/
4. **「p」**代表非美國銷售點
5. listing_id
6. 刊登內容來源 (見底下附錄)。請注意美國和國際銷售點的後綴是不同的。
7. 旅客：?adultsCount=[3]
8. 日期："&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 由下列幾個部分組成：

1. 聯盟夥伴網路追蹤 URL
2. Vrbo 基本 URL：https://www.vrbo.com/
3. 非美國語言/銷售點 (請參閱附錄中的語言環境列表)：en-ca/
4. "/td/tc/checkout/?"
5. vrbo_srp_id
6. 刊登內容_單位：?unitLink=/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d"
7. 日期："&arrivaDatel:mm/dd/yyyy&departureDate=mm/dd/yyyyy
8. 旅客：&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. 支援

客戶教育

做為站外連結流程環節之一，應告知客戶：

1. 他們將被引導至另一個網站繼續購物和預訂。
2. 使用 Vrbo 進行的預訂將得到 Vrbo 支援。旅客應參考與獲取客戶服務相關的 Vrbo 通訊，因為合作夥伴沒有預訂記錄，也沒有協助解決任何問題的工具。

API 整合

有關本文件中包含的主題以及與 Rapid 內容和購物 API 相關的問題，應直接向 EPS Partner Connect 客服專員提出。

Vrbo 連結和 Vrbo 購物體驗

與 Partnerize 連結、目標 Vrbo 頁面、聯名品牌或旅客的商店/書籍/預訂後體驗相關的問題，請聯絡專屬 Vrbo 聯盟夥伴團隊客服專員。

預訂後問題

與預訂相關的問題應直接向旅宿管理者提出 (聯絡詳細資訊請參閱預訂確認電子郵件) 或直接洽詢 Vrbo 客服專員。EPS 目前無法存取 Vrbo 支援工具，因此所有與預訂相關的問題都應直接洽詢 Vrbo 團隊。

報告

與購物及預訂報告相關的問題都應直接聯絡 Vrbo 聯盟夥伴團隊或您的 Partnerize 客服專員。

5. 附錄

支援語言：

支援貨幣：

基本 URL

下方的基本 URL 代表 Vrbo 連結中旅宿編號之前的連結部分。

PDP URL 的旅宿編號後綴

美國 vrbo.com 旅宿編號 + 後綴

非美國 vrbo.com 旅宿編號 + 後綴

Vrbo Partnerize 連結指南可在此下載: