Experiencia Inmersiva 2.0 del motor de reservas de Cloudbeds - Todo lo que debes saber

Objetivo Configurar, incrustar y mantener la Experiencia inmersiva 2.0 del motor de reservas de Cloudbeds en el sitio web de tu establecimiento.
Dirigido a Administradores, gerentes y titulares de establecimientos, y el desarrollador del sitio web responsable de la implementación.
Cuándo usar esta guía Cuando quieras instalar, configurar, personalizar o solucionar problemas de la Experiencia inmersiva 2.0 en el sitio web de un establecimiento.
Requisitos Acceso a las incrustaciones premium, el dominio de tu sitio web, el código de tu establecimiento y acceso al HTML de tu sitio web.
Resultado esperado La Experiencia inmersiva 2.0 se carga en el sitio web autorizado de un establecimiento mediante el script de carga compatible y el modo de incrustación seleccionado.
Limitaciones Los creadores de sitios web basados en plantillas o sin código pueden gestionar los scripts personalizados de manera diferente. No coloques las etiquetas de los componentes web de la Experiencia inmersiva 2.0 dentro de iframes.

Introducción

La Experiencia inmersiva 2.0 del motor de reservas de Cloudbeds integra el proceso de reserva directamente en el sitio web de tu establecimiento sin recurrir al enmascaramiento mediante iframes. Debes autorizar tu sitio web a través de la lista de dominios permitidos e instalar el script de carga compatible en el HTML del sitio web para que el componente web pueda mostrarse.

Usa esta guía para realizar la implementación y conocer las consideraciones técnicas que pueden afectar el flujo de reserva, incluidas las plataformas de gestión del consentimiento (CMP), los creadores de sitios web, el seguimiento, los parámetros de búsqueda y los estilos personalizados. Para obtener información general sobre el motor de reservas, consulta Motor de reservas de Cloudbeds: todo lo que debes saber.

Índice

Acerca de la Experiencia inmersiva 2.0

La Experiencia inmersiva 2.0 del motor de reservas de Cloudbeds es un componente web que permite a los huéspedes consultar la disponibilidad, seleccionar habitaciones y tarifas, ingresar los datos del huésped y completar el pago directamente desde el sitio web de tu establecimiento. Puedes implementarla como una experiencia de página completa o abrirla desde un botón Reservar ahora.

Beneficios principales

La Experiencia inmersiva 2.0  incorpora funciones únicas diseñadas para mejorar la experiencia de reserva de tus huéspedes en tu propio sitio web:

  • Mayores tasas de conversión: Menos clics, tiempos de carga más rápidos y una experiencia de marca coherente generan más reservas.
  • Más personalización: Crea una experiencia única y memorable para los huéspedes sin las limitaciones de un iframe estándar.
  • Crecimiento basado en datos: Accede a métricas e información clave para optimizar tu proceso de reserva y aumentar las reservas directas.
  • Mayor confianza: El flujo de reserva seguro y fluido genera confianza en los huéspedes y los anima a completar el proceso de reserva.

Componentes web frente a componentes basados en iframes

A diferencia de los sistemas basados en iframes, este componente web integrado ofrece:

  • Tiempos de carga del sitio web más rápidos
  • Mayor personalización de la marca
  • Un flujo de reserva unificado que garantiza que los huéspedes permanezcan en el sitio web desde la búsqueda inicial hasta la finalización del pago

Cómo se ve

La Experiencia inmersiva 2.0 ofrece dos opciones flexibles de incrustación que se adaptan al diseño del sitio web de tu establecimiento y al recorrido del usuario. Puedes elegir entre incrustar una Experiencia inmersiva de página completa o crear e incrustar una ventana emergente con la Experiencia inmersiva.

  • La incrustación de página completa funciona tal como indica el nombre: coloca el motor de reservas completo directamente en una página de tu sitio web y ofrece a los huéspedes un proceso de reserva ininterrumpido y totalmente inmersivo de principio a fin. 

La incrustación de página completa mantiene al huésped en el sitio web del establecimiento mientras busca habitaciones disponibles, revisa las tarifas y prepara la reserva.

