酒店价格是指定行程中双人间的最低价格,由入住日期和住宿晚数共同计算。
概览
您为酒店或行程组合定义的价格是酒店搜索结果的核心。保持价格的新鲜度、准确性和竞争力非常重要。
在显示搜索结果时,Google 通常会使用其价格缓存中的价格。每当您向 Google 发送包含价格更新的事务消息时,Google 都会缓存该数据。
对于酒店广告帐号,Google 还可以实时请求您提供更新后的价格。当用户搜索特定酒店或行程组合时,Google 可以向您发送“实时”请求或实时价格查询消息。如果您在指定的时间范围内响应,该价格可能会显示在用户请求行程的结果中。Google 还会缓存实时价格查询的结果,以便用于未来的请求。
价格更新大小
设置客房价格时,您需要提供提前预订和住宿晚数 (LoS) 值,以及这些值与客房 ID 或费率方案 ID 的每种组合对应的价格。预订值和 LoS 值默认为以下值:
- 最多提前 330 天预订
- 最多入住 30 晚
根据这些一般准则,单间客房的价格可能需要最多 9,900 个单独的条目 (330 * 30),每个条目对应入住日期和住宿晚数的组合。
以下矩阵说明了单个酒店的部分行程数据。矩阵中每个带有价格的单元格都代表一个由入住日期和住宿晚数组成的行程组合;每个行程都代表 Google 针对房源请求的一个单独值:
哪些酒店和行程会重新定价
Google 提供的价格由您的酒店列表指定。除非停用,否则酒店列表 Feed 中的所有酒店都会通过交易消息(在某些情况下是实时价格查询)重新定价。
更新价格
更新价格的一般流程如下:
仅限价格更改:Google 会向您的服务器发送 Hint Request 消息。
仅限价格更改:您的服务器会返回一条“提示响应”消息,用于定义应为哪些酒店或行程组合重新定价。
Google 会向您的服务器发送一条查询消息。“查询”消息包含 Google 需要获取价格的酒店 ID 和行程。
对于实时价格查询,Google 会指定一个时间限制,您必须在这个时限内做出响应,才能让酒店或行程在当前竞价中显示。
您的服务器会返回一条定义新价格的交易消息。
Google 会使用您的 Transaction 消息中的价格数据更新其缓存。
如需详细了解拉取和价格更改,请参阅分发模式。
交易消息的价格
如需设置酒店或行程的价格(入住日期和住宿晚数的组合),请使用交易消息,其中每个行程都有一个 <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>
每条事务消息可以包含任意数量的 <Result>
元素,只要消息的总大小不超过 100MB 即可。
价格更新频率
您应在价格发生变化时及时更新更新。具体操作方式取决于您选择是采用拉取还是价格更改方法来更新价格信息。如需了解详情,请参阅选择传送模式。
Google 向您发送的实时价格查询的频率和数量也可以配置。如需了解详情,请参阅实时价格查询。
全包价
您可以根据用户的地理位置,考虑使用全包价格而不是分项价格。
全包价格包含客房基本费率的总价值加上交易消息的 <Baserate>
元素中的税费和其他费用。Itemized
定价会将价格分成 <Baserate>
、<Taxes>
和 <OtherFees>
元素。