このプロジェクトについて

AWS の Clickstream Analytics ガイダンスは、フルスタックのクリックストリームデータプラットフォームを構築できる包括的な参照実装です。このソリューションは、目的別に構築された 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. リージョン、プロファイル、メールパラメータを指定して提供されたデプロイメントスクリプト（solution-deploy.sh）を実行します。 5. CloudFormation が CREATE_COMPLETE を報告したら、CloudFront URL を開いてコンソールにアクセスします。 デプロイ後、データパイプラインを作成し、アプリケーションを登録し、SDK を統合して分析の表示を開始できます。ガイダンスでは、カスタマイズ（カスタムイベント、データ変換プラグイン）、その他の AWS サービス（Personalize、SageMaker）との統合、スケーリング戦略、データガバナンス（リテンション、GDPR/CCPA コントロール）についても説明します。 クリーンアップ手順では、CloudFormation スタックとオプションの S3 バケットを削除する前に、コンソールからパイプラインとアプリケーションを削除することを推奨しています。 開発者向けに、リポジトリにはコントロールプレーンをローカルで実行するスクリプト、Spark ETL JAR をビルドするスクリプト、pnpm を使ってユニットテストを実行するスクリプトが含まれています。詳細な FAQ、既知の問題、トラブルシューティングリンクも提供されます。 全体として、このガイダンスはフルマネージドの AWS サービスを活用しながら、幅広いビジネスニーズに適応可能な本番レベルのエンドツーエンドクリックストリーム分析ソリューションを提供します。