Widget de reserva directa
Añade a la web de un hotel el widget de reserva directa de StayParity con un solo código. El código, el dock, lo que ve el visitante y la CSP que necesita.
El widget es un pequeño recuadro de precios en la web del propio hotel. Muestra el precio de la web para una estancia y, si el hotel es el más barato o iguala el mínimo, los precios de las OTAs junto a él. Funciona en un iframe aislado: no puede leer la página que lo contiene y la página no puede acceder a su contenido. El aislamiento solo le permite dos acciones, y siempre tras un clic del visitante: abrir la página de reservas del hotel en la misma pestaña y abrir stayparity.com en una pestaña nueva desde su enlace de crédito.
La página del widget explica qué dice el widget a los clientes y por qué. Esta página explica cómo ponerlo en una web.
Añadir a una página
- En Configuración → Widget de la web, activa Widget. El portal te pedirá la página de reservas del hotel, que sigue en la misma pantalla, en Página de reservas, para cambiarla después. El botón Book direct, en el idioma del visitante con la traducción activada, abre la página de reservas en la misma pestaña.
- Copia el código del apartado Código, en la pestaña Pegar: la etiqueta script, que incluye la clave del hotel y nada más. La pestaña Gestor de etiquetas da la misma etiqueta, con los pasos para una etiqueta de tipo HTML personalizado. La pestaña Reenviar da un mensaje con el código, dónde va y cómo comprobarlo, para enviarlo a quien se ocupe de tu web.
- Pégalo una vez en cada página que deba mostrar el widget, o en el pie de tu web. El widget aparece en una esquina inferior de la ventana, esté donde esté la etiqueta, así que puede ir en cualquier sitio dentro de
<body>. Después, en la página Widget del portal, usa Revisar mi web con la dirección de la página: te dice si la etiqueta está en la página y si la política de seguridad de tu web deja cargar el widget.
<!-- Widget de reserva directa de StayParity. Su apariencia se configura en StayParity. -->
<script src="https://badge.stayparity.com/embed.js" data-hotel="wk_aurora" async></script>El script añade el iframe al final de la página y no toca nada más. El iframe ajusta su altura al contenido.
El dock
El widget es un dock: una barra en una esquina inferior de la ventana que aparece cuando llega el precio de la web del hotel. Con un clic se despliega en una tarjeta con la respuesta completa, y la flecha al pie de la tarjeta o Escape lo vuelven a plegar. El visitante no puede cerrarlo: sigue ahí durante toda la vista de la página. Si en su esquina ya hay un botón de chat o una barra de reserva fija, el dock se eleva por encima o pasa a la otra esquina inferior, y se queda donde está si ninguna de las dos posiciones está libre. Se oculta mientras un aviso de cookies habitual se extiende sobre él.
En Apariencia, dentro de Configuración → Widget de la web:
- Esquina del dock elige la esquina izquierda o la derecha, y Altura del dock, a qué distancia del borde inferior de la ventana queda, hasta 200 píxeles.
- Color del botón es Automático, oscuro sobre un fondo claro y claro sobre uno oscuro, o un color propio. Se rechaza un color que contraste menos de 3:1 con el fondo.
- Fondo es Claro, Oscuro o Sistema del cliente, que sigue el modo claro u oscuro que tenga configurado el visitante.
- Esquinas son Rectas, Redondeadas o Píldora.
Cada cambio llega a todas las páginas con la etiqueta en menos de un minuto, con el mismo código. El widget pide su configuración a StayParity en cada carga de página.
Idioma
El widget está en inglés. Si activas Traducir el widget en Configuración → Widget de la web, se muestra en el idioma del visitante cuando su navegador prefiere el griego, el español, el italiano, el alemán o el checo, y en inglés en los demás casos. Se guía por los idiomas configurados en el navegador del visitante, no por el idioma de tu página, y escribe precios y fechas como se hace en ese idioma. Está desactivado hasta que lo actives, y llega a todas las páginas con la etiqueta en menos de un minuto, sin código nuevo.
Moneda
El widget muestra los precios en la moneda del hotel. Con Los clientes pueden cambiar la moneda activado, un código de moneda en el pie del dock abre un menú con las monedas que ofreces, la del hotel en primer lugar, y todos los precios de la tarjeta pasan a la moneda que elige el visitante, convertidos al tipo de cambio de referencia del día. La comparación en sí, y lo que cobra la página de reservas, siguen en la moneda del hotel. Con Abrir en la moneda del cliente activado, el widget empieza en la moneda de la región del visitante, deducida del idioma de su navegador, si la ofreces.
Atributos
La etiqueta admite dos atributos:
data-hotel, obligatorio: la clave del hotel,wk_…. Sin ella, la etiqueta no muestra nada.data-consent="none", opcional: StayParity no cuenta esa vista de página en las estadísticas del widget, y el widget no guarda nada en el navegador del visitante, así que Guardar la noche, Apertura automática y la oferta de salida no aparecen en esa página, y el modo de prueba dura una sola página. Los precios que muestra no cambian. Para que el widget no aparezca en una página hasta que el visitante dé su consentimiento, carga en su lugar la etiqueta desde tu gestor de consentimiento o de etiquetas.
La apariencia, el idioma y la moneda vienen de StayParity, y la noche, de la página.
Qué noche cotiza
El widget cotiza una noche: la fecha de llegada, con su fecha de salida o su número de noches, y el número de adultos que elige el visitante. Solo los busca en la dirección de tu página, en los campos de tu formulario de reservas y, en las páginas de reservas de Mews y Cloudbeds, en los eventos que esos motores de reservas envían al dataLayer de la página, y no lee nada más de la página. Hasta conocer una estancia, muestra la noche más próxima de los próximos 7 días cuyo precio hemos obtenido en las últimas 24 horas, mientras Noche más próxima con precio esté activada, como lo está desde el principio. Con esa opción desactivada, o si no hay ninguna noche así, no muestra nada ni ocupa espacio. Una estancia sin número de adultos, o con niños o más de una habitación, se cotiza para dos adultos o, si el hotel no se revisa para dos, para el número más bajo para el que se revisa. Muestra la noche del visitante en cuanto conoce la estancia, por ejemplo en el momento en que el visitante elige fechas en tu formulario de reservas.
El widget solo inicia una revisión nueva para las ocupaciones para las que se supervisa el hotel. Para otras, muestra un precio ya obtenido o, si no lo hay, el precio para dos adultos o para el número más bajo para el que se revisa el hotel, y lo indica.
Qué lee:
- La dirección de la página, al cargar y cada vez que cambia, como ocurre cuando un motor de reservas busca sin recargar la página. La llegada de
checkin,checkInDate,arrival,arrivalDate,arrive,startDate,dateFrom,fromDateomewsStart; la salida decheckout,checkOutDate,departure,departureDate,depart,endDate,dateTo,toDateomewsEnd; las noches denightsolos; los adultos deadults,adult,adultCount,adultQty,numAdults,numberOfAdultsomewsAdultCount; los niños dechildren,child,childCount,childQty,kidsonumChildren; las habitaciones derooms,numRoomsoroomCount. No importan las mayúsculas ni la puntuación, así quecheck_inyCheck-Intambién cuentan, pero el nombre tiene que coincidir entero: coninoitems[0][adults]no se lee nada. Un total de huéspedes, comoguests,pax,personsuoccupancy, nunca cuenta como adultos. - Los campos de tu formulario de reservas, en cuanto el visitante cambia uno. Un campo cuenta si su
name, suido la última parte[...]de su nombre es uno de los nombres anteriores, comoarrival_dateoinfo[arrival_date]. Nunca lee campos ocultos, de contraseña, email, teléfono, archivo, casilla de verificación o botón de opción, campos que el navegador rellena con un nombre, un email, un número de teléfono o una tarjeta, ni campos desactivados. Un formulario tal como se cargó solo cuenta cuando el visitante cambia uno de sus campos, así que un formulario que se abre con la fecha de esta noche ya rellenada deja visible la noche más próxima con precio hasta que el visitante elige.
Prevalece la última estancia que lee, venga de donde venga. Una dirección que solo contiene los valores predeterminados de un motor de reservas, una noche a partir de hoy para dos adultos, solo cuenta cuando cambia. La primera noche que conoce se revisa al momento. Después, el widget espera medio segundo tras el último cambio del visitante antes de volver a consultar, así que un calendario que rellena dos campos cuesta una sola revisión. Un selector que escribe sus campos sin un evento change se lee 300 milisegundos después del clic del visitante.
Lee fechas escritas como 2027-06-14, 2027/06/14, 20270614, 14/06/2027 o 06/14/2027 (con /, . o -), y como 14 Jun 2027 o Jun 14, 2027, con los nombres de los meses en los seis idiomas del widget y en francés. Se omite una fecha numérica que admite dos lecturas y da dos estancias posibles. Una estancia dura de 1 a 30 noches, entre hoy y dentro de 500 días. No lee formularios dentro de otro marco o de un shadow root, ni selectores de fechas o de huéspedes que no son campos de formulario.
Si tu formulario de reservas funciona en su propio marco, o usa selectores de fechas y huéspedes que no son campos de formulario, el widget no ve la noche: muestra la noche más próxima con precio o, con Noche más próxima con precio desactivada, nada. En ese caso, pon la estancia en la dirección de la página, por ejemplo ?checkin=2027-06-14&checkout=2027-06-15&adults=2.
Qué ve el visitante
El widget compara el precio de la web con los precios de las OTAs para esa noche, y solo muestra las OTAs cuando reservar directamente es lo más barato o cuesta lo mismo:
| Resultado | Texto del widget | Precios mostrados |
|---|---|---|
| Hotel más barato | Save €16 | El precio de cada OTA para la misma estancia |
| Igual que la OTA más barata, al céntimo | Same price, booked direct | El precio de cada OTA para la misma estancia |
| OTA más barata | El precio de la web, por ejemplo €188 per night | Ninguna OTA |
| Ninguna OTA tiene precio esa noche | El precio de la web, por ejemplo €188 per night | Ninguna OTA |
Plegado, el dock dice Save €16 by booking direct, Same price as Booking.com o, sin ninguna OTA que mostrar, Best price here: €188 per night.
La tarjeta se abre con una línea que indica la noche que cotizó, por ejemplo Night of Sat 4 Oct · 2 adults o Tonight, y el tiempo desde la revisión, por ejemplo Checked 12 min ago (se omite si la revisión tiene más de una semana). Debajo, sobre el título, un sello dice Best price here en todos los casos. Cuando el widget muestra las OTAs, aparecen bajo Same stay elsewhere, cada una con su logotipo, su nombre y su precio. El botón Book direct lleva el precio de la web para esa noche. Al pie de la tarjeta, Price check by StayParity abre stayparity.com en una pestaña nueva, entre la flecha que pliega la tarjeta y, si dejas que los visitantes cambien de moneda, el selector de moneda.
Para contar en tu propia analítica las reservas que trae Book direct, consulta Mide el widget en tu analítica. Para citar la misma respuesta en un chatbot o en un widget propio, consulta la API de comprobación de precios.
Mientras se hace la primera revisión de una estancia, y si no llega ningún precio, el dock no muestra nada. El widget no muestra nada ni ocupa espacio cuando:
- el hotel está inactivo.
- aún no se ha obtenido un precio para la estancia, se rechaza la revisión (la estancia está en el pasado, fuera del horizonte del plan o se ha agotado la cuota) y tampoco hay precio para dos adultos o, si el hotel no se revisa para dos, para el número más bajo para el que se revisa.
Los precios usan el formato del navegador del visitante, en la moneda del hotel o en la que elija el visitante. Los textos del widget están en inglés, o en el idioma del visitante si la traducción está activada.
Información que no se muestra
- Un precio de una OTA más bajo que el del hotel, ni siquiera que haya uno. Si hay una OTA más barata, el dock muestra solo el precio de la web en lugar de listar únicamente las más caras. La API tampoco revela nunca una disparidad: responde a esa noche exactamente igual que a una que ninguna OTA vende, así que ni el visitante ni un script que lea el endpoint pueden distinguirlas. El hotel sigue viendo la disparidad en el portal y en sus alertas.
- No aparecen identificadores internos, origen de datos ni nivel de confianza.
- Errores. El iframe no ocupa espacio mientras se hace la primera revisión, y sigue oculto si la revisión falla. Si una respuesta indica clave desconocida o widget desactivado, el iframe se reduce a altura cero y no deja ningún hueco en la página. El widget ya cargado puede seguir visible en el navegador hasta cinco minutos.
Qué guarda en el dispositivo del visitante
Ni el iframe ni el script usan cookies. Con las opciones adicionales del hotel desactivadas, no guardan nada en el navegador del visitante. Guardar la noche, Apertura automática y la oferta de salida guardan, cada una, una pequeña nota en el dispositivo del visitante, en el almacenamiento de tu página, bajo la clave del hotel:
- Guardar la noche: la noche y el número de adultos que guardó el visitante, en localStorage, escrita cuando pulsa Keep. El widget la elimina cuando el visitante vuelve a pulsar Kept y, la próxima vez que entra en una página en la que se carga tu widget, si ya ha pasado la fecha de llegada o la opción está desactivada.
- Apertura automática y la oferta de salida: en sessionStorage hasta que se cierra la pestaña, una nota escrita cuando el dock se abre solo o porque el visitante va a salir de la página, o cuando el visitante lo pliega, para que no vuelva a abrirse solo.
- La oferta de salida: en sessionStorage hasta que se cierra la pestaña, una nota escrita cuando se muestra la oferta o el visitante hace clic en Book direct, para que no vuelva a mostrarse cuando vaya a salir. En localStorage, la hora a la que el visitante cerró la oferta, para que siga cerrada durante 7 días. El widget elimina esa nota la próxima vez que el visitante entra en una página en la que se carga tu widget, pasados los 7 días, o una vez que la oferta deja de mostrarse: porque está desactivada o porque no hay ningún código activo.
Puede que tu aviso de cookies o tu gestión del consentimiento tengan que incluir estas notas. Con data-consent="none" no se lee ni se escribe ninguna.
El modo de prueba (#stayparity-debug en la dirección de la página) guarda su idioma en el sessionStorage de esa pestaña.
Qué cuenta
Salvo que la etiqueta tenga data-consent="none", el iframe envía a StayParity un recuento por cada vista de página en la que apareció, cuando la página se oculta o se cierra o el visitante hace clic en Book direct. Estos recuentos son las cifras del widget en el portal. El primer envío de cada vista de página contiene:
- la clave del hotel y el dominio de la página;
- el idioma del navegador, y si la pantalla tiene el tamaño de un móvil;
- qué noche cotizó el widget: la estancia del visitante, la fecha del visitante para otro número de adultos o la noche más próxima con precio;
- su resultado, por ejemplo que reservar directamente es lo más barato o que cuesta lo mismo;
- si es una franja o un dock, y si el modo de prueba está activado;
- si mostró un precio y llegó a verse en pantalla, si el visitante abrió el dock o hizo clic en Book direct, si se mostró la oferta de salida, si el visitante copió su código o guardó la noche, y si el dock se abrió solo.
Si después el visitante hace algo más, como copiar el código, un envío posterior lleva solo la clave del hotel, el dominio y cuáles de estas acciones realizó. Ningún envío lleva un identificador, la dirección de la página ni una fecha de estancia.
El servidor perimetral que recibe los recuentos usa la dirección IP del visitante solo como clave de su límite de frecuencia, 30 envíos por minuto, clave que Cloudflare conserva durante ese minuto. El servidor no registra la dirección ni la transmite, y StayParity nunca la guarda.
Content Security Policy
Si tu web envía una cabecera Content-Security-Policy, permite que el origen del widget cargue el script y el marco, y que el script lea la configuración del widget:
script-src https://badge.stayparity.com;
frame-src https://badge.stayparity.com;
connect-src https://badge.stayparity.com;Añade el origen a las fuentes que tu web ya permite, sin sustituirlas.
El script pide al origen del widget su configuración antes de crear el marco, y es connect-src lo que lo permite. Sin esa directiva el widget sigue funcionando, pero el navegador registra una infracción de CSP en cada vista de página, y el marco empieza donde está la etiqueta y luego deja paso a un segundo marco al final de la página, así que se carga dos veces. El script establece el tamaño del marco mediante el DOM, no con atributos style en el HTML, así que el código no requiere cambiar style-src.
Los precios se piden dentro del iframe, bajo su propia política. Si tu política usa nonces o strict-dynamic, añade a la etiqueta el nonce de tu web; la lista de hosts por sí sola puede no ser suficiente.
Desactivar o sustituir
- Desactiva Widget en Configuración → Widget de la web. Los visitantes nuevos no verán el widget; el widget almacenado en el navegador puede seguir visible hasta cinco minutos. Al reactivarlo funciona la misma etiqueta.
- Para cambiar la apariencia o la moneda del widget, cambia Apariencia o los ajustes de moneda en Configuración → Widget de la web. Todas las páginas con la etiqueta lo siguen en menos de un minuto, con el mismo código.
- Para traducirlo, activa Traducir el widget en Configuración → Widget de la web. Todas las páginas con la etiqueta lo siguen en menos de un minuto, con el mismo código.
- Sustituir código genera una nueva clave. La anterior se rechaza en la siguiente solicitud sin caché. Actualiza todas las páginas que la usan. El widget en caché puede seguir visible hasta cinco minutos.
Solo los administradores de la cuenta pueden activar o desactivar el widget, cambiar su apariencia, su idioma o su moneda, o sustituir el código.
Carga
El script usa async, así que nunca retrasa la página. Comprimidos, tal como los descargan los navegadores, el script ocupa unos 9 kB y el marco del widget, unos 32 kB más de script, sin fuentes web que descargar.
Cada vista de página tiene un solo marco, creado cuando la página ha terminado de cargar (o 3 segundos después de que se haya analizado, si eso ocurre antes) y el navegador está inactivo, así que nunca compite con la carga de la propia página. Cuando la política de la web omite connect-src, el marco empieza donde está la etiqueta y se sustituye al final de la página, así que se carga dos veces.
Una página cuyo widget está desactivado no tiene marco. Antes de conocer la noche, el widget solo pide la noche más próxima con precio y, con Noche más próxima con precio desactivada, nada. Después, solo vuelve a consultar cuando el visitante se decide por otra noche.
Webhooks
El evento JSON firmado que StayParity envía cuando una OTA vende por debajo del precio de la web de un hotel. Firmas, reintentos y pruebas.
API de comprobación de precios
Lee desde tu chatbot el veredicto tras el widget de StayParity de un hotel: un GET, el precio en su web y las OTAs que iguala o mejora, nunca una disparidad.