Mensaje de las promociones

Descripción general

En el mensaje Promociones, se definen reglas para descontar tarifas con OTA_HotelRateAmountNotifRQ. Para cada tarifa, se evalúan las promociones definidas y se aplica el mayor descuento permitido. Este tipo de mensaje es opcional y solo debes definir las promociones si se usan en tu sistema para aplicar descuentos de tarifa.

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

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

Para ver ejemplos de varias situaciones relacionadas con la promoción, consulta Instructivos.

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

Lineamientos

En esta sección, se describen los lineamientos comunes y las instrucciones especiales para configurar promociones.

Use los siguientes lineamientos para las promociones:

Acciones

Borrar

Usa una acción delete en el elemento <Promotion> para borrar una sola 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, se agregan o reemplazan todas las promociones especificadas en <HotelPromotions>. Si nunca se agregó ni se borró una promoción con ese ID, se agregará la promoción. Si existe una promoción con ese ID, se reemplaza por la definición nueva.

General

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

• Si quieres que una promoción se aplique solo a una fecha, un tipo de habitación o un plan de tarifas específicos, especifícalo 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 que los configures.

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

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

• Usa el elemento <Stacking> para especificar cómo se pueden combinar las promociones. De forma predeterminada, Google usa el tipo de apilado base, lo que significa que se selecciona y aplica primero la mejor promoción de base apta, antes que otras promociones. Ten en cuenta que base solo se puede combinar con second o any, y no 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 usa si hay otra única promoción o pila de promociones que ofrece el descuento mayor. La promoción (combinación) con el mayor descuento se aplica a la reserva cuando son aptas varias (combinaciones de) promociones.

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

Relacionado con impuestos

Se aplica la mejor promoción (o pila de promociones) al importe de AmountAfterTax. Si solo se especifica AmountBeforeTax, las promociones se aplicarán a AmountBeforeTax.

Ejemplo

En esta sección, se proporciona un ejemplo básico de un mensaje de promociones con elementos obligatorios y opcionales. Una vez que hayas preparado tu archivo, envíalo 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 Envía mensajes.

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

Para el atributo hotel_id de <HotelPromotions>, usa el ID de hotel único que usaste en tu sistema para identificar la propiedad. Este valor debe coincidir con el ID de hotel especificado mediante <id> en el elemento <listing> del feed de lista de hoteles. La coherencia con tu sistema es fundamental para garantizar que Google muestre tus datos de forma correcta.

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

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

En este ejemplo, se muestra cómo establecer un descuento del 15% por 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 las promociones.

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

Descripción

Deseas ofrecer noches con descuento en ciertos días de una estadía extendida.

Solución

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

Ejemplo

En este ejemplo, se muestra cómo agregar un 20% de descuento por dos noches por cada 7 noches que se alojen 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 de los usuarios que son aptos para la promoción. Si se especifica, solo se ofrecerá la tarifa con descuento a los usuarios de los dispositivos de la lista.

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 de usuario es apto para la promoción.

Solución

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

Ejemplo

En el siguiente ejemplo, se muestra cómo especificar un descuento del 25% para usuarios de dispositivos móviles y 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 antiguas por nuevas

Descripción

El conjunto actual de promociones de una propiedad está desactualizado o es incorrecto y debe reemplazarse por un conjunto completamente nuevo.

Solución

Usa la acción overlay para reemplazar las promociones.

Nota: Se recomienda usar overlay (en lugar de usar delete individuales) para reemplazar todas las promociones de una propiedad. Usa la acción delete si deseas borrar solo promociones específicas de una propiedad.

Ejemplo

En el siguiente ejemplo, se muestran los dos descuentos originales del 20% y el 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 las dos promociones existentes 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 propiedad quitó todas sus promociones sin configurar otras nuevas, o bien cometiste un error y debes corregirlo.

Solución

Usa la acción delete si deseas borrar solo promociones individuales específicas de una propiedad y utiliza la acción overlay (no delete) para quitar todas las promociones existentes sin reemplazo.

Nota: Se recomienda usar overlay (en lugar de acciones delete individuales) para reemplazar todas las promociones de una propiedad.

Si quieres obtener detalles para reemplazar promociones mediante overlay, consulta la Situación 3.

Ejemplos

En el siguiente ejemplo, se indica cómo borrar solo una promoción de 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 este ejemplo, se muestra cómo quitar todas las promociones sin reemplazar 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

Esta configuración especifica cómo se pueden combinar las promociones. Si no se especifica, se supone que type es base, lo que significa que se selecciona y aplica primero la mejor promoción base apta, 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 descuento más grande se aplica a la reserva cuando son aptas varias combinaciones de promociones.

Descripción

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

Solución

Usa el apilamiento para configurar 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 se puede combinar con los otros tipos, excepto none.

Ejemplo

En este ejemplo, se muestra cómo apilar los tipos de apilado base, second y any. Para un descuento combinado del 15%, 25% y 10%, un precio de USD 100 equivale a un total de USD 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 de pila 1 a 3 es mejor que el descuento de la promoción 4. La promoción 4 no se puede combinar con otras promociones debido a su tipo de apilado (none). Si la promoción 4 tuviera un descuento del 43% o superior, se usaría en lugar de la combinación de las promociones 1 a 3.