Incrustación de página completa de la Experiencia inmersiva 2.0 que muestra los resultados de búsqueda de habitaciones, las opciones de habitaciones y tarifas, el resumen de la reserva y el botón Reservar ahora

Durante el proceso de pago, los huéspedes ingresan los datos de contacto, la información adicional opcional, los huéspedes adicionales y las preferencias de comunicación sin salir del flujo de reserva incrustado.

Paso de información del huésped de la Experiencia inmersiva 2.0 que muestra los campos del huésped principal, la hora estimada de llegada, la información adicional, la opción de huésped adicional, las preferencias de comunicación y el resumen de la reserva

Antes de completar la reserva, los huéspedes pueden revisar las políticas de check-in, check-out y cancelación del establecimiento, además de otros términos y condiciones.

Ventana modal de términos y condiciones de la Experiencia inmersiva 2.0 que muestra las políticas de check-in y check-out, las políticas de cancelación, los términos, la casilla de aceptación y el botón Confirmar y completar reserva

  • La incrustación en ventana emergente ofrece una alternativa elegante y moderna. Cuando un huésped hace clic en el botón «Reservar ahora», un panel lateral se desliza suavemente desde el borde de la pantalla y ofrece una experiencia de reserva compacta y completamente funcional sin salir de la página actual.

Con la implementación en ventana emergente, el huésped abre la Experiencia inmersiva desde el botón Reservar ahora del establecimiento, mientras el sitio web original permanece visible detrás del panel de reservas.

Sitio web de un establecimiento que muestra el botón Reservar ahora y la Experiencia inmersiva 2.0 abierta como un panel emergente de reservas con controles de fechas, huéspedes, código promocional, filtros y búsqueda

El flujo de reserva incluye:

  • Búsqueda de disponibilidad
  • Selección de habitaciones
  • Visualización de tarifas
  • Oportunidades de venta adicional
  • Ingreso de información del huésped
  • Procesamiento seguro de pagos

 Dentro del flujo de reserva de la Experiencia inmersiva 2.0, tanto en ventana emergente como en página completa, los detalles de búsqueda del huésped, incluidas las fechas, el número de huéspedes, los códigos promocionales, las habitaciones seleccionadas y el progreso del proceso de pago, se conservan automáticamente durante un máximo de 10 minutos de inactividad. Si un huésped sale brevemente del flujo de reserva y regresa dentro de ese período, continuará exactamente donde lo dejó. Esto ofrece una experiencia de reserva más fluida y reduce los posibles abandonos.

Precios y disponibilidad

El acceso a la Experiencia inmersiva 2.0 depende de tu suscripción de Cloudbeds. Si las incrustaciones premium están incluidas en tu paquete, puedes acceder a la Experiencia inmersiva 2.0 desde la sección Premium de la pestaña Incrustaciones.

Si las incrustaciones premium no están incluidas en tu paquete, la sección Premium puede mostrar la opción Contactar a ventas. Haz clic en Contactar a ventas para solicitar más información sobre cómo cambiar a un paquete que incluya las incrustaciones premium.

 Las incrustaciones premium incluyen la Experiencia inmersiva 2.0 y soluciones relacionadas de componentes web. Las incrustaciones básicas siguen disponibles para implementaciones más sencillas basadas en widgets.

Métodos de pago personalizados y compatibilidad con procesadores de pagos

  • Recomendaciones sobre la compatibilidad con procesadores de pagos: No recomendamos usar procesadores de pagos no compatibles en la Experiencia inmersiva. Cuando los procesadores de pagos operan fuera de un dominio de Cloudbeds, no tenemos control sobre la seguridad ni el cumplimiento de PCI.
  • Limitaciones actuales: Los métodos de pago personalizados solo deben usarse en entornos alojados por el momento.
  • Compatibilidad futura: El equipo de Cloudbeds Payments está trabajando para ofrecer compatibilidad oficial con estos procesadores de pagos mediante conexiones personalizadas en la interfaz de usuario del PMS. El lanzamiento de esta función está previsto para 2026. Los clientes recibirán información más precisa sobre los plazos a medida que se acerque la fecha de lanzamiento.
  • Canal de soporte: Para recibir orientación específica sobre la implementación o resolver preguntas sobre métodos de pago personalizados, comunícate directamente con nuestro equipo de Cloudbeds Payments. Este equipo gestiona todo el SDK de pagos y es el más indicado para ayudarte.

