给消息评分

概览

“价格”消息 (OTA_HotelRateAmountNotifRQ) 指定每晚 特定日期各种客房类型和费率方案组合的入座率 范围。在“费率消息”中,Google 支持根据入住人数定价 允许根据 预计居住者人数。

以下部分介绍了一般准则、基本示例和操作方法场景,可帮助您开始添加和更新费率以及发送费率消息。

匹配率行为

当用户请求具体入住人数时,他们看到的费率取决于 定义价格的方式。本部分将介绍 用户请求与您的房价相匹配,具体取决于他们的入住人数 以及您定义的费率

主要原则

  • 为特定入住人数定义的费率适用于所有入住人数较少的入住人数, (除非另有规定)。

  • 我们不接受超出所定义入住人数的请求。

  • 基于入住人数的价格适用于按日期的价格和基于 LOS 的价格 价格模式。也就是说,您可以为每一项 入住人数如果没有适用于特定入住人数的费率, 使用第二高的入住人数。您还可以为以下各项定义费用: 其他访客和儿童(使用 AdditionalGuestAmounts) 或 ExtraGuestCharges 最高可容纳为会议室定义的可容纳人数。

优势和示例

效率

对于费率金额相同的多个入住人数,您不需要设置 和每人入住的费率。您可以仅设置 客房类型和费率方案支持的最高入住人数值。 对于不超过您设置的入住人数,用户都会看到该费率 值。

示例:对于以下酒店,不同客房类型和价格方案的费率相同: 1 到 4 人。使用“费率”消息设置最高费率 4 人入住。搜索单人、双人和三人入住的用户 也会看到同样的比率搜索价格为 5 及以上的用户不会看到房价。

控制

您可以明确提供其他入住人数的单独费率。如果您想更好地控制 Google 如何将请求与入住人数费率进行匹配,请为每个入住人数值发送不同的费率。

示例:如果定义了入住 3 人和 1 人入住的费率,则单人入住 搜索内容会显示单人入住比率,而对于双人住宿,则会显示单人间费率 而搜索 4 人及以上人数的用户则不会看到 。

有关各种费率相关情形的更多示例,请参阅 方法指南

必需和可选元素

XML 参考 用于提供必需元素和可选元素的说明。如需详细了解 属性和子元素,请参见费率元素和 属性

语法和架构

使用费率语法 创建“Rate”(费率)消息时作为参考 格式是否正确

您可以使用第三方 XML 工具(如 xmllint)来验证 Feed, 将已发布的架构提交给 Google。对于“评分”消息 请参阅酒店广告架构

价格模式

按日期定价

这是大多数房源使用的标准定价模式。per-date 价格模式以设置费率为基础,设置费率是按入住天数汇总的 最终得到总价在此模型中,Rate 元素下的所有房价均被解释为适用于 <StatusApplicationControl> 中指定的住宿日期范围。

基于 LOS 的价格

基于 LOS(住宿晚数)的定价模式基于为 到达日期和住宿晚数的组合。下 基于 LOS 的价格模式是按天计算的。例如,如果您发送的费率为 100 美元 如果住宿晚数为 3,则总价的计算公式为:3x$100=$300。

如果要使用基于 LOS 的价格模式,只需指定 对 StatusApplicationControl 元素执行 RatePlanType="26" 操作。您还需要 为代码中的 Rate 元素设置 RateTimeUnitUnitMultiplier 属性 XML。这会使指定 Rate 元素下的所有房价都适用于住宿 由 <StatusApplicationControl> 中指定的到达日期和 为“UnitMultiplier”指定了 LOS 值。

您可以在单个 但每个媒体资源应只使用一种定价模式。 实施基于 LOS 的价格时,请牢记以下几点:

  • 使用基于 LOS 的费率时,不同住宿晚数的费率不会合并 定价。例如,如果 LOS 率为 3,则不会与 LOS 为 1 才能将 LOS 费率设置为 4。LOS 率 4 必须明确 。
  • 基于 LOS 的价格中的 1 晚房价不会用作单晚房价 按日期定价
  • 每个房源应仅使用基于 LOS 的价格或按日期 具体取决于费率在系统中的表示方式。

如需为您的账号启用基于 LOS 的价格,请通过您的 TAM 提出申请 或与我们联系

指南或操作

按日期定价

Delta:仅添加或更新指定日期的每人入住费率 中所指定的房间类型、价格方案和住宿日期的组合, <StatusApplicationControl>

  • 默认情况下,房价更新会使用 Delta 操作。
  • Delta 更新不会更改之前存储的 入住人数。例如,如果您为单个客户 双人间,并发送单人间Delta费率更新 入住人数,则双人入住费率保持不变。

