프로젝트 소개

AWS의 Clickstream Analytics Guidance는 AWS에서 전체 스택 클릭스트림 데이터 플랫폼을 구축할 수 있도록 하는 포괄적인 참조 구현입니다. 이 솔루션은 목적에 맞게 구축된 SDK를 통해 웹, Android, iOS, Flutter, React‑Native 및 기타 클라이언트에서 이벤트 데이터를 수집하고, 구성 가능한 수집 계층을 통해 데이터를 전송하며, EMR Serverless上的 Spark로 처리하고, Amazon S3, Redshift, DynamoDB에 저장하며, Amazon QuickSight로 주요 메트릭을 시각화합니다. 주요 구성 요소: - S3에 호스팅되고 CloudFront를 통해 제공되는 프론트엔드 UI - API Gateway, Lambda로 구축되고 Cognito 또는 OIDC로 보호되는 백엔드 API - Step Functions, EventBridge, CloudFormation을 사용한 파이프라인 수명 주기 오케스트레이션 - ALB, ECS, Amazon MSK 또는 Kinesis Data Streams, S3, EMR Serverless, Redshift, QuickSight로 구성된 데이터 파이프라인 - Android, iOS/Swift, Flutter, React‑Native, Web 등 여러 플랫폼용 SDK로, 일반적인 이벤트를 자동으로 캡처하고 맞춤 이벤트 보고를 허용 - 획득, 참여, 활동, 유지, 디바이스 및 지리 인사이트를 다루는 사전 조립된 QuickSight 대시보드 필수 조건은 현대 OS(macOS, Linux, Windows), AWS CLI, Python 3.11+, Node 20+, pnpm, Docker, 그리고 AdministratorAccess 권한이 있는 AWS 계정입니다. 배포 전에 CDK를 부트스트랩해야 합니다. 배포 단계: 1. 저장소를 클론합니다. 2. pnpm과 프로젝트 의존성을 설치합니다. 3. CDK 환경을 부트스트랩합니다. 4. region, profile, 이메일 매개변수와 함께 제공된 배포 스크립트(solution-deploy.sh)를 실행합니다. 5. CloudFormation이 CREATE_COMPLETE를 보고하면 CloudFront URL을 열어 콘솔에 접근합니다. 배포 후 데이터 파이프라인을 생성하고, 애플리케이션을 등록하며, SDK를 통합하고 분석을 시작할 수 있습니다. 이 가이드는 맞춤 설정(맞춤 이벤트, 데이터 변환 플러그인), 다른 AWS 서비스(Personalize, SageMaker)와의 통합, 확장 전략, 그리고 데이터 거버넌스(보존, GDPR/CCPA 통제)를 다룹니다. 정리 지침은 CloudFormation 스택과 선택적 S3 버킷을 제거하기 전에 콘솔을 통해 파이프라인과 앱을 삭제하도록 권장합니다. 개발자를 위해 저장소에는 로컬에서 컨트롤 플레인을 실행하는 스크립트, Spark ETL JAR을 빌드하는 스크립트, 그리고 pnpm으로 단위 테스트를 실행하는 스크립트가 포함되어 있습니다. 자세한 FAQ, 알려진 문제, 문제 해결 링크가 제공됩니다. 전반적으로 이 가이드는 완전 관리형 AWS 서비스를 활용하여 다양한 비즈니스 요구에 맞게 조정할 수 있는 프로덕션 등급의 엔드‑투‑엔드 클릭스트림 분석 솔루션을 제공합니다.