mcpField
G
google-analytics

google-analytics

github.com/thatrebeccaraeデータ・データベース188114 回インストール24 週間前に更新
リポジトリ

google-analytics について

ウェブサイト運営者向けのGoogle Analytics分析スキルです。GA4のトラフィック、行動、コンバージョンを調べ、優先度と予想される影響を添えた改善案を提示します。

主な機能

  1. 01トラフィックと行動の分析
  2. 02好調・低調なページの特定
  3. 03流入元とコンバージョン経路の分析
  4. 04期間ごとの実績比較
  5. 05優先度付き改善案の作成

活用シーン

  1. 01直近30日間のサイト実績を確認
  2. 02主要な流入元を特定
  3. 03直帰率の高いページを発見
  4. 04今月と先月のデータを比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thatrebeccarae/claude-marketing --skill google-analytics

インストール後、Claude Code で/google-analyticsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.env.example
EXAMPLES.md
LICENSE
REFERENCE.md
requirements.txt
scripts/
analyze.py
ga_client.py

詳細

Google アナリティクス分析

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

インストール

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/google-analytics ~/.claude/skills/

クイックスタート

1. 認証を設定する

このスキルには Google Analytics 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. 必要なパッケージをインストールする
# Option 1: Install from requirements file (recommended)
pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt

# Option 2: Install individually
pip install google-analytics-data python-dotenv pandas
3. プロジェクトを分析する

設定が完了すると、次のことができます。

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

使用方法

次のような質問をしてください。

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

分析ワークフロー

Google アナリティクスのデータ分析を依頼されると、次の手順を実行します。

  1. ヘルパースクリプトを使用してAPI に接続します
  2. 質問に基づいて関連する指標を取得します
  3. 次の項目に注目してデータを分析します。
    • トラフィックの傾向とパターン
    • ユーザー行動に関するインサイト
    • パフォーマンスのボトルネック
    • コンバージョンの機会
  4. 次の内容を含む提案を提供します。
    • 具体的な改善案
    • 優先度（高／中／低）
    • 期待される効果
    • 実装のガイダンス

一般的な指標

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

トラフィック指標
  • セッション数、ユーザー数、新規ユーザー数
  • ページビュー数、セッションあたりの画面数
  • 平均セッション時間
エンゲージメント指標
  • 直帰率、エンゲージメント率
  • イベント数、コンバージョン数
  • スクロール深度、クリック率
獲得指標
  • トラフィックソース／メディア
  • キャンペーンのパフォーマンス
  • チャネルグループ
コンバージョン指標
  • 目標達成数
  • eコマースのトランザクション数
  • ソース別コンバージョン率

分析例

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

スクリプト

このスキルには、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 に追加してください
  • サービスアカウントキーを定期的にローテーションしてください
  • 最小権限のアクセス（閲覧者ロールのみ）を使用してください

データプライバシー

このスキルがアクセスするのは、集計済みの分析データのみです。次のことは行いません。

  • 個人を特定できる情報（PII）へのアクセス
  • 分析データの永続的な保存
  • 外部サービスとのデータ共有
  • Google アナリティクス設定の変更

すべてのデータはローカルで処理され、会話中に提案を生成する目的にのみ使用されます。

コメント

Markdown 対応