Instalar la Experiencia inmersiva 2.0

Completa la configuración que se indica a continuación para autorizar el dominio de tu sitio web, cargar el script compatible de la Experiencia inmersiva y añadir el componente del motor de reservas a tu sitio web. Los pasos se aplican tanto a la implementación de página completa como a la del botón Reservar ahora.

 Cualquier valor que aparezca como {PARAMETER} es un marcador de posición. Reemplázalo por el valor real y elimina las llaves.

 No coloques las etiquetas de los componentes web de la Experiencia inmersiva 2.0 dentro de un iframe. Esto puede causar problemas de desplazamiento y requeriría añadir a la lista de permitidos cada elemento de la cadena de iframes, lo cual no se recomienda.

Paso 1: Confirma el acceso a las incrustaciones premium

 Importante: El acceso a las incrustaciones premium depende de tu suscripción de Cloudbeds.

  • Si las incrustaciones premium están incluidas en tu paquete, puedes acceder a las opciones de la Experiencia inmersiva 2.0 desde Motor de reservas > Incrustaciones > Premium.
  • Si las incrustaciones premium no están incluidas en tu paquete, la sección Premium puede mostrar la opción Contactar a ventas. Haz clic en Contactar a ventas para solicitar más información sobre cómo cambiar a un paquete que incluya las incrustaciones premium.
  • Si eres cliente de Cloudbeds Websites, puedes comunicarte con el equipo de Cloudbeds Websites para recibir orientación sobre la implementación y las solicitudes de activación.

Paso 2: Añade tu dominio a la lista de dominios permitidos

Añade el dominio donde instalarás la Experiencia inmersiva 2.0 en la sección Dominios permitidos de la incrustación premium seleccionada. Puedes añadir hasta 5 dominios.

  1. En el Menú de cuenta Menú de cuenta.jpg, selecciona Configuración Icono de configuración.png
  2. Haz clic en Motor de reservas Icono del motor de reservas.png
  3. Haz clic en la pestaña Incrustaciones.
  4. En la sección Premium, selecciona la opción de Experiencia inmersiva que quieras instalar.
  5. En la tarjeta Dominios permitidos, haz clic en Añadir dominio.
  6. Ingresa el dominio donde se instalará la Experiencia inmersiva y guarda los cambios.

 Se admiten tanto dominios principales como subdominios, por ejemplo, my-hotel.com y booking.my-hotel.com.

Pestaña Incrustaciones del motor de reservas que muestra la sección Premium y la tarjeta Dominios permitidos para añadir un dominio autorizado del sitio web

 Dominios permitidos: cómo verificar el formato correcto del dominio

En algunos casos, la configuración del dominio de un sitio web requiere incluir www. Para contemplar ambas posibilidades, verifica el formato de dominio que usa tu sitio web antes de añadirlo.

  1. Abre tu sitio web y revisa la URL en el navegador.
  2. Verifica si la URL incluye www. Por ejemplo, puede mostrar https://www.yourdomain.com o https://yourdomain.com.

Una vez que sepas qué formato usa tu sitio web, ingresa el dominio correspondiente en el campo Dominios permitidos. Por ejemplo, si tu sitio web se muestra con www, añade el dominio a la lista de permitidos como www.yourdomain.com.

 Por qué debes añadir los dominios a la lista de permitidos

La Experiencia inmersiva es un componente web, no un iframe. Se ejecuta en tu sitio web y realiza solicitudes de API a los servicios de Cloudbeds desde tu dominio. La lista de permitidos indica a Cloudbeds qué orígenes están autorizados para aceptar esas solicitudes entre dominios.

Paso 3: Añade el script de la Experiencia inmersiva

Añade el siguiente script en el elemento <head> del documento HTML de tu sitio web:

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Si tu sitio web usa una plataforma de gestión del consentimiento (CMP), completa la configuración de la CMP antes de publicar la implementación. Los requisitos de la CMP varían según el proveedor.