Overlay:删除相应客房类型的所有现有每人入住费率。 和 <StatusApplicationControl> 中指定的日期,并替换 为其分配新的费率例如,如果您为单个客户 双人间,且您发送了单人入住的Overlay最新动态 则 Google 将删除所有以前的房价(单人间和双人间) 入住人数),且更新后仅保留单人入住费率。

Remove:删除相应客房类型的所有现有每人入住费率。 价格方案以及在 <StatusApplicationControl> 中指定的日期。

基于 LOS 的价格

Delta:仅对指定的每个 LOS 值添加或更新费率 指定的客房类型、价格方案和入住日期的组合, <StatusApplicationControl>。替换所有关联的每人入住费率 更新后的 LOS 值。

  • 默认情况下,费率更新使用 Delta 操作。
  • Delta 更新不会更改之前存储的 住宿晚数。例如,如果您为 LOS 1 和 2 指定了费率, 并发送 LOS 1 的 Delta 费率更新,然后发送 LOS 2 的单人入住费率 保持不变
  • Delta更新会覆盖之前存储的所有入住费率 指定的住宿晚数。例如,如果您指定了单个和 LOS 1 的双人入住费率,并发送 LOS 1 的 Delta 费率更新 如只有单人入住费率,则系统将移除双人入住费率。

Overlay:删除 LOS 会议室所有现有的每人入住费率 <StatusApplicationControl>中指定的类型、价格方案和入住日期 并将其替换为新费率例如,如果您为 LOS 1 和 LOS 2 指定了费率,并为 LOS 1 发送了 Overlay 更新,Google 会移除所有之前的费率(LOS 1 和 LOS 2),更新后只会保留 LOS 1 费率。

Remove:删除 指定客房类型、价格方案和入住日期 <StatusApplicationControl>

与税务相关

如果税费和其他费用很简单,则可以使用 AmountAfterTax。复杂的税费,例如针对不同国家/地区的税费和其他费用 无法在 AmountAfterTax 中表示住宿晚数(而非每晚住宿费用)。

通常,Google 建议您使用 TaxFeeInfo,而不是 AmountAfterTax

如果可能,您应添加 AmountBeforeTax(即使您指定了 AmountAfterTax),因为某些语言区域(例如美国)会显示 税前价格。

用户必须支付的所有税费和其他费用(增值税、住宿税、清洁费、城市) 税费等)。 直接支付给了媒体资源。

示例

本部分提供了“费率”消息的基本示例,该消息使用必需的和 可选元素。准备好文件后,您必须使用 将 POST 消息发送到以下端点: https://www.google.com/travel/hotels/uploads/property_data

如需详细了解如何推送/发布消息,请参阅推送消息

对于 HotelCode,请使用您在系统中用于 来标识该媒体资源此值必须与使用 <listing> 元素中的 <id> 。对于 <PackageID><RoomID>,请使用 在您的系统中分别用于房价方案和客房类型。节奏稳定 这对确保 Google 正确显示 您的价格和数据

以下示例展示了如何使用 Delta 操作设置房价:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

方法指南

本部分针对您在发送信息时可能遇到的情景提供了解决方案。 为消息评分。

如需有关如何添加、移除和更新费率的示例,请参阅费率 示例

场景 1:如何更改按入住人数定价

说明

以前,每晚房价仅针对双人入住(也适用于单人入住)进行定义,但现在,单人入住的费率更低。

解决方案

使用默认的 Delta 级范围更新发送新的入住人数 1 费率。这种新的 值不会影响“入住人数 2”费率。

场景 2:如何替换房源的单人入住费率

说明

您之前为入住 1 至 4 人定义了费率,但现在仅 入住人数 1 和 2 都有效。

解决方案

使用 NotifType="Overlay" 替换指定房源的所有入住费率, 客房类型、价格方案和日期。在这种情况下,Overlay 操作会 列出入住人数 1 和 2 的费率。

场景 3:如何为多人入住设置相同的房价

说明

特定入住人数对应的费率可销售给人数较少的群组。在本课中, 您可以只发送以下商品的费率更新,以简化您的邮件 适用入住人数上限。

解决方案

如果有多人入住的价格相同,请设置最高入住人数 该值,系统会自动 针对入住人数较少的情况使用该值。也就是说,无需重复 入住 1-6 人入住的每晚价格(如果人数均相同);只需将它设为 6 即可。