Analítica

Empieza por la visión general de autoalojamiento si prefieres ver antes la arquitectura completa. Esta página se centra en las decisiones de analítica que tienes que tomar para un despliegue autoalojado.

Para qué usa Fluxo la analítica

Hoy, Fluxo usa Tinybird para:

• la analítica de la bandeja de entrada
• la presencia de visitantes en vivo
• el enriquecido en vivo de «última vez visto en la app» en las pantallas del panel que dependen de Tinybird

Aparte, la documentación y el sitio de marketing incluyen un script de DataFast para la analítica web alojada.

Son dos cosas independientes:

• Tinybird alimenta la analítica de producto y las funciones de presencia en vivo dentro de la aplicación
• DataFast es un script de analítica de sitio de terceros que puede desactivarse por separado

Interruptores de ejecución

En el autoalojamiento, todos los interruptores relacionados con la analítica valen true por defecto:

CopiarTINYBIRD_ENABLED=true
NEXT_PUBLIC_TINYBIRD_ENABLED=true
NEXT_PUBLIC_DATAFAST_ENABLED=true

El análisis del valor es estricto:

• "true" activa la funcionalidad
• cualquier otro valor la desactiva

Camino con Tinybird activado

Si quieres la analítica de la bandeja y los paneles de visitantes en vivo, deja Tinybird activado y apunta la aplicación a tu instancia de Tinybird:

CopiarTINYBIRD_ENABLED=true
NEXT_PUBLIC_TINYBIRD_ENABLED=true
TINYBIRD_HOST=https://your-tinybird.example.com
TINYBIRD_TOKEN=...
TINYBIRD_SIGNING_KEY=...
TINYBIRD_WORKSPACE=...

Si quieres autoalojar o autogestionar el propio Tinybird, empieza por sus guías oficiales:

• Infraestructura de Tinybird y visión general del autoalojamiento
• Guía de instalación autogestionada de Tinybird

No basta con instalar Tinybird. Despliega los archivos del proyecto Fluxo que hay en tinybird/datasources, tinybird/pipes y tinybird/endpoints; son esos nombres los que consultan la API y el panel. Desde el directorio tinybird/ del repositorio, valida el contexto de la CLI con tb info y despliega el proyecto con tb --cloud deploy (o su equivalente autogestionado). El flujo de trabajo local y la lista de endpoints esperados están documentados en tinybird/README.md.

Comprueba que inbox_analytics, unique_visitors, online_now, visitor_presence y presence_locations resuelven antes de activar la interfaz.

Camino con Tinybird desactivado

Si mantener Tinybird es complicado en tu entorno, puedes desactivarlo de forma limpia:

CopiarTINYBIRD_ENABLED=false
NEXT_PUBLIC_TINYBIRD_ENABLED=false

Con Tinybird desactivado:

• la ingesta hacia Tinybird se detiene en el lado de la API
• deja de generarse el JWT o token de Tinybird
• se oculta la interfaz de analítica de la bandeja
• se ocultan la capa de visitantes en vivo, los contadores de presencia en vivo y los mapas en vivo que dependen de Tinybird

Lo que sigue funcionando:

• las marcas de tiempo lastSeenAt de visitantes y usuarios guardadas en Postgres se siguen actualizando
• los sitios de la aplicación que ya recurren al lastSeenAt de la base de datos siguen mostrando esas marcas de tiempo
• el resto del producto sigue funcionando sin Tinybird

Mantén TINYBIRD_ENABLED y NEXT_PUBLIC_TINYBIRD_ENABLED alineados. Si solo desactivas la bandera del servidor, el navegador puede pintar pantallas de analítica que no pueden recibir ni tokens ni datos. Si solo desactivas la del navegador, la API puede seguir ingiriendo eventos que ninguna pantalla del panel muestra.

Lo que esto no hace:

• no recrea la analítica de Tinybird sobre Postgres
• no mantiene visibles con datos sustitutos los paneles que solo existen gracias a Tinybird

DataFast

DataFast se trata como una dependencia opcional de analítica de terceros para la analítica del sitio alojado. La bandera viene activada, así que quien autoaloja y no elija explícitamente este proveedor debería desactivarla antes de la primera carga de página.

Para desactivarlo al autoalojar:

CopiarNEXT_PUBLIC_DATAFAST_ENABLED=false

Cuando está desactivado, la maquetación raíz de la web simplemente omite el script de datafa.st.

Valores por defecto recomendados al autoalojar

Si quieres primero el camino de autoalojamiento más sencillo:

1. Decide si de verdad necesitas la interfaz de analítica basada en Tinybird desde el primer día.
2. Si no, define TINYBIRD_ENABLED=false y NEXT_PUBLIC_TINYBIRD_ENABLED=false.
3. Desactiva NEXT_PUBLIC_DATAFAST_ENABLED salvo que quieras expresamente ese script de terceros.
4. Recupera Tinybird más adelante solo si quieres la analítica de la bandeja y los paneles de visitantes en vivo.

Con cualquiera de las dos configuraciones, prueba el endpoint de tokens de la API y el panel con las herramientas de desarrollo del navegador abiertas: en modo activado debe devolver datos utilizables de cada pipe nombrado; en modo desactivado no debe aparecer ninguna petición a Tinybird o DataFast ni interfaz de analítica.