Se usó la API de Cloud Translation para traducir esta página.

Tarifas condicionales

Las tarifas condicionales son un tipo de regla de tarifas que te permite ofrecer tarifas diferentes para los itinerarios, según criterios como el dispositivo, el país o si el usuario accedió a Google.

Cuando tengas más de una tarifa pública o condicional para un itinerario o paquete de habitaciones, el usuario verá la tarifa más baja. Google siempre elige la tarifa más baja que sea apta para el usuario.

Descripción general

Las tarifas condicionales son visibles en las franjas de precios estándar y solo se muestran a los usuarios cuyas búsquedas cumplen con los criterios de la tarifa condicional asociada. Estos criterios pueden basarse en lo siguiente:

Para habilitar las tarifas condicionales, modifica lo siguiente:

Archivo en formato XML de las reglas de tarifas: Define las condiciones en las que se aplican las tarifas condicionales.
Feed de precios: Usa el elemento <Rate> en un mensaje de Transaction para establecer las tarifas.
Archivo de página de destino: Agrega valores específicos de la regla de tarifas a tus vínculos directos.

Tarifas condicionales específicas del dispositivo

Las tarifas específicas del dispositivo son tarifas de hoteles que solo los usuarios pueden ver y reservar en un dispositivo específico, como un dispositivo móvil, una tablet o una computadora de escritorio. Los socios de Google proporcionan las tarifas, y los usuarios finales pueden ver y reservar las mismas tarifas específicas del dispositivo en el sitio del socio.

fenced_rates

Tarifas condicionales específicas por país

Las tarifas específicas de un país son tarifas de hoteles que solo pueden ver y reservar los usuarios que buscan hoteles de un país específico. Google determina el país con la dirección IP del usuario final. Los socios de Google proporcionan las tarifas, y los usuarios finales pueden ver y reservar las mismas tarifas específicas del país en el sitio del socio correspondiente.

Tarifas condicionales específicas del idioma

Solo los usuarios que buscan hoteles con una configuración de idioma específica en Google pueden ver las tarifas específicas del idioma. Las condiciones específicas del idioma se definen con el elemento <LanguageCode>.

El idioma no se especifica en los mensajes de solicitud de consultas con contexto. Por lo tanto, si especificas <LanguageCode> en tus reglas de tarifas, la respuesta con contexto debe incluir todas las tarifas relevantes específicas del idioma.

Tarifas condicionales con reducción de muestra

Las tarifas condicionales con reducción de muestra solo son visibles para un subconjunto aleatorio de todos los usuarios aptos. La tasa de muestreo se define con el elemento <MaxUsersPercent> y se calcula con lo siguiente:

MaxUsersPercent = (number of users selected to view rate)/(total eligible users)

Tarifas condicionales de acceso

Solo los usuarios que accedieron con una Cuenta de Google pueden ver las tarifas de acceso. Los socios de Google proporcionan las tarifas, y los usuarios pueden verlas y reservarlas en el sitio del socio. Las tasas de acceso se definen con el elemento <UserSignedIn>.

Dado que Google siempre selecciona la tarifa apta más baja, si una tarifa condicional es superior al precio establecido en el nivel <Result>, nunca se seleccionará la tarifa condicional. Para evitar esto, quita la tarifa en el nivel <Result> y condiciona todas las tarifas. Como alternativa, consulta a tu administrador técnico de cuentas sobre el uso de una regla de tarifas predeterminada para los precios establecidos a nivel de <Result>.

Crea un archivo en formato XML de reglas de tarifas

Las reglas de tarifas para las tarifas condicionales se definen con un archivo en formato XML de reglas de tarifas. Para obtener más información, consulta la Referencia de XML para las reglas de tarifas.

Actualiza tu feed de precios

Las tarifas condicionales se establecen con el elemento en un mensaje de transacción.

El elemento <Rate> también se puede usar como varios elementos secundarios de <Rates> dentro de los elementos <RoomBundle> o <Result>. Para usarla como tarifa condicional, debes establecer el valor del atributo rate_rule_id para que coincida con el ID de la regla de tarifa que definiste en el archivo en formato XML de las reglas de tarifas.

