genlytics

Genlyticsは、Google Analytics 4（GA4）をPHPアプリケーションに統合するためのComposerパッケージです。GA4 Data APIに対してリポジトリパターンによる抽象化を提供し、自動キャッシュ、キューイングされたバックグラウンドジョブ、リアルタイムレポートヘルパーを備えています。Laravel 9.x～12.xおよびPHP 8.1+に対応しており、GA4プロパティとAnalytics Data APIアクセス権限を持つGoogle Cloudサービスアカウントが必要です。 インストールは`composer require zfhassaan/genlytics`で行います。パッケージはサービスプロバイダとファサードを自動登録し、Artisanコマンドで設定ファイルやテストスタブを公開できます。環境変数によりキャッシュ有効期間、バックグラウンドキュー動作、リアルタイム更新間隔を制御します。基本的な使用法では、日付範囲、ディメンション配列、メトリック配列を作成し、`Genlytics`クラスまたはファサードが提供する`runReports()`、`runRealTime()`、`runDimensionReport()`メソッドに渡します。 READMEでは、依存性逆転、インターフェース分離、データ取得サイクル用のイベントリスナーといったアーキテクチャ上の選択肢が紹介されています。キャッシュ済みレスポンスによりAPI呼び出しを減らし、バックグラウンドジョブで重いクエリをリクエストスレッドから切り離します。小さなテストスイートと、ダッシュボードウィジェット、リアルタイム訪問者数、国別トップランキングを示す例のコントローラーが同梱されています。ドキュメントにはインストール手順、設定オプション、以前のバージョンからの移行、トラブルシューティングが記載されています。