Paso 4: Incrusta el motor de reservas

Puedes mostrar la Experiencia inmersiva de dos maneras:

  • Modo estándar (incrustación de página completa): También conocido como «incrustación de página completa», es el modo predeterminado en el que la aplicación del motor de reservas se integra por completo en el sitio web anfitrión. Para incrustarla, incluye el siguiente fragmento en el HTML donde deba mostrarse:
<cb-immersive-experience mode="standard" property-code="{PROPERTY_CODE}" />
  • Modo emergente (botón Reservar ahora): Este modo muestra la aplicación del motor de reservas como una ventana emergente con posición fija y superposición. Para añadir un botón Reservar ahora que abra la Experiencia inmersiva en una ventana emergente:
<cb-book-now-button property-code="{PROPERTY_CODE}" />

  Si omites el atributo mode, el componente usa standard de forma predeterminada.

 Encuentra el código de tu establecimiento

Ve a Menú de cuenta > Configuración > Motor de reservas > pestaña Resumen. Tu código es el valor alfanumérico de 6 caracteres al final del enlace del motor de reservas:

https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}

En el siguiente ejemplo, el segmento resaltado es el código del establecimiento que debes usar en la incrustación. Reemplaza las llaves y el valor del marcador de posición en tu fragmento de código.

Pestaña Resumen del motor de reservas que muestra el código del establecimiento al final del enlace de reservas del motor de reservas

Si tu sitio web usa una plataforma de gestión del consentimiento (CMP), configura la Experiencia inmersiva para que los recursos necesarios de Cloudbeds se clasifiquen como esenciales y no se bloqueen antes de que pueda cargarse el flujo de reserva. Sigue las instrucciones de configuración específicas del proveedor que se indican a continuación antes de publicar los cambios del sitio web.

Usa la configuración específica del proveedor que corresponda a tu CMP:

  • Cookiebot: data-cookieconsent="ignore"
  • OneTrust: data-ignore-consent="true"
  • Quantcast: data-quantcast-ignore="true"
  • Termly: Añade el siguiente mapa de bloqueo personalizado antes del script de Termly, preferiblemente cerca del inicio del HTML.
<script data-termly-config>
 window.TERMLY_CUSTOM_BLOCKING_MAP = {
  "cloudbeds.com": "essential",
  "clientstream.launchdarkly.com": "essential",
  "clientsdk.launchdarkly.com": "essential",
  "tile.openstreetmap.org": "essential",
  "tokenex.com": "essential",
  "stripe.com": "essential",
  "stripe.network": "essential",
  "braintreegateway.com": "essential",
  "dlocal.com": "essential",
  "authorize.net": "essential",
  "pagosonline.net": "essential",
  "paypal.com": "essential",
  "adyen.com": "essential"
 };
</script>

Clasifica el script de carga de la Experiencia inmersiva como necesario o esencial en la configuración de tu CMP. Usa el punto de entrada actual del script de carga que se muestra a continuación. El uso directo de cb-immersive-experience.js está obsoleto.

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Dar el consentimiento no desbloquea un script que ya intentó cargarse. Después de dar el consentimiento, los huéspedes deben actualizar la página para que aparezcan los recursos de mapas, imágenes y pagos que se bloquearon previamente.

Consideraciones de configuración y solución de problemas

Las siguientes secciones describen el comportamiento y los detalles de implementación que conviene conocer antes de publicar.

Compatibilidad con creadores de sitios web

  La Experiencia inmersiva se ha probado en sitios web desarrollados a medida. Los creadores de sitios web basados en plantillas o sin código pueden gestionar los scripts personalizados de manera diferente, lo que podría afectar el funcionamiento.

  • Inserción en head: Confirma que puedas añadir el <script> de la Experiencia inmersiva en el elemento <head> de la página.
  • Lista de permitidos: Asegúrate de añadir los dominios del sitio publicado y de cualquier entorno de pruebas o vista previa en la tarjeta Dominios permitidos para que se acepten las solicitudes de API. Puedes añadir hasta 5 dominios.
  • CSS/JS personalizados: Los estilos o scripts que añadas en la sección de personalización del motor de reservas no se aplican automáticamente a la Experiencia inmersiva; añádelos al HTML de tu sitio web.
  • Página de pago: El paso de pago puede variar según el método de pago seleccionado.
  • Si el huésped elige Apple Pay, Google Pay u otra opción de pago de terceros, el sistema lo redirigirá a la página del tercero correspondiente para completar el pago.
  • Una vez que la transacción se complete correctamente, el sistema lo redirigirá de vuelta a la página de confirmación de la Experiencia inmersiva.
  • Enlaces profundos y parámetros: Los parámetros de búsqueda solo se leen durante la carga inicial. Si cambias la URL después de que se haya cargado la aplicación, vuelve a cargar la página para aplicarlos.

