프로젝트 소개

이 저장소는 Tinybird의 Events API 및 Endpoints를 기반으로 웹 분석 플랫폼을 구축하기 위한 템플릿입니다. 개인정보 보호와 속도를 강조하며, README에 따르면 Tinybird에 대한 사전 지식 없이도 몇 분 만에 사전 구축된 대시보드에서 실시간 지표를 확인할 수 있습니다. 설정 후에는 실시간 성능을 유지하면서 이커머스나 마케팅과 같은 유스케이스를 위한 커스텀 이벤트를 추가할 수 있습니다. 설정 방법은 저장소를 클론하고 tinybird 디렉토리로 이동하여 pnpm으로 의존성을 설치한 뒤, Tinybird에 로그인하고 배포하는 것입니다. 추적은 제공된 스크립트 스니펫을 트래커 토큰과 함께 사이트의 head 섹션에 배치하여 활성화합니다. README는 방문자가 사이트를 보고 상호작용할 때 page_hit 이벤트가 발생할 것으로 예상합니다. 커스텀 이벤트는 Tinybird.trackEvent를 통해 전송할 수 있습니다. 커스텀 속성은 data-tb_ 접두사를 사용하며, 모든 이벤트에 포함되어 analytics_events 데이터소스의 payload 컬럼에 저장됩니다. 멀티 테넌시 및 멀티 도메인 지원은 data-domain 및 data-tenant-id 파라미터를 사용합니다. 모든 프로젝트 엔드포인트는 tenant_id 및 domain으로 필터링할 수 있으며, JWT 토큰에 fixed_params를 포함할 수도 있습니다. 트래커는 web-vitals 라이브러리를 통해 웹 바이탈(web vitals)도 지원합니다. web_vital 액션이 포함된 이벤트에는 LCP, TTFB, FCP, INP, CLS와 같은 지표가 포함됩니다. analytics.tinybird.live에서 워크스페이스 관리자 토큰을 붙여넣어 기성 대시보드를 사용할 수 있습니다. 대시보드 토큰 또한 Tinybird에서 획득합니다. 고급 섹션에서는 로컬 개발을 위해 별도의 tinybird 및 dashboard README를 안내합니다. pnpm dev는 변경 사항을 Tinybird 브랜치로 동기화하며, pnpm deploy는 프로덕션용으로 사용됩니다. TINYBIRD_TOKEN 및 TINYBIRD_HOST 값이 포함된 .env.local 파일이 생성됩니다. 사용자는 Vercel에서 자체 대시보드를 커스터마이징하고 호스팅할 수 있습니다. README는 Tinybird가 플랫폼으로서 GDPR을 준수하지만, 데이터 수집 및 동의에 관한 GDPR 규칙 준수 책임은 사용자에게 있음을 명시하고 있습니다.