Popup de ventas: configuración y ayuda

Sigue los pasos de Inicio rápido.

Haz clic en Configure en el Gestor de módulos para abrir Settings. Guarda después de modificar una pestaña. Los valores predeterminados siguientes corresponden a una instalación nueva.

General

Visualización y tiempos

Para mostrarlas con menos frecuencia, usa Initial Delay 12, Minimum Interval 20, Maximum Interval 45, Display Duration 6 y Max Notifications Per Session 8.

Contenido

Puedes usar [firstname], [city], [product] y [price] en Message Template. Por ejemplo:

[firstname] from [city] bought [product]
Someone in [city] just ordered [product]
[firstname] purchased [product] for [price]

El marcador [price] funciona independientemente de la línea separada Show Price. Los nombres reales se reducen a su primera letra seguida de ..., como M.... La etiqueta Verified Purchase solo aparece en las entradas de pedidos reales.

Estilo

Background Color, Text Color y Accent Color están vacíos de forma predeterminada. Déjalos vacíos para usar el estilo del tema. Accent Color controla la insignia, la barra de progreso y los enlaces. Para establecer colores concretos, introduce #ffffff, #333333 y #fc6139, respectivamente.

Reglas y filtros

Estos campos filtran las notificaciones de compra por ID de producto. El creador de campañas tiene condiciones independientes.

Abre Campaign content con una sola tienda seleccionada. Necesitas el permiso de visualización del empleado para abrirlo y los permisos de añadir, editar o eliminar para la acción correspondiente.

1. Haz clic en Add content. Introduce Internal name, traduce Title y añade Content blocks.
2. Elige HTML, imagen, vídeo alojado o contenido de un proveedor compatible entre las opciones del editor de bloques. El HTML se sanea. Se eliminan los scripts, estilos, formularios y documentos incrustados.
3. En los textos que redactes, usa solo [shop_name], [language] y [currency]. Los marcadores de clientes y pedidos no están disponibles aquí.
4. Sube imágenes JPG, PNG o WebP de hasta 10 MiB, o vídeos MP4/WebM de hasta 100 MiB. Las imágenes están limitadas a 8000 píxeles por lado y 40 megapíxeles. También se aplican los límites de subida del servidor. Los formatos de URL de proveedores compatibles son https://www.youtube-nocookie.com/embed/VIDEO_ID y https://player.vimeo.com/video/VIDEO_ID.
5. Usa Preview, establece Enabled en Sí y guarda. El contenido nuevo está desactivado inicialmente. Las traducciones vacías utilizan el idioma predeterminado de la tienda.
6. Abre Popup campaigns. Usa el creador de campañas para seleccionar la acción Show merchant campaign content e introduce el Content ID guardado. Configura Display duration in milliseconds (0 keeps it open). Su valor predeterminado es 10000.
7. Configura las condiciones de la campaña y previsualiza el resultado antes de activarla. El módulo expone como señales el ID del producto actual, el ID de la categoría actual y el número de compras en cola.

La acción independiente Show next purchase notification utiliza la cola de compras. Una regla integrada puede mostrar una compra en cola cuando un visitante regresa tras al menos 15 segundos de ausencia, con una espera de 60 segundos entre activaciones. La visualización de una campaña del comerciante pausa la programación de las notificaciones de compra mientras está activa.

Los datos de compra se cargan desde /module/mprsalespopup/notifications después de que se inicie el script. La respuesta JSON contiene un array notifications y envía X-Robots-Tag: noindex, nofollow, noarchive junto con cabeceras de caché no-store. Los campos opcionales se omiten cuando sus opciones de visualización están desactivadas. Una entrada real puede contener:

{"notifications":[{"message":"M... from Berlin bought Running Shoes","verified":true,"image":"https://example.com/product.jpg","price":"$49.90","time_ago":"2 hours ago","url":"https://example.com/product.html"}]}

Las entradas reales requieren pedidos recientes válidos en la tienda actual, un precio positivo en la línea del pedido y un producto apto. El flujo de datos también comprueba la visibilidad del producto y los permisos de acceso del visitante. Las entradas generadas utilizan productos activos aptos del catálogo, listas integradas de nombres y ciudades, y valores de tiempo generados. Los resultados mixtos se mezclan aleatoriamente antes de enviarse.

Haz la prueba en una ventana de navegación privada. Espera el retraso inicial y comprueba la imagen, el mensaje, el precio y el enlace. Comprueba la visualización con una anchura de pantalla de móvil. Después, cierra una notificación y recarga la página: las notificaciones de compra deberían permanecer ocultas para ese ámbito de almacenamiento.

• Si no aparece ninguna ventana emergente en el modo Real orders only, comprueba los pedidos recientes válidos, que los productos sean aptos, el periodo de antigüedad de los pedidos y ambas listas de filtros de productos.
• Si ya cerraste una ventana emergente, usa una nueva sesión privada o elimina la clave mprlivesales_dismissed_ correspondiente en localStorage. La clave real tiene un sufijo que indica el ámbito del contenido. Los recuentos de sesión usan mprlivesales_count_ seguido del ámbito en sessionStorage.
• Comprueba Enable Notifications, la visibilidad en móviles y el límite por sesión. Revisa la solicitud de notificaciones en el panel de red del navegador.
• Comprueba la ubicación de los hooks del módulo si falta el contenedor. El módulo utiliza la integración de recursos/cabecera del front office y displayBeforeBodyClosingTag o displayFooter para el contenedor. El tema debe renderizar esa ubicación.
• Abre Integrity para comprobar los intervalos, la duración, el modo, los datos de pedidos y los filtros de productos. Usa intervalos positivos y mantén Maximum Interval como mínimo igual a Minimum Interval.
• Si no se puede guardar el contenido de una campaña, selecciona una sola tienda, comprueba los permisos del empleado y recarga el editor antes de volver a intentar guardar una revisión desactualizada.

Coloca el CSS en la hoja de estilos personalizada de tu tema. Las clases disponibles incluyen mprlivesales-container, mprlivesales-bottom-left, mprlivesales-bottom-right, mprlivesales-top-left, mprlivesales-top-right, mprlivesales-toast, mprlivesales-image, mprlivesales-content, mprlivesales-label, mprlivesales-message, mprlivesales-meta, mprlivesales-price, mprlivesales-time, mprlivesales-close y mprlivesales-progress.

.mprlivesales-toast { max-width: 340px; }
.mprlivesales-label { text-transform: none; }
.mprlivesales-message { font-size: 14px; }
.mprlivesales-progress { height: 2px; }

Desactiva Enable Notifications para detener la visualización y conservar la configuración. Para eliminar el módulo, usa Módulos > Gestor de módulos > Desinstalar. La desinstalación elimina la configuración del módulo, su menú de administración y el esquema de base de datos declarado. Exporta el contenido de las campañas o haz una copia de seguridad antes de desinstalar. El estado de cierre de notificaciones guardado en el navegador es independiente de la configuración del servidor.