rybbit-sdk-for-laravel

Rybbit Sdk For Laravel는 오픈소스 프라이버시 친화적 Rybbit 분석 플랫폼을 Laravel 애플리케이션에 통합하는 Composer 패키지입니다. 클라이언트 사이드 및 서버 사이드 추적을 위한 Laravel 네이티브 API를 제공합니다. 주요 기능: - **Blade 지시어**: `@rybbit` 태그가 추적 스크립트를 뷰에 주입하며, `data-debounce`, `data-tag`, `data-skip-patterns`, `data-mask-patterns` 등의 속성을 지원합니다. - **서버 사이드 이벤트 추적**: `Rybbit` 파사드를 통해 페이지뷰, 커스텀 이벤트, 성능 метрики, 아웃바운드 클릭, 오류를 백엔드에서 Rybbit의 `/api/track` 엔드포인트로 직접 전송합니다. - **사용자 쿼리**: Rybbit 읽기 API를 통해 사이트의 사용자 읽기, 개별 사용자 프로필 및 장치 찾기, 일간 세션 수 조회, 추적된 사용자 데이터 삭제를 수행할 수 있습니다. - **개요 통계**: 핵심 KPI, 버킷화된 시간 시리즈(일별/시간별/주별), 실시간 방문자 수, 페이지·국가·브라우저 등 차원별 분석을 가져옵니다. - **터널 프록시**: 기본값으로 패키지가 로컬 라우트를 등록하여 스크립트, track, identify, 세션 리플레이, 사이트 설정 등 추적 요청을 애플리케이션 도메인을 통해 프록시하므로 광고 차단기 및 브라우저 프라이버시 차단 회피가 가능합니다. 클라이언트 IP는 `X-Forwarded-For`에서 Resolution되어 전달되며, 실패한 요청은 재시도되고 세션 리플레이 데이터는 큐 작업을 사용합니다. - **테스트 지원**: `Rybbit::fake()`은 파사드를 메모리 내 스파이로 교체하여 모든 호출을 기록하고 모든 추적 및 쿼리 메서드에 대한 어설션 헬퍼를 제공합니다. - **Laravel Boost 기술**: Laravel Boost의 AI 코딩 에이전트를 위한 Agent Skill을 포함합니다. 구성 환경 변수(`RYBBIT_SITE_ID`, `RYBBIT_HOST`, `RYBBIT_API_KEY` 등)와 게시된 `config/rybbit.php` 파일에 의해 결정됩니다. 본 패키지는 Rybbit Cloud와 자체 호스팅 Rybbit 인스턴스를 모두 지원합니다. 기능 커버리지는 스크립트 임베딩, 터널링, 서버 사이드 이벤트, 사용자/읽기 쿼리를 포함합니다. goals, funnels, sessions, 관리 endpoints는 커버되지 않습니다.