Mensaje de las promociones

Descripción general

El mensaje Promociones define las reglas para aplicar descuentos a las tarifas OTA_HotelRateAmountNotifRQ Para cada tarifa, se definen las promociones se evalúen y se aplique el mayor descuento permitido tasa. Este tipo de mensaje es opcional y solo debes definir promociones si se usan en tu sistema para aplicar descuentos en las tarifas.

Puedes combinar promociones y aplicarlas a distintos atributos de usuario como tipos de dispositivo (dispositivo móvil, tablet, computadora de escritorio) y códigos de país.

Punto clave: Cuando se aplican varias promociones a tarifas de productos específicos (tipo de habitación + plan de tarifas + ocupación), el usuario recibe la promoción permitida más económica o la más económica. combinación de promociones y los descuentos se aplican automáticamente.

Para ver ejemplos de varios casos relacionados con promociones, consulta Instructivos.

En las siguientes secciones, se abordan lineamientos generales, un ejemplo básico e instructivos para comenzar a agregar y actualizar promociones.

Lineamientos

En esta sección, se abordan los lineamientos comunes y las instrucciones especiales para la configuración promociones.

Sigue estos lineamientos para las promociones:

Acciones

Borrar

Usa una acción delete en el elemento <Promotion> para borrar un solo elemento promoción por su ID.

Superposición

Usa una acción overlay en el elemento <HotelPromotions> para reemplazar todas las promociones de una propiedad.

Delta

Si no se especifica ninguna acción, todas las promociones especificadas dentro de <HotelPromotions> se agregan o reemplazan. Si una promoción con ese ID nunca se agregó ni se eliminó, la promoción se agrega. Si una si existe una promoción con ese ID, se reemplaza con la nueva definición.

General

• Puede haber un solo conjunto o un conjunto de promociones para cada propiedad y cada una promoción tiene un conjunto de condiciones. Esa promoción solo puede aplicarse si el se cumplen las condiciones.

• Si quieres que una promoción se aplique solo a una fecha, un tipo de habitación o una tarifa específicos plan y, luego, especifíquelo en las condiciones de esa promoción. Si la promoción no se aplica a una fecha, un tipo de habitación o un plan de tarifas específicos, no es necesario configurarlos.

• Cada promoción está vinculada a una propiedad específica. Si usas la misma promoción para varias propiedades, debes enviarlo por separado para cada propiedad. Para especifica tu identificador de propiedad, usa el atributo hotel_id de las elemento <HotelPromotions>.

• Puedes incluir hasta 99 promociones. Comunícate con tu TAM de Google si necesitas hacerlo incluir más que esto.

• Usa el elemento <Stacking> para especificar cómo se pueden combinar las promociones. De predeterminada, Google usa el tipo de apilamiento base, lo que significa que la mejor La promoción de base se selecciona y aplica primero, antes que otras promociones. Nota que base solo se puede combinar con second o any, y no se puede combinar con otro base o none.

• Incluso si hay una pila de varias promociones que se pueden aplicar juntas, es posible que esa pila no sea la que se use si hay otra promoción única o una pila de promociones que ofrezca un descuento más significativo. El Se aplica la promoción (combinación) con el mayor descuento a la reserva. cuando son aptas varias promociones (combinaciones de)

• Envía una actualización del mensaje de promociones cada vez que se produzca algún cambio que afecte tus promociones.

  Punto clave: Hay un límite de 500 promociones por propiedad. Puedes usar la Mensaje <Promotions> para quitar promociones de una propiedad.

Relacionado con los impuestos

La mejor promoción (o pila de promociones) se aplica al AmountAfterTax. importe. Si solo se especifica AmountBeforeTax, las promociones se se aplicó a AmountBeforeTax.

Ejemplo

En esta sección, se muestra un ejemplo básico de un mensaje de Promociones que usa los y elementos opcionales. Cuando esté listo su archivo, envíelo a Google a través de un mensaje POST a este extremo:

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

Para obtener más información sobre cómo enviar o publicar el mensaje, consulta Cómo enviar mensajes.

Punto clave: Envía a Google un mensaje promocional actualizado cada vez que tus promociones cambio.

Para el atributo hotel_id de <HotelPromotions>, usa el ID de hotel único que usó en su sistema para identificar la propiedad. Este valor debe coincidir el ID de hotel especificado con <id> en el <listing> del feed de lista de hoteles. La coherencia con tu sistema es fundamental para asegurándose de que Google muestre tus datos correctamente.

UserCountry se usa para enumerar las ubicaciones de los usuarios (países) que son aptas para la promoción. Si se especifica, solo los usuarios de los países enumerados ofrecía la tarifa con descuento.

