Google アナリティクス分析

Google アナリティクスデータを使用してウェブサイトのパフォーマンスを分析し、実行可能なインサイトと改善提案を提供します。

クイックスタート

1. 認証設定

このSkillは Google アナリティクス API 認証情報が必要です。環境変数を設定してください:

export GOOGLE_ANALYTICS_PROPERTY_ID="your-property-id"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

またはプロジェクトルートに .env ファイルを作成してください:

GOOGLE_ANALYTICS_PROPERTY_ID=123456789
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

認証情報をバージョン管理にコミットしないでください。 サービスアカウント JSON ファイルはリポジトリ外のセキュアな場所に保管する必要があります。

2. 必要なパッケージをインストール

# オプション 1: 要件ファイルからインストール (推奨)
pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt

# オプション 2: 個別にインストール
pip install google-analytics-data python-dotenv pandas

3. プロジェクトを分析

設定完了後、以下のことができます:

• 現在のトラフィックとユーザー行動指標を確認
• パフォーマンスが高いページと低いページを特定
• トラフィックソースとコンバージョンファネルを分析
• 時間帯別のパフォーマンスを比較
• データに基づいた改善を提案

使用方法

以下のような質問をしてください:

• 「過去 30 日間の Google アナリティクスパフォーマンスを確認してください」
• 「トップのトラフィックソースは何ですか?」
• 「バウンス率が最も高いページはどれですか?」
• 「ユーザーエンゲージメントを分析して改善を提案してください」
• 「今月のパフォーマンスを先月と比較してください」

分析ワークフロー

Google アナリティクスデータの分析をリクエストすると、以下のように進めます:

1. API に接続 - ヘルパースクリプトを使用
2. 関連指標を取得 - ご質問に基づいて
3. データを分析 - 以下を検討:
   • トラフィックトレンドとパターン
   • ユーザー行動インサイト
   • パフォーマンスボトルネック
   • コンバージョン機会
4. 推奨事項を提供 - 以下を含めて:
   • 具体的な改善提案
   • 優先度 (高/中/低)
   • 予想される影響
   • 実装ガイダンス

一般的な指標

詳細な指標定義とディメンションについては、REFERENCE.md を参照してください。

トラフィック指標

• セッション数、ユーザー数、新規ユーザー数
• ページビュー数、セッションあたりのスクリーン数
• 平均セッション継続時間

エンゲージメント指標

• バウンス率、エンゲージメント率
• イベント数、コンバージョン数
• スクロール深度、クリックスルー率

獲得指標

• トラフィックソース/メディウム
• キャンペーンパフォーマンス
• チャネルグループ

コンバージョン指標

• 目標達成数
• e コマース取引数
• ソース別コンバージョン率

分析例

完全な分析パターンとユースケースについては、EXAMPLES.md を参照してください。

スクリプト

このSkillには API インタラクション用のユーティリティスクリプトが含まれています:

現在のパフォーマンスを取得

python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate

分析とレポート生成

python scripts/analyze.py --period last-30-days --compare previous-period

スクリプトは API 認証、データ取得、基本的な分析を処理します。結果を解釈し、実行可能な推奨事項を提供します。

トラブルシューティング

認証エラー: 以下を確認してください:

• GOOGLE_APPLICATION_CREDENTIALS が有効なサービスアカウント JSON ファイルを指しているか
• サービスアカウントが GA4 プロパティへの「閲覧者」アクセス権を持っているか
• GOOGLE_ANALYTICS_PROPERTY_ID が GA4 プロパティ ID (測定 ID ではなく) と一致しているか

データが返されない: 以下を確認してください:

• プロパティ ID が正しいか (GA4 管理画面 > プロパティ設定で確認)
• 日付範囲にデータが含まれているか
• サービスアカウントが GA4 でアクセス権を付与されているか

インポートエラー: 必要なパッケージをインストール:

pip install google-analytics-data python-dotenv pandas

セキュリティに関する注意

• API 認証情報またはプロパティ ID を コードにハードコード しないでください
• サービスアカウント JSON ファイルをバージョン管理 の外 に保管してください
• 環境変数または .env ファイルを設定に使用してください
• .env と認証情報ファイルを .gitignore に追加してください
• サービスアカウントキーを定期的にローテーションしてください
• 最小権限アクセスを使用してください (閲覧者ロールのみ)

データプライバシー

このSkillはアグリゲートされた分析データのみにアクセスします。以下のことはしません:

• 個人識別情報 (PII) にアクセス
• 分析データを永続的に保存
• データを外部サービスと共有
• Google アナリティクス設定を変更

すべてのデータはローカルで処理され、会話中に推奨事項を生成するためにのみ使用されます。