价格分发模式

传送模式决定了您如何向 Google 传送酒店和行程组合的价格更新。在初始配置期间，您将与技术支持客户经理 (TAM) 共同设置配送模式。

分发模式概览

默认情况下，酒店的查询范围为客房空房情况提前 330 天，住宿晚数最多为 30 晚，但您可以确定行程（入住日期和住宿晚数的组合）的最大数量。

您支持的行程越多，参与的竞价就越多。不过，您支持的行程越多，就必须向 Google 发送更多数据，以确保价格数据的准确性。

更新价格的典型方法是以以下方式之一使用 Transaction 消息：

  • ARI（推送）：一种价格传送 Feed，利用房价方案、房源信息和酒店元数据为您的房源设置预定义的价格策略。与拉取价格功能和价格更改功能不同，ARI Feed 不会查询特定价格或行程。您只需推送包含部分信息的讯息，这些信息代表了您房源的定价模式，其中包含各种费率详细信息、限制和房源供应情况。ARI Feed 使用 OTA XML 规范（OTA_HotelRateAmountNotifRQ 和 OTA_HotelAvailNotifRQ）来定义房源信息和价格。请与您的客户经理联系，详细了解 ARI 交付模式，并确定此 Feed 类型是否最适合您的账号。如需了解详情，请参阅使用 ARI。

  • 拉取：Google 会定期查询您的服务，以刷新其价格和库存状况数据缓存。在此模型中，Google 会向您的服务器发送请求，而您的服务器会以更新后的数据作为响应。 如果您不确定价格信息何时发生变化，或者价格信息在一天内不规律地变化，则此模型的效果最佳。价格会一直保留在缓存中，直到 Google 的算法根据特定合作伙伴之前的价格变动历史记录确定价格已过时。如需了解详情，请参阅使用拉取传送模式。

  • 价格更改（以前称为“Pull with Hints”）：与“Pull”类似，不同之处在于 Google 仅请求部分房源（而非所有房源）的数据。此模式可以显著减少在更新房源的价格和房源状况时产生的网络流量。 价格会无限期地保留在缓存中，直到更新为止。如需了解详情，请参阅使用更改后的价格。

除了更新价格之外，您还可以使用交易消息从商品目录中移除房源。如需了解详情，请参阅移除商品目录。

如需详细了解如何提供价格更新（包括交易消息示例），请参阅更新价格。

实时价格查询

Google 还可以通过实时价格查询在竞价时请求进行一些价格更新。实时价格查询是指 Google 针对当前竞价发送的价格请求。如果您在指定的时间范围内做出回应，那么您的广告应该会出现在竞价中。

Google 会像存储任何其他交易消息一样存储实时价格查询的响应。这样一来，Google 便可从缓存中提供价格，而无需在日后发送其他实时价格查询。

如需了解详情，请参阅实时价格查询。

上下文

拉取和更改价格查询通常不会指定有关用户的信息，因为 Google 会使用您的回答来填充缓存，而该缓存可能会用于为各种不同的用户提供服务。

由于返回与全套可能的用户情境相对应的价格可能会花费大量资源，因此我们正在测试一项功能，该功能允许您将热门用户情境指定为查询的一部分。用户情境基于您有机会展示价格的用户请求，并经过计算，可涵盖绝大多数用户请求。对于非常热门的房源或行程，您可能会看到大量用户情境，但用户情境的平均数量应少于 10 个。您可以返回其他价格或忽略指定的用户情境，具体返回哪些价格取决于您。不过，忽略建议的用户情境可能会导致流量减少。

ARI 推送分发模式

使用 ARI 推送传送模式时，每当每晚房价、空房情况、空房库存数量或其他限制发生变化时，您都会向 Google 发送增量更新。与“拉取价格”或“价格更改”模式不同，ARI 推送模式允许您使用不同的价格模式，高效地向 Google 更新价格信息的各个组成部分。

下图显示了 ARI 推送交付模式的请求和响应流程：

fig1

第 1 步：向 Google 发送 ARI 推送消息

如需使用 ARI 推送更新数据，请在每次数据发生变化时发送 ARI 请求消息。ARI 推送传送模式支持各种消息类型和价格策略。如需详细了解如何推送消息，请参阅使用 ARI。

在收到消息后的 15 到 20 分钟内，Google 应该会投放您的价格，并且用户应该能够看到这些价格。

第 2 步：确认数据已成功被 Google 缓存

对于收到的每条 ARI 推送消息，Google 都会以 HTTP 连接状态和 ARI 处理结果作为响应。如果与服务器的连接成功，Google 会返回 HTTP 200 OK。它还包含一个正文，其中包含一条响应消息，用于指示更新是否已成功应用，或者是否遇到交付模式警告或错误。

将 IP 地址列入许可名单

如需将您用于向 Google 推送 ARI 消息的任何 IP 地址列入许可名单，请使用 Hotel Center ARI 价格设置页面。 了解如何在 Hotel Center 中更新价格设置。

