genlytics

Genlytics é um pacote Composer para Laravel que integra o Google Analytics 4 (GA4) a aplicações PHP. Ele fornece uma abstração baseada no padrão de repositório sobre a API GA4 Data, além de cache automático, jobs em fila e auxiliares para relatórios em tempo real. O pacote suporta Laravel 9.x até 12.x e requer PHP 8.1+. É necessário ter uma propriedade GA4 e uma conta de serviço do Google Cloud com acesso à API Analytics Data. A instalação é feita com `composer require zfhassaan/genlytics`. O pacote registra automaticamente seu provedor de serviços e facade; desenvolvedores podem publicar configurações e stubs de teste via comandos Artisan. Variáveis de ambiente controlam o tempo de vida do cache, comportamento da fila em segundo plano e intervalos de atualização em tempo real. O uso principal envolve construir períodos de data, arrays de dimensões e métricas, e passá-los aos métodos `runReports()`, `runRealTime()` ou `runDimensionReport()` expostos pela classe `Genlytics` ou sua facade. O README destaca escolhas arquitetônicas como inversão de dependência, segregação de interfaces e listeners de evento para ciclos de busca de dados. Respostas em cache reduzem chamadas repetidas à API, enquanto jobs em segundo plano adiam consultas pesadas fora da thread de requisição. Um pequeno conjunto de testes acompanha a biblioteca, e controladores de exemplo demonstram widgets de dashboard, contagem de visitantes ao vivo e análise por país. As páginas de documentação cobrem etapas de instalação, opções de configuração, migração de versões anteriores e solução de problemas.