Sobre o projeto

O pacote @vskstudio/takt-angular oferece uma integração nativa do Angular com a plataforma de análise Takt, focando na coleta de dados com prioridade à privacidade. Ele foi projetado para Angular 17 e superior, podendo ser adicionado a um projeto com um único comando do gerenciador de pacotes. Instalação Execute: pnpm add @vskstudio/takt-angular @vskstudio/takt-core Integração com Bootstrap Na chamada de bootstrap raiz, registre o provedor usando provideTakt. O provedor inicializa a biblioteca principal de análise apenas no navegador, envia uma visualização inicial da página, ativa recursos opcionais de captura automática (cliques em links externos, downloads de arquivos, navegação SPA, etc.) e faz a limpeza quando o aplicativo Angular é destruído. Do lado do servidor, o provedor permanece inativo, tornando a biblioteca segura para renderização do lado do servidor. Serviço Injetável TaktService pode ser injetado em qualquer lugar da aplicação. Ele expõe métodos como track(eventName, options), pageview(), optOut() e optIn(). Todos os métodos são operações sem efeito antes da inicialização da biblioteca ou quando executados no servidor, garantindo que nunca lancem exceções. Rastreamento Declarativo de Cliques A diretiva TaktEventDirective permite que desenvolvedores anexem rastreamento a qualquer elemento clicável por meio do atributo taktEvent, com entradas opcionais taktProps e taktRevenue. A diretiva resolve a instância de análise ao vivo no momento do clique, mantendo o markup limpo. Widgets de Interface Dois componentes autônomos são fornecidos: - TaktBadgeComponent renderiza um SVG gerado pelo servidor para um domínio específico. - TaktEmbedComponent renderiza um iframe isolado que exibe painéis de análise públicos. Ambos os componentes podem ser usados em qualquer modelo Angular e suportam entradas para domínio, tema, tamanho, idioma e variante visual. API Pública de Estatísticas O auxiliar createStats cria um cliente para a API pública do Takt. Ele oferece métodos assíncronos summary, timeseries, realtime e breakdown, permitindo que desenvolvedores recuperem dados agregados de análise programaticamente. Elemento Personalizado Framework-Agnóstico Para páginas não Angular, um elemento personalizado autônomo chamado takt-analytics é exportado. Após chamar defineTaktElement (ou importar o módulo que executa automaticamente o registro), o elemento pode ser colocado em HTML simples e respeitará automaticamente configurações de privacidade, como rastreamento de links externos e downloads de arquivos. Um pacote CDN também está disponível para inclusão rápida sem etapa de compilação. Opções de Configuração TaktConfig suporta um conjunto rico de opções, incluindo domínio, endpoint, rastreamento de links externos, rastreamento de downloads de arquivos, navegação SPA, respeito ao Do Not Track, exclusão de localhost, taxa de amostragem, tratamento de query strings, exclusões de caminho, limpeza de URLs e rastreamento de elementos marcados. Os padrões são sensíveis para a maioria dos sites, e a configuração pode ser fornecida para provideTakt durante o bootstrap. Licença A biblioteca é lançada sob a licença MIT.