takt-angular

@vskstudio/takt-angular 패키지는 Takt 분석 플랫폼을 위한 네이티브 Angular 통합을 제공하며, 개인정보 보호를 우선적으로 고려합니다. 이 패키지는 Angular 17 이상을 대상으로 하며 단일 패키지 관리자 명령어로 프로젝트에 추가할 수 있습니다. 설치 다음 명령어를 실행하세요: pnpm add @vskstudio/takt-angular @vskstudio/takt-core 부트스트랩 통합 루트 부트스트랩 호출에서 provideTakt을 사용하여 제공자를 등록합니다. 제공자는 브라우저에서만 핵심 분석 라이브러리를 초기화하고, 초기 페이지뷰를 전송하며, 선택적인 자동 캡처 기능(외부 링크 클릭, 파일 다운로드, SPA 탐색 등)을 활성화하고, Angular 앱이 파괴될 때 정리 작업을 수행합니다. 서버 측에서는 제공자가 비활성 상태이므로 서버 사이드 렌더링에 안전합니다. 주입 가능한 서비스 TaktService는 애플리케이션 내 어디서든 주입할 수 있습니다. track(eventName, options), pageview(), optOut(), optIn() 등의 메서드를 노출합니다. 모든 메서드는 라이브러리가 초기화되기 전이나 서버에서 실행 중일 때는 아무 작업도 하지 않으며 예외를 발생시키지 않습니다. 선언형 클릭 추적 TaktEventDirective를 사용하면 taktEvent 속성을 통해 모든 클릭 가능한 요소에 추적을 첨부할 수 있으며, 선택적으로 taktProps와 taktRevenue 입력값을 사용할 수 있습니다. 디렉티브는 클릭 시 실시간 분석 인스턴스를 확인하여 마크업을 깔끔하게 유지합니다. UI 위젯 두 개의 독립형 컴포넌트가 제공됩니다: - TaktBadgeComponent는 지정된 도메인에 대한 서버에서 생성된 SVG 배지를 렌더링합니다. - TaktEmbedComponent는 공개 분석 대시보드를 표시하는 샌드박스 iframe을 렌더링합니다. 두 컴포넌트 모두 모든 Angular 템플릿에서 사용 가능하며 domain, theme, size, language 및 시각적 변형에 대한 입력값을 지원합니다. 공개 통계 API createStats 헬퍼는 공개 Takt API용 클라이언트를 생성합니다. 비동기 메서드인 summary, timeseries, realtime 및 breakdown을 제공하여 개발자가 프로그래밍 방식으로 집계된 분석 데이터를 가져올 수 있도록 합니다. 프레임워크 독립형 커스텀 엘리먼트 비 Angular 페이지의 경우 takt-analytics라는 자체 포함 커스텀 엘리먼트가 내보내집니다. defineTaktElement를 호출하거나 모듈을 가져와 자동으로 등록되도록 하면, 일반 HTML에 해당 엘리먼트를 배치할 수 있으며, 외부 링크 추적 및 파일 다운로드 추적과 같은 개인정보 보호 설정을 자동으로 적용합니다. 빌드 단계 없이 빠르게 포함할 수 있는 CDN 번들 또한 제공됩니다. 구성 옵션 TaktConfig은 도메인, 엔드포인트, 외부 링크 추적, 파일 다운로드 추적, SPA 탐색, Do Not Track 존중, 로컬호스트 제외, 샘플링 비율, 쿼리 문자열 처리, 경로 제외, URL 스크럽링 및 태그된 요소 추적과 같은 다양한 옵션을 지원합니다. 대부분의 사이트에 적절한 기본값이 있으며, 구성은 부트스트랩 시 provideTakt에 전달할 수 있습니다. 라이선스 라이브러리는 MIT 라이선스 하에 배포됩니다.