Widgets de Intención de Salida

Pro Feature

Los Widgets de Intención de Salida son popups definidos por el cliente que se disparan cuando un visitante señala que está a punto de abandonar la página, con análisis integrado en cada impresión, clic y cierre.

---

Descripción General

Un widget es una pequeña superposición configurable que renderiza el script de tracking de Zenovay cuando se detecta una señal de intención de salida. Usted diseña el contenido, define la segmentación, y Zenovay se encarga de la entrega, el límite de frecuencia y la analítica.

Cuándo se disparan los widgets

El tracker utiliza dos señales de salida específicas por dispositivo:

Ambas señales tienen anti-rebote y respetan el límite de frecuencia configurado por widget, de modo que el mismo visitante no vea el mismo widget dos veces en una sesión.

---

Configuración

Los widgets se gestionan completamente desde el panel de Zenovay — no se requieren cambios de código más allá de tener el script de tracking instalado.

1. Abra Domains, luego haga clic en el sitio al que desea añadir un widget.
2. Seleccione la pestaña Widgets (bajo Configure).
3. Haga clic en New widget.
4. Recorra el constructor de cuatro pasos.

El constructor en 4 pasos

Paso 1 — Contenido

Defina lo que muestra el widget.

• Title — el encabezado (máx. 120 caracteres)
• Body — el texto de apoyo (máx. 500 caracteres, texto plano)
• Primary CTA — etiqueta del botón y URL de destino (o un nombre de goal_event si prefiere registrar la finalización de un objetivo en lugar de una redirección)

Paso 2 — Segmentación

Decida quién lo ve.

• Page pattern — en qué URLs se ejecuta el widget (consulte Semántica de segmentación)
• Country — lista de códigos ISO 3166-1 alfa-2 (p. ej. US,DE,FR); déjelo vacío para todos los países
• Device — uno o más entre desktop, mobile, tablet
• Frequency cap — número máximo de impresiones por visitante en N días (p. ej. una vez cada 7 días)
• Min visit count — disparar solo a partir de la N-ésima visita del visitante a este sitio (requiere modo no-cookieless)

Paso 3 — Diseño

Personalice el widget para que encaje con su marca.

• Position, width, border radius (consulte Enumeraciones de diseño)
• Background, text y button colors (hex)
• Image con posición seleccionable (top, left, right, o full-bleed background)
• Secondary button (opcional) — bien una acción pasiva dismiss, bien un link secundario

Paso 4 — Programación

• Status — draft, active o paused
• Start date / End date (opcional) para campañas con plazo

Pulse Save y el widget estará en producción en menos de un minuto (el tracker recargará la lista de widgets activos en la siguiente carga de página).

---

Semántica de segmentación

Patrón de página

Por defecto, el campo de patrón de página es una coincidencia por subcadena contra el pathname del visitante.

Para una coincidencia más precisa, use globs explícitos:

País

Códigos ISO 3166-1 alfa-2 separados por coma:

US,CA,GB,DE,FR

La detección de país usa la geolocalización IP del visitante en el momento de la carga de la página. Los visitantes de la UE con GPC activado no son enriquecidos, por lo que la segmentación por país recae en "todos los países" para esos visitantes.

Dispositivo

Elija uno o más de los tres grupos:

desktop
mobile
tablet

El tracker clasifica los dispositivos por User-Agent y ancho del viewport, idéntico al resto del panel.

Límite de frecuencia

Definido como max_shows_per_n_days. El tracker almacena una marca de tiempo de impresión por widget en el registro del visitante (del lado del servidor, nunca en cookies/localStorage). Mientras frequency_cap_n_days no haya transcurrido desde el último evento shown para este par widget × visitante, el widget se suprime.

Mínimo de visitas

Establecer min_visit_count > 1 exige que el tracker recuerde cuántas veces ha cargado el sitio este visitante. Como el tracker de Zenovay funciona cookieless por defecto mientras no se haya dado consentimiento, esta regla de segmentación recae silenciosamente en "disparar en la primera visita" para cualquier visitante en modo cookieless.

Si depende de esta regla, asegúrese de que el tracker se cargue con data-cookieless="false" (es decir, después del consentimiento); de lo contrario, la regla no surte efecto para la gran mayoría del tráfico de la UE.

---

Enumeraciones de diseño

Los campos de diseño son enumeraciones bloqueadas por seguridad — la API solo acepta los valores siguientes. Esto protege a todos los widgets servidos por Zenovay frente a la inyección de CSS.

Position

center
top-banner
bottom-banner
top-right
top-left
bottom-right
bottom-left

top-banner y bottom-banner son tiras de ancho completo. Las cuatro posiciones de esquina son tarjetas más pequeñas y fijas.

