Fundamentos técnicos
Arquitectura, bases de datos, dominios personalizados, eventos personalizados, objetivos, embudos y acceso API.
Arquitectura
Separado por diseño
Eurolytics separa la ingesta de eventos del panel. El servicio de ingesta es un binario Go sin estado que acepta eventos, clasifica el tráfico y escribe en ClickHouse. El panel es una aplicación Next.js 14 que lee de ClickHouse y gestiona cuentas a través de PostgreSQL. Los dos no comparten dependencias en tiempo de ejecución.
INTERNET
┌──────────────┴──────────────┐
▼ ▼
events.eurolytics.app eurolytics.app
Go + SQLite WAL Next.js + Postgres
└──────────┬──────────────────┘
▼
ClickHouse
Capa de datos
ClickHouse para velocidad, Postgres para estructura
ClickHouse
Base de datos OLAP columnar optimizada para analíticas de series temporales
- Todos los datos de páginas vistas y eventos
- Agregaciones y consultas de tendencias
- Particionado por site_id para consultas rápidas
PostgreSQL
Base de datos relacional para metadatos estructurados
- Cuentas de usuario y autenticación
- Configuraciones de sitios y miembros del equipo
- Objetivos, embudos y definiciones de conversión
- Definiciones de patrones de bots para sincronización del clasificador
Seguimiento
Eventos personalizados, objetivos y embudos
Más allá de las páginas vistas, Eurolytics rastrea eventos personalizados que usted defina: registros, compras, clics en botones o cualquier otra cosa. Cree Objetivos en la configuración de su sitio para rastrear tasas de conversión, y construya Embudos (de 2 a 8 pasos) para ver dónde abandonan los visitantes en flujos multipágina.
eurolytics('signup_complete', {
plan: 'pro',
source: 'landing_page'
})
Dominios
Dominios de seguimiento personalizados mediante CNAME
Apunte un subdominio como analytics.yoursite.com a nuestro endpoint de ingesta mediante CNAME. Las solicitudes se sirven desde su propio dominio, lo que le proporciona una medición más completa y precisa.
Configúrelo en Ajustes → Dominio de seguimiento. La verificación DNS está integrada: añada el registro CNAME y Eurolytics lo confirma automáticamente.
API
Acceso programático
Eurolytics proporciona acceso API para consultar datos analíticos, gestionar sitios y crear objetivos de forma programática. Puede exportar datos en formato JSON desde el panel en cualquier momento.
Preguntas frecuentes
¿Cuánto pesa el script de seguimiento?
Solo 1.2KB comprimido con gzip. Eso es diminuto para los estándares actuales, más pequeño que una imagen en miniatura. El script se carga de forma asíncrona y no tiene ningún impacto en la velocidad de su página ni en los Core Web Vitals. Perfecto para sitios de alto rendimiento.
¿Ofrecen una API?
Sí. La Stats API le permite consultar estadísticas agregadas, series temporales y desgloses con una clave API Bearer, y la API v1 puede crear sitios y obtener fragmentos de seguimiento de forma programática. También hay un endpoint MCP, para que los asistentes de IA puedan añadir sitios, recuperar el código de seguimiento y consultar estadísticas directamente. Cree claves API en Configuración.
¿Admiten dominios personalizados (CNAME)?
Sí, admitimos dominios de seguimiento personalizados mediante CNAME. Apunte un subdominio (p. ej., analytics.sudominio.com) a events.eurolytics.app, verifique el DNS en Configuración → Dominio de seguimiento, y sus fragmentos usarán automáticamente el dominio first-party para una medición más precisa.
¿Puedo rastrear eventos personalizados?
Sí. Puede definir eventos personalizados (registros, compras, etc.) en el panel, y nuestro tracker JavaScript los envía automáticamente. Cree Objetivos en Ajustes → Objetivos, y Eurolytics comenzará a rastrear y mostrar conversiones.
¿Qué bases de datos utilizan?
ClickHouse para analíticas (consultas OLAP rápidas, optimizado para series temporales) y PostgreSQL para metadatos (cuentas de usuario, configuraciones de sitios, membresía de equipos). Los mantuvimos separados deliberadamente para que la ingesta pueda funcionar de forma independiente.
