# Ruleta de la Fortuna y Pop-up Exit-Intent — Guía completa > Presentación La Ruleta de la Fortuna y Pop-up Exit-Intent intercepta a los visitantes en el momento exacto en que van a abandonar tu tienda y les propone un juego: introducen… - Página: - Idioma: es - Actualizado el: 2026-06-27 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfexitwheel/index.md), [en](https://www.datafirefly.com/en/documentation/dfexitwheel/index.md), [de](https://www.datafirefly.com/de/documentation/dfexitwheel/index.md), [it](https://www.datafirefly.com/it/documentation/dfexitwheel/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexitwheel/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexitwheel/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexitwheel/index.md) - Índice: ## Presentación La **Ruleta de la Fortuna y Pop-up Exit-Intent** intercepta a los visitantes en el momento exacto en que van a abandonar tu tienda y les propone un juego: introducen su email, giran la ruleta y se van con un cupón. Conviertes un abandono silencioso en un lead cualificado y, a menudo, en un pedido inmediato. La particularidad del módulo es que **el premio ganador se determina en el servidor** mediante un sorteo ponderado. Las probabilidades nunca llegan al navegador: la ruleta solo anima un resultado ya decidido en PHP, lo que hace imposible cualquier manipulación del lado del cliente. El módulo es compatible con PrestaShop 8.0 a 9.x, sin Composer ni dependencias externas. Todos los textos son personalizables y multiidioma. ## Instalación 1. En el back office, abre **Módulos > Gestor de módulos**. 2. Haz clic en **Subir un módulo** y selecciona el archivo `dfexitwheel.zip`. 3. La instalación crea automáticamente tres tablas (segmentos, leads, configuración), seis segmentos por defecto y dos pestañas de administración. 4. El módulo queda activo de inmediato con valores por defecto funcionales. No es necesario ningún ajuste para empezar: la ruleta funciona justo tras la instalación. Después puedes afinar los segmentos, los textos y los disparadores. ## Configuración general Desde la página de configuración del módulo (**Configurar**), ajustas: - **Activar el módulo**: interruptor general. - **Título, subtítulo, placeholder de email, texto del botón**: todas las etiquetas de la pop-up, por idioma. - **Texto de consentimiento (RGPD)**: la frase mostrada junto a la casilla de consentimiento obligatoria. - **Mensaje de premio / de no premio**: lo que se muestra tras el sorteo. - **Color principal**: el color de acento de la pop-up y de la ruleta. - **Retardo de elegibilidad**: tiempo mínimo en el sitio antes de que la pop-up pueda activarse. - **Frecuencia (días)**: tiempo durante el cual un visitante no volverá a ver la pop-up. - **Mostrar a clientes conectados**, **Activar en móvil**, **Temporizador móvil**. - **Validez por defecto de los cupones**, **Un solo juego por email**, **Suscribir a la newsletter**. Los campos de texto son multiidioma: usa el selector de idioma de cada campo para introducir una versión por idioma de la tienda. ## Gestionar los segmentos de la ruleta La pantalla **Segmentos de la ruleta** lista las porciones mostradas. Para cada una defines: - **Etiqueta**: el texto impreso en la porción (p. ej. "-10%", "Envío gratis", "¡Mala suerte!"). - **Color**: el color de fondo de la porción. - **Tipo de premio**: descuento porcentual, descuento de importe fijo, envío gratis o ninguno (sin premio). - **Valor**: el porcentaje o el importe según el tipo. - **Peso**: la probabilidad relativa de caer en este segmento. Un peso alto = segmento frecuente. - **Importe mínimo**: carrito mínimo requerido para que el cupón se aplique. - **Prefijo de código** y **validez (días)** propios del segmento. - **Posición** y **activo**. ### Cómo funciona la ponderación El sorteo suma los pesos de todos los segmentos activos y luego selecciona un segmento de forma proporcional a su peso. Ejemplo: con pesos 25, 30, 20, 15, 8 y 2, el segmento de peso 2 (el premio mayor) sale aproximadamente 2 veces de cada 100. Mantienes así un control total sobre la generosidad de la ruleta. Para una ruleta rentable, mantén uno o dos segmentos "sin premio" o de descuento bajo con un peso alto, y reserva los grandes descuentos para pesos bajos. ## Cupones y reglas de carrito En cada premio, el módulo crea una **regla de carrito de PrestaShop (CartRule) realmente única**: - Un solo uso total y uno por cliente. - Una fecha de caducidad calculada a partir de la validez del segmento (o la validez por defecto). - Un importe mínimo opcional. - Un código único generado para cada ganador. Son posibles tres tipos de recompensa: **porcentaje**, **importe fijo** y **envío gratis**. El código se muestra al ganador con un botón de copia y un enlace pre-rellenado a la tienda. Como cada código es nominativo y de un solo uso, no puede compartirse ni revenderse en sitios de ofertas, a diferencia de un código genérico. ## Leads recogidos y exportación CSV La pantalla **Leads recogidos** registra cada participación: email, segmento obtenido, código de cupón, consentimiento, fecha, idioma y tienda. La lista es de solo lectura y ofrece una **exportación CSV** para alimentar tu herramienta de emailing. Si la opción **Suscribir a la newsletter** está activa, el email también se añade a los suscriptores nativos de PrestaShop (tabla de suscripción a la newsletter) cuando se da el consentimiento. ## Activación en escritorio y móvil En **escritorio**, la pop-up se activa por detección de intención de salida: cuando el cursor sube rápidamente hacia la barra de pestañas del navegador. En **móvil**, ese evento no existe. El módulo cambia entonces automáticamente a un **temporizador configurable** y a la detección de un desplazamiento rápido hacia arriba. Unas salvaguardas evitan toda insistencia: un límite de frecuencia (la pop-up no reaparece durante X días), un retardo de elegibilidad antes del primer disparo posible y una parada definitiva tras un premio. ## Conformidad RGPD - La captura de email exige una **casilla de consentimiento explícito** con un texto que personalizas. - La suscripción a la newsletter es **opcional** y está vinculada al mismo consentimiento. - Los leads se pueden consultar y exportar, lo que facilita las solicitudes de acceso y supresión. ## Compatibilidad técnica - **PrestaShop**: 8.0 a 9.x. - **Hooks**: actionFrontControllerSetMedia (carga de recursos y configuración front) y displayFooter (renderizado de la pop-up). - **Multitienda** y **multiidioma** soportados. - **Cupones**: reglas de carrito nativas, sin tabla paralela. - Sin dependencia de Composer. ## FAQ ### ¿Puede un cliente manipular la ruleta? No. El segmento ganador se calcula en el servidor antes de la animación. El navegador solo recibe el índice del resultado y nunca conoce los pesos. ### ¿Qué tipos de premios puedo repartir? Descuento porcentual, descuento de importe fijo, envío gratis o un segmento sin premio. Cada premio crea una regla de carrito única. ### ¿Es compatible con PrestaShop 9? Sí, el módulo está diseñado para PrestaShop 8.0 hasta 9.x sin adaptación. ## Resolución de problemas - **La pop-up no aparece**: comprueba que el módulo está activado, que el retardo de elegibilidad ha transcurrido y que no has jugado ya (vacía el almacenamiento local del navegador para probar de nuevo). - **La pop-up no reaparece**: es intencionado tras un premio o durante la ventana de frecuencia. Reinicia el almacenamiento local para forzar una nueva aparición. - **El cupón no se aplica**: revisa el importe mínimo del segmento y la fecha de caducidad. - **Los campos de texto parecen vacíos en la configuración**: asegúrate de usar la última versión del módulo (la visualización multiidioma de los campos se corrigió en 1.0.0).