Portales

El motor de reservas muestra varios elementos en una posición fija en la pantalla, por ejemplo:

  • Ventanas modales
  • Descripciones
  • Calendario
  • Verificador de tarifas
  • Banner del carrito de compras (en dispositivos móviles)
  • Selectores de idioma y moneda

Estos elementos se muestran dentro de un portal. Esto significa que, en lugar de seguir la estructura del árbol DOM, están contenidos en un elemento con la clase estática .cb-portal, que se añade al final del cuerpo del documento. Los portales tienen distintos valores de z-index según la capa correspondiente en nuestro contexto de apilamiento.

La mayoría de los sitios web tienen contextos de apilamiento propios. Según cómo se definan en el eje Z imaginario, pueden entrar en conflicto con los contextos de apilamiento de la Experiencia inmersiva. 

Por ejemplo, si no se definen correctamente, el verificador de tarifas de la Experiencia inmersiva podría aparecer sobre el menú de navegación móvil del sitio web del establecimiento. También podría ocurrir que un elemento flotante del sitio web aparezca sobre el botón «Reservar ahora» del banner del carrito de compras en dispositivos móviles, lo bloquee e impida que el usuario continúe con el proceso de reserva.

Actualmente, tenemos 4 tipos de portales: modal, popover, sticky y tooltip. El tipo de portal que se usa en cada caso depende del elemento que contiene. Por lo tanto, todas las ventanas modales usan un portal modal; la ventana emergente del calendario y los selectores de idioma y moneda usan un portal popover, mientras que el banner del carrito de compras en dispositivos móviles y el verificador de tarifas usan un portal sticky, por mencionar algunos ejemplos.

Según el tipo de portal, estos son los valores que usa la Experiencia inmersiva para la propiedad CSS z-index:

  • Modal: 1400
  • Popover: 1500
  • Sticky: 1100
  • Tooltip: 1800

Solución de problemas de superposición

Si los elementos que muestra la Experiencia inmersiva se superponen a otros elementos del sitio web anfitrión, te recomendamos buscar el portal que los contiene, es decir, el elemento con la clase estática .cb-portal , y ajustar el valor de z-index según corresponda. También puedes ajustar el valor de z-index del elemento del sitio web anfitrión.

Puedes personalizar los valores de z-index de los distintos tipos de portales que muestra la Experiencia inmersiva redefiniendo las variables CSS que se usan para este fin, como se muestra en el siguiente ejemplo:

<style>
/* Scope to the Booking Engine root when overriding */
.cb-bookingengine-root {
  --booking-engine-zIndices-sticky: 1100;
  --booking-engine-zIndices-modal: 1400;
  --booking-engine-zIndices-popover: 1500;
  --booking-engine-zIndices-tooltip: 1800;
}
</style>

 The Rate Checker is included with all Cloudbeds Booking Engine packages except Legacy plans. Properties on active packages can enable it at no additional cost.

 

Parámetros de búsqueda y seguimiento

La Experiencia inmersiva puede leer los parámetros de búsqueda compatibles cuando la aplicación se carga por primera vez y puede funcionar con herramientas de analítica y publicidad instaladas en el sitio web. Consulta las siguientes secciones de referencia cuando necesites pasar valores de búsqueda, configurar el seguimiento o comprender los parámetros de Google Hotel Ads.

Parámetros de búsqueda