Anchura

sm    (320px máx.)
md    (480px máx.)
lg    (640px máx.)
xl    (800px máx.)

Los anchos son responsivos — se adaptan a viewports más pequeños y nunca exceden la pantalla del visitante.

Radio de borde

none
sm
md
lg
full

full redondea el widget hasta convertirlo en una píldora (solo tiene sentido con una posición de banner).

Posición de la imagen

top
left
right
background

background coloca la imagen como fondo a sangre completa con un velo de contraste detrás del texto.

Acción secundaria

dismiss
link

dismiss cierra el widget sin registrar un clic. link registra un evento secondary_clicked y navega a la URL configurada.

---

Analítica

Cada widget registra cuatro tipos de eventos:

Vista detallada

Abra cualquier widget desde Domains → su sitio → pestaña Widgets para ver:

• CTR — clicked / shown, con comparación frente al promedio del sitio
• Gráfico diario — barras diarias de impresiones / clics / cierres con sparklines
• Embudo de conversión — shown → clicked → goal completed (cuando el CTA apunta a un objetivo rastreado)
• Páginas principales — las URLs en las que más se disparó el widget, con CTR por página
• Desglose por dispositivo — split desktop / móvil / tablet para impresiones vs clics

Todas las métricas respetan los mismos filtros de fecha y segmento que el resto del panel.

---

Privacidad

Los eventos de analítica de los widgets utilizan el mismo pipeline de eventos cookieless que el resto de Zenovay:

• El ID de visitante es un hash SHA-256 con sal diaria calculado del lado del servidor sobre (subred IP + User-Agent + sal del día). No se escriben cookies ni localStorage en el navegador del visitante.
• La deduplicación entre pestañas (para que el mismo visitante no vea el widget dos veces en dos pestañas) es solo de mejor esfuerzo en modo cookieless — sin almacenamiento persistente, dos pestañas son indistinguibles de dos visitantes con la misma huella IP/UA.
• Los visitantes con Global Privacy Control (Sec-GPC: 1) no son enriquecidos — los campos de país y B2B se descartan del lado del servidor, pero el widget seguirá disparándose si el patrón de página, el dispositivo y el límite de frecuencia se cumplen.
• No se recopila ningún contenido del widget, ningún snapshot del DOM ni ninguna entrada del visitante. Solo los cuatro tipos de eventos listados arriba.

Si necesita una segmentación más estricta (p. ej. mostrar solo a usuarios autenticados), condicione el widget a un evento personalizado emitido desde su propio código de aplicación en lugar de depender de la persistencia entre pestañas.

---

Límites del plan

Los límites se aplican en la API en el momento de la creación y se muestran como un error en el panel si intenta superarlos. Para subir su límite, actualice su plan.

---

Acceso a la API

Gestione los widgets de forma programática:

# List widgets for a website
GET /api/popup-widgets/:websiteId
Authorization: Bearer YOUR_API_KEY

# Get a single widget
GET /api/popup-widgets/:websiteId/:widgetId

# Get analytics for a widget
GET /api/popup-widgets/:websiteId/:widgetId/stats

# Create
POST /api/popup-widgets/:websiteId

# Update
PATCH /api/popup-widgets/:websiteId/:widgetId

# Delete
DELETE /api/popup-widgets/:websiteId/:widgetId

El endpoint público utilizado por el tracker (GET /api/popup-widgets/active/:trackingCode) es invocado automáticamente por el script de tracking y no requiere autenticación.

---

Buenas prácticas

1. Transmita valor, no pánico. "Ahorre un 20 % en su primer pedido" rinde mucho mejor que "¡Espere! ¡No se vaya!".
2. Limite a una vez por visitante por semana como mínimo. Un widget en cada visita se convierte en cebo para los bloqueadores de publicidad.
3. Pruebe en móvil por separado. Las señales móviles (scroll hacia arriba + retorno de visibilidad) se disparan de forma distinta al mouseleave de escritorio. Un widget que convierte en escritorio puede ser invisible en móvil.
4. Vincule el CTA con un objetivo. Hacer que el CTA principal apunte a una URL rastreada o a un goal_event permite ver el funnel completo shown → clicked → converted en lugar de solo los clics.
5. Pause antes de iterar. No elimine un widget que está testeando en A/B — póngalo en pausa para que la analítica histórica permanezca asociada.

---

Próximos pasos

• Conversion Funnels - Realice un seguimiento de los caminos de conversión multietapa que el widget puede alimentar
• Goals - Defina los eventos que el CTA de su widget debe completar
• Conversion Incidents - Reciba alertas cuando las conversiones impulsadas por widgets bajen