Sobre el proyecto

Este repositorio es una plantilla para construir una plataforma de análisis web basada en la Events API y los Endpoints de Tinybird. Prioriza la privacidad y la velocidad, y el README indica que los usuarios pueden recibir métricas en tiempo real en un tablero preconstruido en cuestión de minutos sin conocimientos previos de Tinybird. Tras la configuración, los usuarios pueden añadir eventos personalizados para casos de uso como eCommerce o marketing manteniendo el rendimiento en tiempo real. Configuración: clonar el repositorio, entrar en el directorio tinybird, instalar las dependencias con pnpm, iniciar sesión en Tinybird y desplegar. El seguimiento se activa colocando un fragmento de script proporcionado en la sección head de un sitio con un token de rastreador. El README espera eventos page_hit a medida que los visitantes ven e interactúan con el sitio. Los eventos personalizados pueden enviarse a través de Tinybird.trackEvent. Los atributos personalizados utilizan un prefijo data-tb_ y se almacenan en la columna payload del datasource analytics_events, incluyéndose en cada evento. El soporte multi-inquilino y multi-dominio utiliza los parámetros data-domain y data-tenant-id. Todos los endpoints del proyecto pueden filtrarse por tenant_id y domain, o los tokens JWT pueden llevar fixed_params. El rastreador también soporta web vitals a través de la librería web-vitals. Los eventos con una acción web_vital incluyen métricas como LCP, TTFB, FCP, INP y CLS. Un tablero ya preparado está disponible en analytics.tinybird.live, donde los usuarios pegan un token de administrador del espacio de trabajo. También se obtiene un token de tablero desde Tinybird. Las secciones avanzadas remiten a READMEs separados de tinybird y dashboard para el desarrollo local; pnpm dev sincroniza los cambios con una rama de Tinybird, y pnpm deploy se utiliza para producción. Se crea un archivo .env.local con los valores TINYBIRD_TOKEN y TINYBIRD_HOST. Los usuarios pueden personalizar y alojar su propio tablero en Vercel. El README señala que Tinybird cumple con el GDPR como plataforma, mientras que los usuarios siguen siendo responsables de cumplir las normas del GDPR sobre la recopilación de datos y el consentimiento.