La Experiencia inmersiva admite los mismos parámetros de búsqueda que la versión alojada. Los parámetros solo se leen durante la carga inicial y no se actualizan dinámicamente.

Nombre Tipo Descripción Ejemplo
adults Número Número de adultos de la reserva que se usa al buscar habitaciones disponibles. adults=2
allotment_block_code Cadena de texto Código del bloqueo de asignación que se usa al consultar las habitaciones para las fechas seleccionadas. allotment_block_code=b123456
checkin YYYY-MM-DD Fecha seleccionada para el check-in. checkin=2025-12-01
checkout YYYY-MM-DD Fecha seleccionada para el check-out. Si se proporciona checkin, pero no checkout, se usa el día siguiente de forma predeterminada. checkout=2025-12-01
currency Código de moneda ISO-4217 de 3 letras Moneda seleccionada. Si no se proporciona ninguna, el motor de reservas usa la moneda predeterminada del establecimiento. currency=brl
kids Número Número de menores de la reserva que se usa al buscar habitaciones disponibles. kids=1
promo Cadena de texto Código promocional que se usa al consultar las habitaciones para las fechas seleccionadas. promo=superpromo
rate_plan Cadena de texto con valores separados por punto y coma Permite filtrar los resultados de habitaciones según los planes de tarifas. Corresponde al «Nombre privado del plan de tarifas» en el PMS. rate_plan=3DAYSTAY;LOWSEASON
rid Cadena numérica con valores separados por punto y coma Lista de ID de habitaciones para filtrar los resultados de habitaciones. rid=27434;23421
room_type Cadena de códigos de 3 letras separados por punto y coma Corresponde a la «Abreviatura de la habitación» en el PMS y se usa para filtrar los resultados de habitaciones. Si no se proporcionan las fechas de check-in y check-out, el motor de reservas selecciona automáticamente mañana y el día siguiente. room_type=PRI;SHA
utm_source Cadena de texto Se usa para identificar la fuente de la campaña de marketing (por ejemplo, Google, TripAdvisor o Trivago). utm_source=Google

Seguimiento y analítica

La Experiencia inmersiva admite los mismos parámetros de búsqueda que la versión alojada. Los parámetros se leen desde la URL de la ventana únicamente durante la carga inicial de la aplicación. Esto significa que los cambios dinámicos en los parámetros de búsqueda no afectan a la Experiencia inmersiva una vez que se ha cargado. 

Además, la Experiencia inmersiva no actualiza la URL de la ventana como lo hace la versión alojada después de determinadas acciones del usuario, por ejemplo, al seleccionar las fechas de check-in y check-out.

  • Google Analytics 4 / GTM: Debes inicializar el ID de la etiqueta de Google o el ID del contenedor de GTM en el sitio web del hotel.
  • Google Ads: El seguimiento de conversiones requiere una configuración manual en el sitio web del establecimiento.
  • Píxel de Meta: Debes añadir el script del píxel de Meta en el elemento <head> del HTML para inicializarlo.

Para obtener más información sobre la configuración, consulta la documentación de cada plataforma de seguimiento.

Añade manualmente los scripts de Google Tag Manager (GTM) o Google Analytics 4 (GA4) al elemento <head> de tu HTML para habilitar el seguimiento.

Parámetros de búsqueda de Google Hotel Ads

Google Hotel Ads añade estos parámetros y el motor de reservas los envía al servidor en la solicitud al realizar una reserva:

Parámetro
gha_advance_booking_window
gha_campaign_id
gha_google_site
gha_is_ad_click
gha_is_click_type_hotel
gha_is_click_type_room
gha_is_hotel_campaign
gha_is_promoted
gha_length
gha_position
gha_price_displayed_total
gha_promo_code
gha_user_country
gha_user_currency
gha_user_device
gha_user_language
gha_user_list_id

Personalizar la Experiencia inmersiva 2.0

Adapta la Experiencia inmersiva mediante los atributos del componente y tu propio código CSS/JS en el sitio web.

 El código personalizado puede requerir mantenimiento con el tiempo

  • A medida que evoluciona el motor de reservas, las personalizaciones que implementes por tu cuenta pueden dejar de funcionar o necesitar actualizaciones.
  • Siempre que sea posible, prueba los cambios en un entorno de pruebas o en una copia de borrador de tu sitio web antes de publicarlos.

