Documentación Técnica: Diccionario de Eventos del Data Layer de Pxsol

Esta referencia detalla los eventos que el motor de reservas Pxsol envía automáticamente al Data Layer, indicando su propósito, cuándo se disparan y los datos clave que contienen. Es la guía esencial para configurar tus etiquetas en Google Tag Manager (GTM).

1. Eventos de Contexto (Información de la Sesión)

Estos eventos establecen la información base de la sesión (hotel, fechas, usuarios, etc.).

Evento	Significado	¿Cuándo se dispara?	Datos Clave que se envían
px_context	Contexto global de la sesión.	Al cargar cualquier página del sitio, una sola vez por carga.	pos (código de venta), product_id (ID del hotel), search_id (ID de la búsqueda actual), start_date/end_date (fechas), adults/children/rooms, value y currency, session_id.
px_context_update	Actualización dinámica de los parámetros del contexto.	Cuando se modifican los parámetros de búsqueda (fechas, adultos, etc.) o cuando se actualiza el transaction_id en la página de gracias.	Solo incluye los parámetros que cambiaron (ej. value actualizado, transaction_id).

2. Eventos de Búsqueda y Demanda

Permiten medir las intenciones del usuario antes de la compra.

Evento	Significado	¿Cuándo se dispara?	Datos Clave que se envían
search_modify	El usuario modificó los parámetros de la búsqueda.	Al cambiar fechas de entrada/salida o modificar el número de adultos, niños o habitaciones.	start_date, end_date, rooms, adults, children.
no_inventory	¡Demanda no atendida! No hay disponibilidad para la búsqueda realizada.	Automáticamente al detectarse el texto "No hay resultados".	no_inventory (siempre true), start_date, end_date, adults, children de la búsqueda.

3. Eventos de Formularios (Embudo de Conversión)

Se enfocan en el seguimiento paso a paso del proceso de checkout (reserva).

Evento	Significado	¿Cuándo se dispara?	Datos Clave que se envían
form_view	El usuario vio el formulario.	Al cargar la página que contiene el formulario de checkout.	form_id (Identificador del formulario).
form_interaction	El usuario interactuó con un campo del formulario.	Al hacer focus o al cambiar valores en campos (ej. hacer click para añadir adultos o escribir en un campo de texto).	form_id, field_name (nombre del campo, ej: "email", "party_adults").
form_submit	El usuario hizo click en el botón de enviar (antes de la validación del servidor).	Al hacer submit del formulario (click en botón o Enter).	fields_status ("complete" o "incomplete"), email_provided (boolean), phone_provided (boolean).
form_success	¡Conversión completada! El formulario se envió correctamente y se generó una reserva.	En la página de gracias (/neo_checkout/gracias.php), después de que el servidor procesa exitosamente el formulario.	form_id, lead_id (ID del lead/reserva), transaction_id (ID de transacción/BookingID).

4. Eventos de Chat

Se enfocan en la medición de la interacción del usuario con el widget de chat.

Evento	Significado	¿Cuándo se dispara?	Datos Clave que se envían
chat_open	El usuario abrió el widget de chat.	Al hacer click en el botón del chat.	chat_session_id (ID único de sesión del chat).
chat_message	El usuario envió un mensaje.	Al enviar un mensaje (Enter o click en botón enviar).	duration_sec (segundos desde que se abrió el chat), message_type ("user", "bot", "agent").
chat_close	El usuario cerró el widget de chat.	Al hacer click en el botón de cerrar.	duration_sec (Duración total en segundos que el chat estuvo abierto).

5. Eventos Auxiliares (Para Debugging)

Estos eventos son principalmente de validación y debugging (depuración).

Evento	Significado	Utilidad
px_layer_ready	El Data Layer está listo y funcionando.	Útil para validar la integración inicial en herramientas como GA4 DebugView.

Notas de Privacidad y Cumplimiento

No PII: El sistema de Pxsol no envía Información Personal Identificable (PII) directamente al Data Layer.
Seguridad: Se usan flags booleanos (ej. email_provided: true) en lugar de los valores reales (el email o el teléfono del usuario) para asegurar que los datos se envían de forma privacy-safe.