通过 ARI 推送更新 Room 和 Package 元数据

使用交易（房源数据）消息类型来定义每个房源的有效房型和费率方案（套餐）。每当添加、移除或修改房型或房价方案时，您都应推送更新。在这种情况下，您需要发送一条 XML 消息，其中包含 <RoomData> 和 <PackageData> 元素中的新信息。这些元素是 <PropertyDataSet> 元素的子元素。

连接或内容错误

如果您因 XML 格式错误或不正确而收到交付模式错误，请在 Feed 状态错误消息中查找建议的解决方案。

如果您在向 Google 发送 ARI 消息时收到 HTTP 连接错误，请分别在 1 分钟、5 分钟和 20 分钟后重试请求。如果重试 3 次后问题仍然存在，请停止发送消息并与 Google 支持团队联系。

拉取传送模式

在拉取传送模式下，Google 会定期向您的服务器发送 Query 消息，以请求价格更新。您的服务器会使用包含更新后的价格和库存状况数据的交易消息来响应这些消息。

下图显示了 Pull 的请求/响应流程：

fig2

收到价格更新后，Google 通常会在大约 5 分钟内处理新的价格和供应情况数据。

以下各部分将更详细地介绍这些步骤。

第 1 步：查询消息

默认情况下，Google 会针对酒店列表中定义的所有房源发送查询消息。这可能意味着，在重新定价过程中，您应该会收到多条 Query 消息。

Google 发送到您服务器的价格查询消息具有以下特征：

  • 根元素为 <Query>。
  • 发送到在初始配置期间定义的端点。如需了解详情，请与您的技术支持客户经理 (TAM) 联系。
  • 使用 HTTP POST 方法。（如果您使用的是 HTTPS，则需要让官方证书授权机构为网域签名。）
  • Content-Type 标头设置为 application/xml。
  • 每条消息最多包含 100 个房源，Google 会请求这些房源的价格和房源信息数据。
  • User-Agent 标头设置为 Google-HotelAdsPrices。

第 2 步：交易消息

当您的服务器收到 Query 消息时，必须以 Transaction 消息进行响应，其中包含所请求行程的价格信息。

交易消息的根元素是 <Transaction>。如需了解详情，请参阅交易消息和更新价格。

更新 Room 和 Package 元数据

除了使用拉取方式更新价格数据之外，您还可以使用交易消息来更新客房和套餐元数据。如需了解详情，请参阅定义会议室和软件包元数据。

价格更改传送模式

更改后的价格有助于减少价格更新的查询和交易消息的大小和数量。使用“价格已更改”时，您需要向 Google 发送价格已更新的房源列表。Google 会回复一条 Query 消息，其中仅请求这些房源的价格。

如需配置 Google 向其发送提示请求消息的端点，请咨询您的技术支持客户经理 (TAM)。您会在初始配置期间设置此功能。

下图显示了“价格已更改”的请求和响应流程：

fig3

以下各部分介绍了此流程中的每个步骤。

第 1 步：提示请求消息

Google 发送到您服务器的提示请求消息具有以下特征：

  • 根元素为 <HintRequest>。
  • 发送到在初始配置期间定义的端点。 如需了解详情，请与您的技术支持客户经理 (TAM) 联系。
  • 使用 HTTP POST 方法。（如果您使用的是 HTTPS，则需要让官方证书授权机构对网域进行签名。）
  • Content-Type 标头设置为 application/xml。
  • Google 会以指定频率向您的服务器发送时间戳，该时间戳用于定义您上次响应提示请求消息的时间。
  • User-Agent 标头设置为 Google-HotelAdsPrices。

建议您将频次设置为 5 分钟。如需设置或修改提示请求消息的频次，请与我们联系。

当您收到 Google 发送的提示请求消息时，您需要回复自相应时间戳以来更新的所有价格。如需了解详情，请参阅提示请求消息。

第 2 步：Hint 回应消息

您的服务器使用提示响应消息来响应提示请求消息。 此消息包含自您上次收到并回复提示请求消息以来价格发生变化的房源的酒店 ID 和行程。

提示响应消息的根元素是 <Hint>。如需了解详情，请参阅提示响应消息。

第 3 步：查询消息

Google 收到提示响应消息，并像在标准拉取模式下一样，以查询消息进行响应。不同之处在于，Query 消息现在仅包含您在 Hint Response 消息中指定的房源的酒店 ID 和行程。Query 消息的根元素是 <Query>。

在使用“价格变动”功能确定要请求哪些酒店 ID 的价格时，Google 会忽略酒店列表 Feed 的内容。这会大大减小您从 Google 收到的 Query 消息的大小以及您响应的 Transaction 消息的大小。

第 4 步：交易消息

您发送包含价格更新的交易消息，以响应 Google 的查询消息。交易消息的根元素是 <Transaction>。如需了解详情，请参阅拉取交付模式。