Atributos de los componentes cb-immersive-experience y cb-book-now-button

Tanto el modo Estándar como el modo Emergente comparten estos atributos (consulta Incrusta el motor de reservas).

Todos los siguientes atributos son opcionales, excepto property-code, y tanto el componente web cb-immersive-experience como cb-book-now-button los admiten.

Nombre Tipo Obligatorio Valor predeterminado Descripción
currency (*) Código de moneda ISO-4217 de 3 letras No Moneda predeterminada del establecimiento Moneda que se usa durante la carga inicial de la Experiencia inmersiva.
disable-css-title-reset yes | no No no Usa yes si quieres definir tus propias reglas CSS para los encabezados de la interfaz de usuario (h1… h6).
hide-custom-header yes | no No no Permite ocultar el encabezado personalizado definido en el PMS.
hide-custom-footer yes | no No no Permite ocultar el pie de página personalizado definido en el PMS.
hide-property-info yes | no No no Permite ocultar la sección Información del establecimiento en todas las páginas.
ignore-search-params (*) yes | no No no De forma predeterminada, la Experiencia inmersiva lee los parámetros de consulta de la URL del sitio web anfitrión y los usa durante la carga inicial de la aplicación. Admite los mismos parámetros que el motor de reservas alojado.
lang (*) auto-detect | código de idioma de 2 letras ISO 639-1  No Idioma predeterminado del establecimiento. Idioma que se usa durante la carga inicial de la Experiencia inmersiva. Si no se proporciona ninguno, la Experiencia inmersiva revisa el atributo lang del HTML. Si tampoco está definido, usa el idioma predeterminado del establecimiento. Si se proporciona el valor auto-detect, la Experiencia inmersiva se carga en el idioma del navegador del usuario.
mode standard | popup No standard Modo en el que debe mostrarse la Experiencia inmersiva. Usa popup cuando la Experiencia inmersiva se muestre dentro de un contenedor con una altura fija o máxima.
property-code (*) Código alfanumérico de 6 caracteres que identifica tu establecimiento. Sí No aplica Código alfanumérico de 6 caracteres que representa al establecimiento. Es el mismo código que se usa en la URL del motor de reservas: https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}.

  Los atributos marcados para la carga inicial solo se leen una vez, cuando se inicia la aplicación. Si los cambias posteriormente en el sitio web de tu establecimiento, no afectarán a una Experiencia inmersiva que ya se haya cargado.

Atributos personalizados del botón Reservar ahora

Estas opciones se aplican al componente cb-book-now-button (consulta la sección Incrusta el motor de reservas) y te permiten dar estilo al botón y controlar la etiqueta y las dimensiones de la ventana emergente.

Atributo Descripción
class-name Clase CSS para dar estilo al botón.
close-label Etiqueta personalizada del botón de cierre.
height Altura de la ventana emergente.
width Ancho de la ventana emergente.

Ejemplo del botón Reservar ahora con etiqueta, tamaño y clase CSS:

<cb-book-now-button
  property-code="{PROPERTY_CODE}"
  class-name="cb-book-now-button"
  label="Book Now"
  height="90vh"
  width="90vw"
/>

Añade CSS y JavaScript personalizados para la Experiencia inmersiva

El código CSS o JavaScript personalizado que añadas en los campos de personalización del motor de reservas no se aplica automáticamente a la Experiencia inmersiva. Debes añadirlo manualmente al documento HTML.

Añade el atributo data-cb-immersive-experience-root a las etiquetas style y script para evitar conflictos.

Ejemplo de CSS personalizado:

<style data-cb-immersive-experience-root>
  :is(#cb-bookingengine, .cb-bookingengine-root) {
    h1 {
      font-family: serif;
      font-size: 24px;
    }
  }
</style>

Siguiente paso operativo

Después de instalar y probar la Experiencia inmersiva 2.0 en tu dominio autorizado, consulta la guía de la pestaña Incrustaciones del motor de reservas de Cloudbeds cuando necesites comparar o configurar otras opciones de incrustación.

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.