VRBO Link-Off

消除障碍，向您的旅客展示来自 Vrbo 的 200 万处度假短租。

我们正在和 Vrbo 合作，通过 Rapid 向您和您的旅客提供 200 万处度假短租。

旅客选择度假短租，是为了享受更大的空间、豪华的服务设施和更好的体验，而酒店往往无法满足这些需求。通常，这类旅客的入住时间更长，平均订单价值更高。因此，为什么不向您的旅客提供更多理想的度假短租呢？

度假短租屋

VRBO Link-Off 是一个易于集成的解决方案，可以增加您的度假短租收入，同时消除出售度假短租时面临的主要挑战。旅客会先浏览您的网站，然后被重定向至 Vrbo 网站完成预订。这能让他们访问 Vrbo 上 200 万住宿中的任意一处，为旅客提供更好的用户体验。

Vrbo 将会：

• 显示旅客须知的所有住宿信息。
• 精选并分类住宿，确保向旅客展示最相关的结果。
• 处理押金和付款安排事宜。
• 通过客户支持工具解答旅客咨询。

您甚至可以联名 Vrbo，为客户提供 Vrbo 的选购和付款体验，并且通过 Vrbo 报告功能跟踪和访问所有客户交易。

如何开始？

下面共有三种集成方式供您选择，选择哪项取决于您希望开发做到什么水平：

1. 基础 Link-Off 方案

您可以将度假短租的选项卡超链接到您网站的导航栏上，或者在您的搜索结果中添加能够重定向至 Vrbo 网站的度假短租提示。该选项无需任何 API 集成，也就是说您现在就可以开始提供度假短租。

2. 度假短租着陆页面小工具

创建使用 Vrbo 搜索小工具的着陆页面，您可以在旅客被重定向至 Vrbo 之前，更灵活地向他们提供背景信息。该选项同样无需任何 API 开发，可确保您尽快开始业务。

3. 度假短租着陆页面小工具 + 搜索结果

您还可以在您的网站上创建搜索结果页面用于显示 Vrbo 住宿，作为选项 2 的补充。若旅客希望了解更多信息，点击度假短租，他们将被重定向至 Vrbo 网站。

该选项需要集成 Rapid 的内容 API 和选购 API。无论您选择哪种方案，随着将来 Rapid 针对 Vrbo 供应开发出更多的 API 功能，您现在的投资都可以进一步扩展。

VRBO Link-Off 集成指南

1. 概况

使用以下集成说明需先获得并熟悉 Rapid API。VRBO Link-Off 功能可通过 Rapid 内容 API 和选购 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 上享受的全部功能，如：
      • 费用明细。
      • 单元配置详细信息，包括每个房间的床型。
      • 付款安排和完整的取消政策详情。
      • 物业经理沟通。
      • 高级住宿标识符。
      • 房态日历。

合作伙伴搜索结果中能包含多达 100 万个即时可订的住宿，但在使用 Link-Off 后，客户可以轻松随意查看 Vrbo 的约 200 万个住宿。

1.2 旅客体验

1. 合作伙伴网站：住客输入搜索条件。

2. 合作伙伴网站：在搜索结果中，住客点评会匹配住宿/价格。

3. 合作伙伴网站：住客可获得 Vrbo 关系信息，并链接到 Vrbo 的网站。

4. Vrbo：住客查看所选住宿以及其他 Vrbo 库存 (SERP)。

5. Vrbo：住客查看所选（或备选）住宿详细信息页面。

   • 查看房价详情、政策、租房规定、房态日历和物业经理信息。
   • 如有需要，可直接联系物业经理咨询问题（住客联系信息受保护）。

6. Vrbo：住客通过 Vrbo 付款流程进行预订。

   • 查看付款安排、损坏押金和租房协议。
   • 提供联系信息和详细付款信息。
   • 提交预订。
   • Vrbo 和/或第三方住宿管理公司根据付款安排从卡中收取费用。

