tgram-analytics-js

tgram-analytics JS SDK는 tgram-analytics 서버에 분석 이벤트를 전송하기 위한 최소 클라이언트 라이브러리입니다. 브라우저에서 네이티브 API만으로 실행되며 외부 의존성이 없고, gzip 압축 시 빌드 파일 크기가 2킬로바이트 미만이어서 로드 속도가 빠릅니다. 주요 기능: - 제로 의존성 및 초소형 번들 크기 - 별도의 @types 패키지 없이 TypeScript 타입 정의 내장 - 프라이버시 중심 설계: 쿠키 없음, 핑거프린팅 없음, 브라우저의 Do Not Track 설정 옵트인 가능, 세션 ID는 sessionStorage에만 저장 - 단일 페이지 애플리케이션(SPAs)을 위한 자동 페이지뷰 추적. 연속된 동일 URL 중복 제거. React Router, Vue Router, Next.js, SvelteKit 및 History API를 사용하는 모든 프레임워크와 호환 - 스칼라 값과 다중 값 속성을 위한 스칼라 배열을 지원하는 단순 track 메서드를 통한 수동 이벤트 추적 - 모든 후속 이벤트에 영구 사용자 속성을 연결하는 identify 메서드 - 사용자 동의에 대한 옵트인/옵트아웃 제어(지속성은 애플리케이션에서 처리) - 최대 배치 크기 및 최대 대기 시간으로 구성 가능한 이벤트 배치(네트워크 요청 감소) - 서버 URL, 자동 페이지뷰 처리, DNT 존중, 컨텍스트 수집, 사용자 정의 세션 ID 등 구성 옵션 제공 - npm 또는 빌드 단계가 없는 프로젝트를 위한 일반 스크립트 태그를 통한 간편 설치 - init, track, pageview, identify, opt, flush, reset의 포괄적 API - 잘못된 이벤트 모양 및 누락된 구성에 대한 명확한 오류 처리 - MIT 라이선스 및 기여 개방 일반적인 사용법은 기본 내보내기를 가져와 프로젝트 API 키와 서버 URL로 한 번 초기화한 후, 사용자 지정 이벤트를 기록해야 하는 곳에서 track를 호출하는 것입니다. 페이지뷰는 비활성화하지 않는 한 자동으로 전송됩니다. SDK는 스크립트 태그로 로드될 때 전역 TGA 객체도 포함하여 모듈 시스템 없이 즉시 사용할 수 있습니다. 프라이버시 조치로 현재 탭을 넘어선 영구 식별자가 저장되지 않으며, 서버는 프로젝트별로 도메인 허용 목록을 강제하여 무단 데이터 수집을 방지합니다. 개발자를 위해 패키지는 빌드 스크립트, 테스트 스위트, TypeScript 타입 체크, 린팅 및 포맷팅 도구를 제공하며 명확한 기여 가이드라인을 포함하고 있습니다. 전반적으로 tgram-analytics JS SDK는 사용자 프라이버시와 개발자 편의성을 존중하면서 이벤트 데이터를 수집하는 직관적이고 오버헤드가 낮은 방법을 제공합니다.