Nota: Establecer un código de país es opcional y, si no se especifica, los usuarios de se ofrece la tarifa con descuento en cualquier país.

En este ejemplo, se muestra cómo establecer un descuento del 15% para una estadía extendida para usuarios de Italia y Estados Unidos:

<?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>

Para ver más ejemplos, consulta Ejemplos de promociones.

Instructivos

En esta sección, se proporcionan soluciones para situaciones que puedes encontrar cuando configuras promociones.

Situación 1: Cómo agregar una promoción de descuento para una estadía extendida

Descripción

Quieres ofrecer noches con descuento durante ciertos días de una estadía extendida.

Solución

Usa la configuración de FreeNights para personalizar el tipo de descuento que se aplica según la cantidad de noches de estadía.

Muestra

En esta muestra, se indica cómo agregar un descuento del 20% por dos noches cada 7 noches se mantuvo durante el período especificado de fechas de reserva. Para un itinerario de 15 noches, se aplica un descuento del 20% a un total de 4 noches.

<?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>

Situación 2: Cómo configurar los tipos de dispositivos

Configura devices para especificar los dispositivos del usuario que son aptos para el promoción. Si se especifica, solo se ofrecen a los usuarios de los dispositivos indicados en la lista la tarifa con descuento.

Nota: Si no se especifica, se ofrece la tarifa con descuento a los usuarios de cualquier dispositivo.

Descripción

Quieres especificar qué tipo de dispositivo del usuario es apto para la promoción.

Solución

Establece el tipo de dispositivo en uno o más de los siguientes valores: desktop, tablet, o mobile.

Muestra

En el siguiente ejemplo, se muestra cómo especificar un descuento del 25% para dispositivos móviles y usuarios de tablets:

<?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>

Situación 3: Cómo reemplazar promociones anteriores con nuevas

Descripción

El conjunto actual de promociones de una propiedad está desactualizada o es incorrecta y debe en lugar de reemplazarse por un conjunto totalmente nuevo.

Solución

Usa la acción overlay para reemplazar las promociones.

Nota: Usar overlay (en lugar de delete individuales) es la forma recomendada de reemplazar todas las promociones de una propiedad. Usa el delete si deseas borrar solo promociones específicas de un propiedad.

Muestra

En el siguiente ejemplo, se muestran los dos descuentos originales del 20% y un 30% para la propiedad.

<?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>

Luego, en este ejemplo, se muestra cómo usar overlay para reemplazar el dos promociones con una sola promoción del 15% de descuento para la propiedad.

<?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>

Situación 4: Cómo quitar una o todas las promociones

Descripción

Deseas quitar una o todas las promociones (sin reemplazo) porque la quitó todas sus promociones sin establecer otras nuevas. cometiste un error y debes corregirlo.

Solución

Usa la acción delete si quieres borrar solo a una persona específica. promociones de una propiedad y use la acción overlay (no delete) para quitar todas las promociones existentes sin reemplazo.

Nota: Usar overlay (en lugar de acciones individuales de delete) es la forma recomendada de reemplazar todas las promociones de una propiedad.

Para obtener más información sobre cómo reemplazar promociones con overlay, consulta la situación 3.

Ejemplos

En el siguiente ejemplo, se muestra cómo borrar solo una promoción por una propiedad:

<?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>

En esta muestra, se indica cómo quitar todas las promociones sin reemplazo para una propiedad:

<?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>

Situación 5: Cómo agrupar promociones

El apilamiento especifica cómo se pueden combinar las promociones. Si no se especifica, type se supone que es base, lo que significa que la mejor promoción base apta es seleccionar y aplicar primero, antes que otras promociones. Cuando el atributo type de Stacking es any. Se puede combinar con cualquier otra promoción.

Nota: La promoción (combinación) con el mayor descuento se aplica al reserva cuando varias combinaciones de promoción son aptas.

Descripción

Quieres que el usuario tenga la opción de usar varias promociones al mismo tiempo. tiempo para la misma propiedad.

Solución

Usa la pila para establecer varios descuentos por propiedad. Una pila puede tener como máximo un base y un second, pero un número ilimitado de any. y any pueden combinarse con los otros tipos, excepto none.

Muestra

En esta muestra, se indica cómo apilar los tipos de apilado base, second y any. Para un descuento combinado del 15%, 25%, 10%, un precio de USD 100 equivale a un total de $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>

Ten en cuenta que el descuento combinado para las promociones apiladas 1 a 3 es mejor que el descuento de la promoción 4. No se puede combinar la promoción 4 con otras promociones debido a su tipo de apilado (none). Si la promoción 4 tuviera un del 43% o más, se usará en lugar de la combinación de promociones 1 a 3.