7. Vrbo 预订后：住客收到 Vrbo 的确认通知和支持。

   • 接收来自 Vrbo 和/或物业经理的确认邮件。
   • 在 Vrbo 网站上管理预订（向物业经理咨询问题、查看付款发票、付款安排或预付下一个安排的付款）。
   • 根据需要取消预订。

1.3 合作伙伴体验

1. 与 Partnerize/Vrbo 达成协议，提供在 Link-Off URL 中使用的联盟伙伴标识符。

2. 使用 Vrbo 库存开发/测试 Rapid。

3. 请求访问联合品牌。

4. 如有需要，请求访问付款忠诚度字段和报告。

5. 准许上线要求审核。

6. 就上报程序对合作伙伴支持团队进行培训（请参阅以下支持部分）。

7. 确保顾客了解他们将被转至另一个网站以继续选购和预订。

8. 访问 Partnerize 报告以查看客户流量（无 PII），包括点击次数、转化数据和总利润/合作伙伴利润。

2. API

2.1 地理 API

• EPS Rapid 地理 API 为 Vrbo 库存提供支持。

2.2 内容文件

• 在请求中提供 beta=vrbo_srp 标头，Vrbo 库存可在 Rapid 内容文件中显示。
• 仅会返回 Vrbo 住宿。

2.3 内容 API

• 在请求中提供 beta=vrbo_srp 标头，可请求 Vrbo 库存。
• 仅会返回 Vrbo 住宿。
• Vrbo 库存注意事项：
  • 住宿名称通常较长，例如“步行即可抵达美丽的梅亚普莱亚海滩的梦幻公寓”。
  • Vrbo 住宿目前仅为独立单元。
  • 物业经理经常管理自己的私人住宅，因此维护隐私至关重要。这两个模糊特质反映了物业经理在合作伙伴网站上分销其住宿的偏好，并且必须得到反映：
    • 对于 Vrbo 住宿，当地址 obfuscation_required=true 时，则不在内容响应中显示街道地址，但合作伙伴仍然可以显示地址的城市/州部分。

示例：

"obfuscated_coordinates": {
                "latitude": 47.417954,
                "longitude": 12.42106
            },
"obfuscation_required": true

• registry_number 是显示所有度假短租库存（包括 Vrbo）的必需字段。若存在此值，请显示。
• private_host_property（属性 ID 1073745102）是度假短租住宿显示的必需字段，也适用于 Vrbo。所有欧洲 POSa 都需要。若存在此值，请显示。

示例：

"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 住宿都包含物业经理提供的住宿介绍。

示例：

“想寻找与众不同的体验？入住出租式公寓可能是您前往 Aurach bei Kitzbuehel 旅行的正确选择。这间双卧室出租式公寓独具特色，带壁炉等设施，可让您尽享舒适和便利。这里距离 Hahnenkamm Ski Area 1.3 英里，距离 Kitzbueheler Horn Ski Area 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 Link-Off URL 构建所需格式的 Vrbo 住宿编号。

示例：

"vrbo_srp_id": "651.2748905.3300127",

• listing_id - 这是构建 PDP Link-Off URL 必需的。

示例：

"listing_id": "2748905",

• listing_number - 这是构建 PDP Link-Off URL 必需的。

示例：

"listing_number": "3300127",

• listing_source - 这是构建 PDP Link-Off URL 必需的。

示例：

"listing_source": "abritel",

• unit_number - 这是构建 CXO Link-Off URL 必需的。

示例：

"unit_number": "/units/0002/c82d1ea6-7953-4984-baba-1664f8ded95d",

2.4 选购 API

• Vrbo 住宿房态可以通过房态 API 获取，包括定价信息。
• 房态 API 返回的总价应与旅客转至 Vrbo.com 后所看到的一致。
• 对于 Link-Off 合作伙伴来说，Vrbo 库存的选购响应中的价格检查链接将为空白。
• 选购响应中的一些信息与 Vrbo 住宿无关，包括：
  • 客房（包括床组和入住人数）。
  • 房价（包括房价计划服务设施和特别优惠说明）。
