genlytics

Genlytics est un package Composer pour Laravel qui intègre Google Analytics 4 (GA4) dans les applications PHP. Il fournit une abstraction de modèle de référentiel sur l'API GA4 Data, avec une mise en cache automatique, des tâches en arrière-plan mises en file d'attente et des assistants de rapports en temps réel. Le package cible Laravel 9.x à 12.x et nécessite PHP 8.1+. Une propriété GA4 et un compte de service Google Cloud avec accès à l'API Analytics Data sont des prérequis. L'installation se fait avec `composer require zfhassaan/genlytics`. Le package enregistre automatiquement son fournisseur de services et sa façade ; les développeurs peuvent publier la configuration et les stubs de test via des commandes Artisan. Les variables d'environnement contrôlent la durée de vie du cache, le comportement de la file d'attente en arrière-plan et les intervalles de mise à jour en temps réel. L'utilisation principale consiste à construire des périodes de dates, des tableaux de dimensions et des tableaux de métriques, puis à les passer aux méthodes `runReports()`, `runRealTime()` ou `runDimensionReport()` exposées via la classe `Genlytics` ou la façade. Le README met en évidence des choix architecturaux tels que l'inversion de dépendance, la ségrégation d'interface et les écouteurs d'événements pour les cycles de récupération des données. Les réponses mises en cache réduisent les appels API répétés, tandis que les tâches en arrière-plan diffèrent les requêtes lourdes du fil de requête. Une petite suite de tests accompagne la bibliothèque, et des contrôleurs d'exemple illustrent les widgets de tableau de bord, le nombre de visiteurs en direct et les répartitions par pays. Les pages de documentation couvrent les étapes d'installation, les options de configuration, la migration depuis les versions antérieures et le dépannage.