Si no tienes una tarifa pública predeterminada de ocupación doble, establece el elemento secundario <Baserate> del mensaje <Result> en -1. Cualquier <Rates> condicional que se envíe a Google en este caso se considerará válida.

Ejemplos

Base + condicional

En el siguiente ejemplo, se muestra un mensaje de transacción que contiene una tarifa base y una tarifa condicional:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
      </Rate>
    </Rates>

  </Result>
</Transaction>

RoomBundle único

En el siguiente ejemplo, se muestra un mensaje de transacción que contiene una sola tarifa en un <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>

    <Baserate currency="USD">300.00</Baserate>
    <Tax currency="USD">30.00</Tax>
    <OtherFees currency="USD">2.00</OtherFees>

    <RoomBundle>
      <RoomID>single</RoomID>
      <Baserate currency="USD">300.00</Baserate>
      <Tax currency="USD">30.00</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
    </RoomBundle>

    <RoomBundle>
      <RoomID>3</RoomID>  <!-- Links to data in metadata -->
      <RatePlanID>basic</RatePlanID>
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <ChargeCurrency>web</ChargeCurrency>
      <BreakfastIncluded>1</BreakfastIncluded>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">269.00</Baserate>
          <Tax currency="USD">2.69</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rates>
      </Rates>

    </RoomBundle>
  </Result>
</Transaction>

RoomBundle múltiple

En el siguiente ejemplo, se muestra un mensaje de transacción que contiene varias tarifas en un <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>

      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

No tiene ocupación doble pública

En el siguiente ejemplo, se muestra un mensaje de transacción que contiene una tarifa condicional sin tarifa pública de ocupación doble:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">

  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <!-- <Unavailable/> should not be specified when available nested rates
    exist. -->
    <Baserate currency="USD">-1</Baserate>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates. -->
      <Rate rate_rule_id="mobile">
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
        <OtherFees currency="USD">1.00</OtherFees>
        <Custom1>ratecode123</Custom1>
      </Rate>
    </Rates>

  </Result>
</Transaction>

Actualiza el archivo de tu página de destino

Para asegurarte de que los usuarios finales aptos puedan reservar la tarifa con descuento a través de un vínculo directo, modifica el archivo de la página de destino. También es posible que se necesite una implementación adicional en el sitio web de reservas para mostrar y entregar correctamente las tarifas con descuento.

Esperamos que los socios cumplan con el precio que se muestra en el vínculo directo de la tarifa condicional.

En un vínculo directo dinámico, puedes incluir la regla de tarifas por su nombre, el atributo id del elemento <RateRule>, con la variable RATE-RULE-ID.

En el siguiente ejemplo, se agrega el ID de la regla de tarifas:

https://bookingsite.com/landing.do?id=(PARTNER-HOTEL-ID)&arrival=(CHECKINDAY)-(CHECKINMONTH)-(CHECKINYEAR)&departure=(CHECKOUTDAY)-(CHECKOUTMONTH)-(CHECKOUTYEAR)&lang=(USER-LANGUAGE)&currency=(USER-CURRENCY)&prid=(RATE-RULE-ID)

El archivo de página de destino también admite la directiva IF-RATE-RULE-ID, que te permite definir de forma condicional partes de la URL, según si existe la regla de tarifas:

https://bookingsite.com/(IF-RATE-RULE-ID)privatelanding.do(RATE-RULE-ID)(ELSE)landing.do(ENDIF)?id=(PARTNER-HOTEL-ID)&arrival=(CHECKINDAY)-(CHECKINMONTH)-(CHECKINYEAR)&departure=(CHECKOUTDAY)-(CHECKOUTMONTH)-(CHECKOUTYEAR)&lang=(USER-LANGUAGE)&currency=(USER-CURRENCY)

En este ejemplo, se elige entre dos páginas de destino, según si se configuró el ID de la regla de tarifas.

Para obtener más información, consulta Cómo usar variables y condiciones.