• 选购响应注意事项：
  • 仅限单间客房。不支持多间客房预订，因为 Vrbo 住宿仅提供单向可售客房。
  • 不支持当日预订（不返回任何房态信息）。
  • 支持的房价类型：
    • 仅支持标准房价，不支持基础房价/净房价或套餐。
    • 仅支持纯房价。
  • 可能与 Vrbo 库存无关的字段：
    • 客房 ID
    • 客房名称
    • 房价 ID
    • 可订空房：对于 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 Link-Off 合作伙伴，不支持以下 Rapid API：
  • 订金政策
  • 付款方式
  • 推荐（交叉销售/替代住宿）
  • 价格检查
  • 预订
  • 行程
  • 软性变更
  • 取消
  • 通知服务

3. VRBO Link-Off URL 构建

Vrbo 的链接由两部分组成：

1. Partnerize URL，包括作为 Partnerize 上线流程一环收到的 camref。

2. Vrbo 目标 URL。

完整的 Link-Off URL 示例：

https://prf.hn/click/camref:12...

3.1 Partnerize URL

请参阅从 Vrbo 收到的 Partnerize 协议中的文件。本文档将包含有关 Partnerize 链接格式的更详细说明。

基本上采用以下格式：其中“##########”替换为从 Partnerize 收到的特定合作伙伴的 camref：

https://prf.hn/click/camref:##########/destination：

3.2 Vrbo 目标 URL

Vrbo 目标 URL 根据您希望旅客在 Vrbo 网站上登录的位置而有所不同。建议使用 SRP（搜索结果页面，所选住宿固定在顶部）选项以获得理想的住客转化，并支持访问全部约 200 万个 Vrbo 住宿。

**1. ** SRP：搜索结果页面，所选住宿固定在顶部。

优势：旅客将转至 Vrbo 搜索结果页面，所选住宿位于顶部。他们可以在地图上确认住宿的位置，并查看附近的其他住宿（来自 Vrbo 住宿全部 200 多万个选择，包括未即时确认的住宿）。

示例：

2. 住宿详细信息页面 (PDP)：住客将登录所选住宿的详细信息页面。

示例：

3. 付款 (CXO)：住客将登陆 Vrbo 付款页面。这是一款试行服务功能，应与 Partner Connect 讨论。

3.3 链接构建

联盟伙伴网络提供商 URL 构建

请参阅签约联盟伙伴跟踪提供商提供的 URL 构成文档。

固定搜索结果 (SRP)

SRP URL 由以下部分组成：

1. 联盟伙伴网络跟踪 URL
2. Vrbo 基本 URL：https://www.vrbo.com/
3. 非美国语言/POSa（参见附录中的 Locale 列表）：en-ca/
4. 日期："results/arrival:[yyyy-mm-dd]/departure:[yyyy-mm-dd]
5. 住客：?adultsCount=3
6. 要固定到顶部的目标住宿：&pinnedPropertyListing=
7. 品牌 ID：321.（包含在 vrbo_srp_id 内的 Rapid 内容中）
8. 房源 ID：4654022.（包含在 vrbo_srp_id 内的 Rapid 内容中）
9. 房源编号：5414675（包含在 vrbo_srp_id 内的 Rapid 内容中）
10. 对于非美国 POSa：&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. 非美国 POSa（参见附录中的 Locale 列表）：en-ca/
4. **“p”**代表非美国 POSa
5. listing_id
6. 房源来源后缀（见下面的附录）。请注意，美国和国际 POSa 的后缀不同。
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. 非美国语言/POSa（参见附录中的 Locale 列表）：en-ca/
4. “/td/tc/checkout/?”
5. vrbo_srp_id
6. Listing_unit：?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. 支持

客户指导

作为 Link-Off 流程的一环，应告知客户：

1. 他们将被转至 Vrbo 网站以继续选购和预订。
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 链接指南可在此处下载。