Об этом проекте

Genlytics — это Composer-пакет для Laravel, интегрирующий Google Analytics 4 (GA4) в PHP-приложения. Он предоставляет абстракцию по шаблону репозитория над GA4 Data API, а также автоматическое кэширование, фоновые задачи в очереди и вспомогательные функции для отчётов в реальном времени. Пакет поддерживает Laravel 9.x–12.x и требует PHP 8.1+. Для работы необходима GA4-свойство и сервисный аккаунт Google Cloud с доступом к Analytics Data API. Установка выполняется командой `composer require zfhassaan/genlytics`. Пакет автоматически регистрирует провайдер и фасад; разработчики могут опубликовать конфигурацию и заготовки тестов через Artisan-команды. Переменные окружения управляют временем жизни кэша, поведением фоновой очереди и интервалами обновления в реальном времени. Основное использование сводится к формированию периодов дат, массивов измерений и метрик, которые передаются методам `runReports()`, `runRealTime()` или `runDimensionReport()` через класс `Genlytics` или фасад. В README подчеркиваются архитектурные решения: инверсия зависимостей, разделение интерфейсов и слушатели событий для циклов получения данных. Кэшированные ответы снижают количество повторных вызовов API, а фоновые задачи выносят тяжелые запросы за пределы основного потока запроса. В комплекте идёт небольшой набор тестов, а примеры контроллеров демонстрируют виджеты дашборда, подсчёт активных посетителей и разбивку по странам. Документация охватывает установку, настройку, миграцию с предыдущих версий и устранение неполадок.