促销信息

概览

促销消息定义了使用 OTA_HotelRateAmountNotifRQ。系统会针对每种费率评估已定义的促销优惠，并将允许的最高折扣应用于该费率。此消息类型是可选的，您只需要定义 促销活动（如果您的系统中用于应用费率折扣）。

您可以组合促销活动，并将其应用于不同的用户属性， 例如设备类型（移动设备、平板电脑、桌面设备）和国家/地区代码。

要点 ：当多个促销活动适用于特定产品费率时（客房类型 + 费率方案 + 入住人数），用户会收到允许的最低价格，或 并且系统会自动应用折扣。

如需查看与促销相关的各种场景的示例，请参阅 方法指南。

以下部分介绍了一般准则、基本示例和操作方法场景，可帮助您开始添加和更新促销活动。

指南

本部分介绍了有关设置广告的常见准则和特殊说明， 促销。

在开展促销活动时，请遵循以下准则：

操作

删除

在 <Promotion> 元素中使用 delete 操作可按 ID 删除单个促销活动。

重叠式广告

在 <HotelPromotions> 元素中使用 overlay 操作可替换房源的所有促销活动。

增量

如果未指定任何操作，则指定所有促销活动 将在 <HotelPromotions> 内添加或替换。如果包含该 ID 的促销活动 从未添加或已被删除，就会添加该宣传。如果存在具有该 ID 的促销活动，则系统会使用新定义覆盖该促销活动。

常规

• 每个房源可以对应一个或一组促销活动，每个 具有一组条件。只有当 条件。

• 如果您想让促销活动仅应用于特定日期、客房类型或房价 ，然后在该促销活动的条件中指定这一点。如果促销优惠不适用于特定日期、客房类型或费率方案，则无需设置这些信息。

• 每个促销活动都与特定媒体资源相关联。如果您使用同一促销活动 必须针对每项媒体资源单独发送报告。如需指定媒体资源标识符，请使用 <HotelPromotions> 元素的 hotel_id 属性。

• 您最多可以添加 99 个促销活动。如需获取帮助，请与您的 Google TAM 联系 包含的内容远不止于此。

• 使用 <Stacking> 元素指定促销活动的组合方式。修改者 默认使用 base 堆栈类型，这意味着 系统会先选择并应用基本促销活动，然后再应用其他促销活动。注意事项 base 只能与 second 或 any 组合使用，并且不能组合使用 另一个 base 或 none。

• 即使可同时应用多项促销优惠， 如果存在另一个 Pod，则该堆栈实际上可能不是 提供更大折扣的单个促销活动或一系列促销活动。通过 对预订应用折扣幅度最大的促销活动（组合） 当多项（组合）的促销活动符合条件时。

• 每当出现会影响 。

  要点 ：每个房源最多只能包含 500 个促销信息。您可以使用 <Promotions> 消息，可从房源中移除促销活动。

与税务相关

向AmountAfterTax应用了效果最佳的促销活动（或一系列促销活动） 金额。如果仅指定了 AmountBeforeTax，则促销活动 已应用于AmountBeforeTax。

示例

本部分提供了使用必需的 和可选元素。准备好文件后，请通过 向此端点发送 POST 消息：

https://www.google.com/travel/hotels/uploads/promotions

要详细了解如何推送/发布消息，请参阅 推送消息。

要点 ：每次发布促销活动时，都向 Google 发送更新后的促销信息 更改。

对于 <HotelPromotions> 的 hotel_id 属性，请使用唯一的酒店 ID 您用来标识该房源的信息。此值必须匹配 在 <listing> 中使用 <id> 指定的酒店 ID 元素。与系统的一致性对 确保 Google 正确显示您的数据。

UserCountry 用于列出符合条件的用户地理位置（国家/地区） 。如果指定，则只有所列国家/地区的用户才会 提供折扣费率。

注意： 设置国家/地区代码是可选操作，如果未指定，则 折扣费率。

以下示例展示了如何为美国和意大利的用户设置延长住宿 15% 的折扣：

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

如需查看更多示例，请参阅 促销活动示例。

方法指南

本部分针对您在设置 促销。

场景 1：如何添加长住型折扣促销活动

说明

您想要在长住期间的特定日子提供晚间折扣。

解决方案

使用 FreeNights 设置可自定义所应用的折扣类型，具体取决于 住宿晚数。

示例

此示例展示了如何为每 7 晚添加两晚的 8 折优惠 在指定日期范围内入住。对于 15 晚的行程， 总共 4 晚可享八折优惠。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

场景 2：如何设置设备类型

通过设置 devices，您可以指定有资格使用 推广活动。如果指定了此属性，则只有使用所列设备的用户才能享受折扣优惠。

注意 ：如果未指定，则使用任何设备的用户都将享受折扣价。

说明

您想要指定符合促销条件的用户设备类型。

解决方案

将设备类型设置为以下一个或多个值：desktop、tablet、 或 mobile。

示例

以下示例展示了如何为移动设备和 YouTube 应用指定 25% 的折扣 平板电脑用户：

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

场景 3：如何用新的促销信息替换旧促销

说明

房源当前的这组促销信息已过时或不正确，需要 然后替换为一个全新的组合

解决方案

使用 overlay 操作替换促销信息。

注意：如需覆盖媒体资源的所有促销活动，建议使用 overlay（而不是使用单个 delete）。使用 delete 操作（如果您只想删除特定促销活动） 属性。

示例

以下示例显示了原有的两个折扣：20% 和 媒体资源的 30%。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

然后，此示例展示了如何使用 overlay 替换现有 两项促销活动，其中同一项促销活动为酒店可享八五折优惠。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

场景 4：如何移除一项或所有促销活动

说明

由于 媒体资源已移除其所有促销活动，但未设置新的促销活动，或者 您出错了，需要更正。

解决方案

如果您只想删除特定个人，请使用 delete 操作 房源促销，并使用 overlay（而不是 delete）操作移除 所有现有的促销活动，无需替换。

注意：如需覆盖媒体资源的所有促销活动，建议使用 overlay（而非单个 delete 操作）。

如需详细了解如何使用 overlay 替换促销信息，请参阅 场景 3：

示例

以下示例展示了如何仅删除房源的一个促销活动：

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

此示例展示了如何移除所有促销活动而不替换促销活动 属性：

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

场景 5：如何叠加促销活动

堆叠指定了促销活动的组合方式。如果未指定，则 type 假定为 base，这意味着最符合条件的基本促销活动为 先选择并应用，然后再应用其他促销活动。如果 type 属性 的“Stacking”为 any，可与任何其他促销活动结合使用。

注意 ：折扣最高的促销活动（组合）将应用于 在有多个促销活动组合符合条件时预订。

说明

您希望用户可以选择同时使用多项促销优惠 同一媒体资源上的时间

解决方案

使用堆叠为每个房源设置多个折扣。一个堆栈最多只能包含 一个 base 和一个 second，但 any 的数量不受限制；且any可以 与 none 之外的其他类型结合使用。

示例

此示例展示了如何堆叠 base、second 和 any 堆叠类型。对于 15%、25% 和 10% 的组合折扣，则 100 美元的价格 $57.38 (100 × 0.85 × 0.75 × 0.9)。

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

请注意，堆叠促销活动 1 至 3 的总折扣为 高于促销活动 4 的折扣。促销 4 不能与 因为其堆叠类型（none）而获得了其他促销。如果促销活动 4 的 折扣为 43% 或更高，则系统将使用这一折扣，而不是 促销 1 至 3。