mcpField
G
ga4-audit

ga4-audit

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

ga4-audit について

GA4 Auditは、Google Analytics 4のプロパティ設定とデータ品質を一度だけ点検するスキルです。設定漏れ、レポート上の問題、個人情報収集の可能性を見つけ、読み取り専用の調査結果と推奨事項を記録します。

主な機能

  1. 01プロパティとデータストリーム設定の確認
  2. 02キーイベントとカスタムディメンションの点検
  3. 03トラフィックとデータ品質の確認
  4. 04収集データ内の個人情報の可能性を指摘
  5. 05設定を変更せず調査結果を記録

活用シーン

  1. 01レポート作成前のGA4プロパティ監査
  2. 02コンバージョンイベント設定の漏れの発見
  3. 03高い`(not set)`やDirectトラフィックの調査
  4. 04イベントパラメーター内の個人情報の可能性の特定

MCP 対応

CognyのGoogle Analytics 4 MCPサーバーが必要で、プロパティ、ストリーム、イベント、ディメンション、メタデータ、レポートの確認にそのツールを使います。読み取り専用で、プロパティ設定は変更しません。

インストール

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

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

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

詳細

GA4 監査

Google Analytics 4 プロパティの設定 と データ品質を一度に監査します。 GA4 はタグが発火した瞬間からデータを収集しますが、多くのプロパティでは気付かないうちにデータへの信頼が損なわれています。 重要イベントがマークされていない、パラメータに PII が含まれている、Ads がリンクされていない、トラフィックが (not set) になっている、といった問題です。このスキルは、これらの問題が四半期分のレポートを損なう前に見つけます。

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

前提条件の確認

mcp__cogny__google_analytics_4__tool_get_property を利用できない場合：

This skill requires Cogny's Google Analytics 4 MCP server.

1. Sign up at https://cogny.com/agent
2. Connect your GA4 property
3. Add Cogny to your .mcp.json (see the repo README)
4. Restart Claude Code

ツールがない場合は、ここで中止してください。

使い方

/ga4-audit — プロパティ全体を監査 /ga4-audit config — プロパティ、ストリーム、リンク設定のみ /ga4-audit events — イベント、重要イベント、カスタムディメンションのみ /ga4-audit data-quality — (not set)、PII、異常の確認のみ

手順

1. プロパティの確認
tool_list_account_summaries
tool_get_property        (property_id)

タイムゾーン、通貨、業種カテゴリ、データの保持期間の設定、プロパティの種類を記録します。 データの保持期間がデフォルトの 2 か月のままの場合は指摘してください。前年比の比較を機能させるには 14 か月に設定する必要があります。

2. データストリーム
tool_list_data_streams   (property_id)

以下を指摘してください：

  • 1 つのサイトに複数のウェブストリームがある（データが分割され、ユーザー数が二重にカウントされます）
  • 拡張計測機能がオフになっている、またはチームが実際には必要としていないイベントを計測している
  • アプリを提供するビジネスなのに、iOS／Android ストリームがない
3. 重要イベント（コンバージョン）
tool_list_conversion_events   (property_id)

以下を指摘してください：

  • 重要イベントが設定されていない — Ads の入札と GA4 レポートの両方で基準となるイベントが失われます
  • ノイズの多い自動イベント（page_view、scroll）が重要イベントとしてマークされている — コンバージョン数が膨らみ、誰もが誤解します
  • 明らかなビジネス目標が重要イベントとしてマークされていない（例：generate_lead、purchase、sign_up）
  • 重要イベントが約 10～15 件を超えている — すべてがコンバージョンなら、何もコンバージョンではありません
4. カスタムディメンションと指標
tool_list_custom_dimensions   (property_id)
tool_list_custom_metrics      (property_id)
tool_get_metadata             (property_id)

以下を指摘してください：

  • タグで収集されているものの、カスタムディメンションとして登録されていないイベントパラメータ（レポートでデータが見えません）。get_metadata とストリームから送信される内容を比較してください
  • イベントスコープのディメンション上限 50 件、またはユーザースコープのディメンション上限 25 件に近づいている
  • カーディナリティの高い登録済みディメンション（タイムスタンプ、ID など）— (other) 行の原因になります
5. トラフィックとデータ品質のレポート
tool_run_report   (property_id, last 30 days,
  dimensions: sessionDefaultChannelGroup, sessionSource, sessionMedium,
  metrics: sessions, conversions, totalUsers)

以下を指摘してください：

  • Unassigned または (not set) の割合が高い — UTM の設定ミス、またはタグ付けの不足です（ユーザーに /utm-builder を案内してください）
  • Direct の割合が約 40% を超えている — 通常、参照元データの消失またはタグの不足が原因です
  • 自己参照（参照元が自社ドメイン）— 除外する参照元のフィルターが必要です
  • レポートに社内トラフィックが表示される — 社内トラフィックのフィルターが適用されていません
6. PII とポリシーの確認

get_metadata からイベント名とパラメータ名を調べ、個人データを含む可能性のあるものを確認します。email、phone、user_email、氏名、パラメータ内またはページパス／クエリ文字列内の未加工の住所などが該当します。

🔴 GA4 での PII の使用は Google のポリシーに違反し、プロパティが削除されるリスクがあります。重大な問題として指摘し、該当するパラメータ名を明記してください。

7. インテグレーション

以下を指摘してください：

  • Google Ads がリンクされていない — コンバージョンを Ads に連携して入札に利用できません（ユーザーに確認してください。リンクは API で常に確認できるとは限りません）
  • BigQuery エクスポートがない — 生データを分析したいプロパティには推奨してください（スキーマについては /ga4-bigquery-schema を参照）
  • Search Console がリンクされていない
8. スコアとレポート
GA4 Audit — [Property Name]
GA4 Health Score: X/100

Score breakdown:
  Configuration ...... X/20   (streams, retention, time zone)
  Key events ......... X/25   (the reporting + bidding anchor)
  Custom dimensions .. X/15
  Data quality ....... X/25   ((not set), Direct, self-referrals)
  Compliance ......... X/15   (PII, internal traffic)

🔴 Critical   — PII collected, no key events, retention at 2 months
🟡 Important  — unregistered dimensions, high (not set), no Ads link
🟢 Optimization — BigQuery export, enhanced measurement tuning

Top 3 Actions:
1. [Highest impact]
2. ...
3. ...
9. 調査結果の記録
{
  "title": "Email address captured in GA4 'page_location' — policy violation",
  "body": "The checkout-success URL includes ?email=… and GA4 stores it in page_location and page_path. Google policy prohibits PII in Analytics and can delete the property. Strip the parameter at the tag, or redact it before the event fires.",
  "action_type": "data_quality",
  "expected_outcome": "PII removed from collection; property compliant",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

アクションの種類：tracking_configuration、conversion_setup、data_quality、custom_dimension、integration、compliance。

重要なルール

  1. PII は常に重大な問題です。 はっきり指摘し、パラメータ名を明記してください。
  2. 重要イベントは基準となるものです — GA4 のレポートにも Ads の入札にも必要です。重要度を考慮してください。
  3. 実際の数値を引用してください：保持期間（月数）、(not set) の割合、ディメンション数。
  4. 読み取り専用です。 プロパティ設定は決して変更せず、問題点を示して推奨事項を提示してください。

コメント

Markdown 対応