rybbit-sdk-for-laravel

Rybbit Sdk For Laravel は、オープンソースのプライバシー対応アナリティクスプラットフォーム「Rybbit」をLaravelアプリケーションに統合するためのComposerパッケージです。クライアントサイドとサーバーサイドの両方のトラッキングに対応したLaravelネイティブAPIを提供します。 主な機能： - **Bladeディレクティブ**: `@rybbit`タグでビューにRybbitトラッキングスクリプトを注入。`data-debounce`、`data-tag`、`data-skip-patterns`、`data-mask-patterns`などの属性に対応。 - **サーバーサイドイベントトラッキング**: `Rybbit`ファサードがページビュー、カスタムイベント、パフォーマンスメトリクス、アウトバウンドクリック、エラーをバックエンドからRybbitの `/api/track` エンドポイントへ直接送信。 - **ユーザークエリ**: RybbitのRead API経由でサイトのユーザー閲覧、個別ユーザープロフィールとデバイスの検索、日次セッション数の取得、追跡済みユーザーデータの削除が可能。 - **概要統計**: 主要KPI、ビュケット化された時系列（日/時/週）、ライブ訪問者数、ページ・国・ブラウザなどのディメンション別内訳を取得。 - **トンネルプロキシ**: デフォルトでパッケージはトラッキングリクエスト（スクリプト、トラック、identify、セッションリプレイ、サイト設定）をアプリケーション自身のドメイン経由でプロキシするローカルルートを登録し、広告ブロッカーやブラウザのプライバシーブロックを回避。クライアントIPは `X-Forwarded-For` から解決され転送されます。失敗したリクエストは再試行され、セッションリプレイデータはキュージョブを使用します。 - **テスト対応**: `Rybbit::fake()` でファサードをインメモリスパイに置換し、すべてのコールを記録してトラッキングおよびクエリメソッド用のアサーションヘルパーを提供。 - **Laravel Boostスキル**: Laravel BoostのAIコーディングエージェント用Agent Skillを同梱。 設定は環境変数（`RYBBIT_SITE_ID`、`RYBBIT_HOST`、`RYBBIT_API_KEY` など）と公開済みの `config/rybbit.php` ファイルによって驱动されます。Rybbit Cloudとセルフホストの両方のRybbitインスタンスに対応しています。機能カバー範囲にはスクリプトの埋め込み、トンネリング、サーバーサイドイベント、ユーザー/Readクエリが含まれますが、ゴール、ファンネル、セッション、管理エンドポイントは対象外です。