mcpField
G
ga4-monitor

ga4-monitor

github.com/cognyaiマーケティング・グロース11145 回インストール2 週間前に更新
リポジトリ

ga4-monitor について

接続済みのGoogle Analytics 4プロパティを週次で読み取り専用チェックするCogny Agentスキルです。トラフィックとコンバージョンを前週と比較し、データ計測やキーイベントの不具合を検出します。

主な機能

  1. 01週次のGA4ヘルスチェック
  2. 02前週比のトラフィック比較
  3. 03キーイベントのコンバージョン監視
  4. 04チャネル構成の異常検出
  5. 05スナップショットと所見の記録

活用シーン

  1. 01キーイベントの計測停止の発見
  2. 02週次のトラフィックとエンゲージメント確認
  3. 03チャネル帰属の異常検出

MCP 対応

Cogny AgentのGoogle Analytics 4ツールでレポートとコンバージョンイベントを取得します。読み取り専用で、プロパティは変更しません。

インストール

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

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill ga4-monitor

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

詳細

GA4 モニター

GA4 プロパティを毎週定期的にチェックします。データが引き続き流入していることを確認し、前週比のトラフィックとコンバージョンを報告します。最も重要なのは、タグの不具合で重要なイベントが発火しなくなったという、気付きにくい障害を検出することです。

必要条件： Cogny Agent のサブスクリプション（月額 9 ドル）— 登録

/loop または /schedule を使って毎週スケジュールするよう設計されています。

前提条件の確認

mcp__cogny__google_analytics_4__tool_run_report が利用できない場合は、Cogny の登録手順（/ga4-audit を参照）を表示して終了します。

使い方

/ga4-monitor — 接続されている GA4 プロパティの週次ヘルスチェックです。

一度だけ全体を確認する場合は、/ga4-audit を実行します。こちらは簡易的な週次チェックです。

手順

1. 前回のスナップショットを読み込む

insights/ga4/monitor/latest に対して read_context_node を呼び出します。存在する場合は、先週の数値が含まれているため、すべての指標をその数値との差分として報告します。存在しない場合は初回実行です。絶対値を報告し、差分は来週から算出されることを明記します。

2. データフローの稼働確認
tool_run_realtime_report   (property_id, metrics: activeUsers)

通常のトラフィックがあるサイトでリアルタイムのアクティブユーザー数がゼロの場合、タグが停止している可能性があります。そのことを記録し、警告を出す前に 7 日間のレポートで確認します。

3. トラフィックとエンゲージメント（直近 7 日間とその前の 7 日間）
tool_run_report   (property_id,
  date range A: last 7 days, date range B: prior 7 days,
  metrics: sessions, totalUsers, newUsers, engagementRate, averageSessionDuration)

各指標を前週比の差分とともに報告します。

4. キーイベントのコンバージョン（重要なチェック項目）
tool_list_conversion_events   (property_id)
tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: eventName,
  metrics: eventCount, conversions, totalRevenue)

🔴 先週コンバージョンが記録されていたキーイベントが今週ゼロの場合は警告します。タグまたは GTM トリガーがほぼ確実に壊れています。これはこのスキルで最も重要なチェック項目です。

🟡 明らかなトラフィック要因がないのにキーイベントが前週比で 50% を超えて減少した場合は、注意を促します。

5. チャネル構成
tool_run_report   (property_id, last 7d vs prior 7d,
  dimensions: sessionDefaultChannelGroup,
  metrics: sessions, conversions)

🟡 次の場合は警告します：

  • Unassigned / (not set) のセッションが急増した場合 — どこかで UTM が壊れています
  • Direct が急増した場合 — タグ付けまたはリダイレクトの問題であることがよくあります
  • チャネルが急激に減少した場合（キャンペーンの終了、またはトラッキングの消失）
6. 出力
GA4 Monitor — [Property Name]
Week of [YYYY-MM-DD] – [YYYY-MM-DD]

⚠️  Needs attention this week
- [Critical/important first, or "Nothing — data is flowing clean."]

Traffic (7d vs prior 7d)
- Sessions ........ XX,XXX  (+/-X% WoW)
- Users ........... XX,XXX  (+/-X% WoW)
- Engagement rate . XX%     (+/-X pts WoW)

Conversions (7d vs prior 7d)
| Key event | This week | Last week | WoW | Revenue |
|-----------|-----------|-----------|-----|---------|

Channel mix
| Channel | Sessions (WoW) | Conv (WoW) |
|---------|----------------|------------|

Recommended actions
1. ...
7. 今週のスナップショットを保存する

今週の指標（セッション数、ユーザー数、エンゲージメント、キーイベントごとのコンバージョン数と収益、チャネル構成）を insights/ga4/monitor/latest に対して write_context_node で書き込み、来週差分を算出できるようにします。また、日付入りのコピーを insights/ga4/monitor/<YYYY-MM-DD> に書き込みます。

8. 検出結果を記録する — 必要な場合のみ

実際の問題（発火しなくなったキーイベント、急減したチャネル、急増した (not set)）に限り、create_finding を作成します。問題がない週は何も記録しません。

{
  "title": "GA4 key event 'generate_lead' dropped to 0 this week",
  "body": "'generate_lead' recorded 96 conversions last week and 0 this week while sessions held steady. The form tag or its GTM trigger has broken. Check GTM Preview on the form page and the GA4 DebugView.",
  "action_type": "tracking_break",
  "expected_outcome": "Lead tracking restored; Ads bidding gets signal again",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

アクションの種類：tracking_break、data_quality、conversion_setup、channel_anomaly。

重要なルール

  1. スナップショットより推移を重視します。 すべての指標に前週比の差分を付けます。
  2. キーイベントがゼロの場合は重大です。 通常はタグの不具合を意味し、広告の入札にも悪影響を及ぼします。GTM が接続されている場合は /gtm-monitor でも確認します。
  3. 問題点から報告します。 問題のない週は、短い段落 1 つでまとめます。
  4. 読み取り専用です。 問題を報告し、プロパティは変更しません。

コメント

Markdown 対応