Sobre o projeto

Este repositório é um template para a construção de uma plataforma de web analytics baseada na Events API e Endpoints do Tinybird. Ele enfatiza a privacidade e a velocidade, e o README afirma que os usuários podem receber métricas em tempo real em um dashboard pré-construído em poucos minutos, sem conhecimento prévio do Tinybird. Após a configuração, os usuários podem adicionar eventos personalizados para casos de uso como eCommerce ou marketing, mantendo a performance em tempo real. Configuração: clone o repositório, entre no diretório tinybird, instale as dependências com pnpm, faça login no Tinybird e faça o deploy. O rastreamento é habilitado ao colocar um snippet de script fornecido na seção head de um site com um tracker token. O README espera eventos page_hit conforme os visitantes visualizam e interagem com o site. Eventos personalizados podem ser enviados através de Tinybird.trackEvent. Atributos personalizados usam o prefixo data-tb_ e são armazenados na coluna payload do datasource analytics_events, incluídos em cada evento. O suporte a multi-tenancy e multi-domínio utiliza os parâmetros data-domain e data-tenant-id. Todos os endpoints do projeto podem ser filtrados por tenant_id e domain, ou tokens JWT podem carregar fixed_params. O tracker também suporta web vitals através da biblioteca web-vitals. Eventos com uma ação web_vital incluem métricas como LCP, TTFB, FCP, INP e CLS. Um dashboard pronto está disponível em analytics.tinybird.live, onde os usuários colam um workspace admin token. Um dashboard token também é obtido do Tinybird. Seções avançadas apontam para READMEs separados de tinybird e dashboard para desenvolvimento local; pnpm dev sincroniza alterações para um branch do Tinybird, e pnpm deploy é usado para produção. Um arquivo .env.local é criado com os valores TINYBIRD_TOKEN e TINYBIRD_HOST. Os usuários podem personalizar e hospedar seu próprio dashboard no Vercel. O README observa que o Tinybird é compatível com GDPR como plataforma, enquanto os usuários permanecem responsáveis por seguir as regras de GDPR na coleta de dados e consentimento.