El globo 3D muestra tus visitantes en tiempo real. Entiende cómo funcionan las actualizaciones en vivo y cómo el globo maneja los diferentes niveles de tráfico.
Cómo funciona el tiempo real
Suscripción en tiempo real de Supabase
El globo usa las suscripciones en tiempo real de Supabase para recibir actualizaciones instantáneas de visitantes:
- Se suscribe a la tabla
visitorsfiltrada por el ID de tu sitio web - Escucha los eventos
INSERT(nuevas cargas de página de visitantes) - Las actualizaciones se envían instantáneamente sin recargar la página
- La conexión se gestiona automáticamente
Flujo de actualizaciones
Cuando alguien visita tu sitio:
- El script de seguimiento se activa — Los datos del visitante se envían a la API de Zenovay
- Datos almacenados — El registro del visitante se inserta en la base de datos
- Transmisión en tiempo real — Supabase envía el nuevo registro al globo
- Aparece el marcador — Un marcador de avatar DiceBear aparece en la ubicación del visitante
Este proceso normalmente tarda entre 1 y 2 segundos desde la carga de la página hasta la aparición del marcador.
Polling de respaldo
Además de las suscripciones en tiempo real, el globo realiza sondeos cada pocos segundos como red de seguridad:
- Consulta el endpoint
/api/globe/visitorsaproximadamente cada 5 segundos - Solo se ejecuta cuando la pestaña del navegador es visible (comprueba
document.hidden) - Captura cualquier actualización que pudiera haberse perdido por la suscripción en tiempo real, incluyendo visitantes que salen de la ventana de transmisión en vivo
- Asegura que los datos se mantengan actualizados incluso si la suscripción se desconecta temporalmente
Ciclo de vida de los datos del visitante
Ventana deslizante de 2 minutos
El globo muestra los visitantes de los últimos 2 minutos:
| Evento | Tiempo |
|---|---|
| El visitante carga una página | El marcador aparece inmediatamente |
| Pasan 2 minutos | El marcador se elimina |
| Misma sesión, nueva página | El marcador antiguo se reemplaza por uno nuevo |
Límite de marcadores
Se muestran hasta 50 marcadores de visitantes simultáneamente:
- Se priorizan los visitantes más recientes
- Cuando llega un nuevo visitante y se alcanza el límite, se elimina el marcador más antiguo
- El overlay de estadísticas siempre muestra el recuento exacto independientemente del límite de marcadores
Deduplicación
Si un visitante con una sesión existente carga otra página:
- El marcador anterior de esa sesión se reemplaza
- Solo se muestra la vista de página más reciente de cada sesión
- Esto evita marcadores duplicados para el mismo visitante
Manejo de desconexiones
Por qué ocurren las desconexiones
Causas comunes:
- Interrupción de la red
- Pestaña del navegador en segundo plano durante períodos prolongados
- Problemas de VPN o firewall
- Modo de suspensión del navegador
Qué ocurre cuando hay desconexión
Durante la desconexión:
- El globo muestra los últimos datos de visitantes conocidos
- Los marcadores de la ventana de 2 minutos pueden expirar y desaparecer
- El polling de respaldo se detendrá si la pestaña está oculta
Reconexión
Cuando se restaura la conexión o la pestaña está en primer plano:
- La suscripción en tiempo real de Supabase se reconecta automáticamente
- El polling de respaldo se reanuda y obtiene datos actualizados
- Los marcadores se actualizan para reflejar el estado actual
Actualización manual
Si los datos parecen desactualizados:
- Haz clic en el botón Recargar en la barra de control del globo
- Esto activa una obtención inmediata de datos
- Los datos actualizados del visitante reemplazan los marcadores actuales
Comportamiento de las pestañas
Pestaña activa
Cuando la pestaña del globo está en primer plano:
- La suscripción en tiempo real entrega actualizaciones al instante
- El polling de respaldo cada pocos segundos se ejecuta como red de seguridad
- Renderizado y animaciones completos activos
Pestaña en segundo plano
Cuando la pestaña del globo no es la pestaña activa:
- El navegador puede limitar la conexión
- El polling de respaldo se pausa (detecta
document.hidden) - El renderizado se pausa para conservar recursos
Volver a la pestaña
Cuando vuelves a la pestaña del globo:
- El polling de respaldo se reanuda inmediatamente
- Se activa una obtención de datos actualizada
- Los marcadores se actualizan para reflejar los visitantes actuales
- La suscripción en tiempo real se pone al día con los eventos en cola
Manejo de alto tráfico
Límite de marcadores
El globo limita los marcadores visibles a 50, independientemente del volumen de tráfico:
- Esto garantiza un rendimiento constante incluso durante picos de tráfico
- Los nuevos visitantes siempre se muestran (primero se eliminan los marcadores más antiguos)
- El overlay de estadísticas muestra los recuentos agregados precisos
Expiración de visitantes
Los visitantes de más de 2 minutos expiran automáticamente:
- Esto mantiene el globo enfocado en la actividad actual
- Evita la acumulación de marcadores durante el tráfico alto sostenido
- Los visitantes expirados se filtran durante las actualizaciones en tiempo real y de polling
Consejos de rendimiento
Para la fiabilidad en tiempo real
| Consejo | Razón |
|---|---|
| Mantén la pestaña en primer plano | Evita la limitación del navegador |
| Usa una conexión a internet estable | Reduce las desconexiones |
| Cierra las pestañas innecesarias | Libera recursos del navegador |
| Activa la aceleración de hardware | Mejora el rendimiento de renderizado |
Para pantallas de oficina
Si usas el globo como pantalla en vivo:
- Mantén la pestaña del navegador activa y en primer plano
- Usa el modo de pantalla completa para mayor impacto visual
- Activa el reproductor de música para audio ambiental
- El polling de respaldo asegura que los datos se mantengan actualizados incluso si la suscripción en tiempo real se interrumpe brevemente
Para presentaciones
- Prueba la conexión del globo antes de presentar
- Ten una conexión de red estable
- Usa el modo de pantalla completa
- Haz clic en Recargar si los marcadores no aparecen como se espera
Solución de problemas
Sin actualizaciones en tiempo real
Si el globo no se actualiza:
- Haz clic en el botón Recargar para activar una actualización manual
- Comprueba tu conexión a internet
- Verifica que el script de seguimiento esté instalado y funcionando en tu sitio web
- Abre la consola del desarrollador del navegador (F12) y busca errores
- Intenta actualizar la página
Actualizaciones retrasadas
Si las actualizaciones parecen lentas:
- Comprueba la latencia de tu red
- Desactiva la VPN si está activa (puede añadir latencia)
- Cierra aplicaciones que consuman mucho ancho de banda
- Asegúrate de que la pestaña esté en primer plano
Marcadores que no aparecen
Si los visitantes no se muestran:
- Verifica que el script de seguimiento esté instalado en tu sitio web
- Confirma que existen visitantes en tu dashboard de análisis
- Asegúrate de que el sitio web correcto esté seleccionado
- Comprueba que tienes tráfico activo (los marcadores expiran después de 2 minutos)