酒店价格是指指定行程(即入住日期和住宿晚数的组合)的双人间最低价格。
概览
您为酒店或行程组合定义的价格是酒店搜索结果的核心。请务必确保价格是最新的、准确的且具有竞争力。
Google 通常会在显示搜索结果时使用价格缓存中的价格。每当您向 Google 发送包含价格更新的交易消息时,Google 都会缓存相应数据。
Google 还可以实时向您请求酒店广告账号的最新价格。当用户搜索特定酒店或行程组合时,Google 可以向您发送“实时”请求或实时价格查询消息。如果您在指定的时间范围内做出回应,则该价格可以显示在用户所请求行程的搜索结果中。Google 还会缓存实时价格查询的结果,以便在以后的请求中使用。
价格更新的大小
在设置客房价格时,您需要提供预订提前期和住宿时长 (LoS) 值,以及这些值与客房 ID 或房价方案 ID 的每种组合对应的价格。预订和 LoS 值默认如下:
- 最多可提前 330 天预订
- 最多可入住 30 晚
根据这些一般性准则,单个客房的价格可能需要多达 9,900 个单独的条目(330 * 30),每个条目对应于入住日期和晚数的每种组合。
下表展示了单个酒店的部分行程数据。矩阵中包含价格的每个单元格都表示一种入住日期和住宿晚数的行程组合;每种行程都表示 Google 向酒店请求的单独价值:
哪些酒店和行程会重新定价
Google 价格所对应的酒店由您的酒店列表定义。除非停用,否则酒店列表 Feed 中的所有酒店都会通过交易消息或实时价格查询(在某些情况下)重新定价。
更新价格
更新价格的一般流程如下:
仅限“价格更改”模式:Google 会向您的服务器发送提示请求消息。
仅限“价格更改”模式:您的服务器会通过提示响应消息来响应,该消息用于定义哪些酒店或行程组合应重新定价。
Google 会向您的服务器发送查询消息。查询消息包含 Google 需要价格的酒店 ID 和行程。
对于实时价格查询,Google 会指定一个时间限制,您必须在此时间限制内做出响应,酒店或行程才能显示在当前竞价中。
您的服务器会以定义新价格的交易消息做出响应。
Google 会使用交易消息中的价格数据更新其缓存。
如需详细了解拉取和更改价格,请参阅交付模式。
含交易消息的价格
如需为酒店或行程(入住日期与住宿晚数的组合)设置价格,请使用交易消息,并为每个行程添加一个 <Result>。
设置价格时,请遵循以下准则:
价格:为每个行程提供最低的双人入住价格。使用 Hotel Prices API 设置的价格与您网站上显示的价格不同,可能会让用户感到困惑,并导致预订量下降。
入住晚数:指定每个行程的住宿总价以及每晚价格。Google 会为您计算每晚价格。
政策:设置价格时,请遵守 Google 的价格精准政策。这要求 Google 搜索结果中显示的价格与最终预订价格没有明显差异。
全包式定价:若要符合向美国和加拿大最终用户显示在酒店详情中的条件,您的酒店通常必须将税费和其他费用与基础房价分开。如需了解详情,请参阅税费和其他费用政策。
舍入:请勿舍入价格、税费和手续费的值。
如需了解如何从酒店房源中移除酒店,请参阅移除房源。
价格消息
使用交易消息重新定价行程时,<Result> 的以下子元素是必需的:
<Property><Baserate><Tax><OtherFees><Checkin>(行程)<Nights>(行程)
您可以在交易消息中optionally包含 <Result> 的以下子元素:
<AllowablePointsOfSale><ChargeCurrency><Custom[1-5]><RoomBundle><RoomID>
如需详细了解这些元素,请参阅 <Transaction>。
价格示例
以下示例设置了 6 月 7 日入住的房间(默认双人入住)1 至 7 晚的价格:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">209.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">419.98</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">614.97</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>4</Nights>
<Baserate currency="USD">819.96</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>5</Nights>
<Baserate currency="USD">999.95</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>6</Nights>
<Baserate currency="USD">1193.94</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>7</Nights>
<Baserate currency="USD">1259.93</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
</Transaction>
每个 Transaction 消息可以包含任意数量的 <Result> 元素,只要消息的总大小不超过 100MB 即可。
价格更新频率
您应计划在价格发生变化时及时更新。具体的操作方法取决于您选择的“拉取”或“更改价格”价格信息更新方法。如需了解详情,请参阅选择配送模式。
您还可以配置 Google 向您发送实时价格查询的频率和数量。如需了解详情,请参阅实时价格查询。
全包价
您可以考虑使用全包式价格,而不是分项价格,具体取决于用户的地理位置。
全包价格包括客房基本费率的总价值,以及交易消息中 <Baserate> 元素中的税费和其他费用。Itemized 定价将价格分为 <Baserate>、<Taxes> 和 <OtherFees> 元素。
