mcpField
G
google-ads-monitor

google-ads-monitor

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

google-ads-monitor について

google-ads-monitorは、Google Adsアカウントを毎週定期確認するCogny Agent向けスキルです。前週と実績を比較し、配信、ポリシー、コンバージョン計測、予算、入札の問題を検出しますが、設定は変更しません。

主な機能

  1. 01アカウント実績の週次比較
  2. 02キャンペーンの変動追跡
  3. 03不承認または制限付き広告の通知
  4. 04コンバージョン計測停止の検出
  5. 05予算と入札状況の確認
  6. 06スナップショットと重要所見の保存

活用シーン

  1. 01定期的な週次アカウント点検
  2. 02記録が止まったコンバージョンの発見
  3. 03費用や配信の急変調査
  4. 04広告ポリシーと入札アラートの確認

MCP 対応

CognyのGoogle Ads MCPツールでアカウント、キャンペーン、広告、コンバージョンデータを取得し、Cognyのコンテキストツールで週次スナップショットを読み書きします。読み取り専用で、キャンペーンや予算は変更しません。

インストール

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

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

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

詳細

Google Ads モニター

広告が引き続き正常に配信されているか、毎週定期的に確認します。広告の不承認、トラッキングの停止、キャンペーンの予算超過といった、気づかないうちに発生する問題を検出し、前週比で報告するため、ノイズではなく傾向を把握できます。

必要条件: Cogny Agent サブスクリプション(月額 $9)— 登録

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

前提条件の確認

mcp__cogny__google_ads__tool_execute_gaql が利用できない場合は、Cogny の登録手順(/google-ads-audit を参照)を表示して終了します。

使い方

/google-ads-monitor — 接続済みアカウントの週次ヘルスチェックです。

一度限りの詳細なレビューを行うには、代わりに /google-ads-audit を実行してください。このスキルは軽量で繰り返し実行する定期チェックであり、監査は徹底的な詳細レビューです。

手順

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

insights/google-ads/monitor/latest に対して read_context_node を呼び出します。存在する場合は、先週の指標が保存されています。今週の各数値は、これを基準にした差分として報告します。存在しない場合は初回実行です。絶対値を報告し、差分の比較は来週から始まることを明記します。

2. アカウント全体のパフォーマンス(直近 7 日間とその前の 7 日間の比較)
SELECT metrics.cost_micros, metrics.conversions, metrics.conversions_value,
  metrics.clicks, metrics.impressions
FROM customer
WHERE segments.date DURING LAST_7_DAYS

前の 7 日間についても BETWEEN の期間を指定して繰り返します。費用、コンバージョン数、CPA、ROAS、CTR の前週比の差分を計算します。

3. キャンペーンごとの変動
SELECT campaign.name, campaign.status, campaign.advertising_channel_type,
  campaign_budget.amount_micros, metrics.cost_micros, metrics.conversions,
  metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_7_DAYS AND campaign.status = 'ENABLED'
ORDER BY metrics.cost_micros DESC

次のいずれかに該当するキャンペーンがあれば、🔴 アラートを出します。

  • 前週より費用が 40% を超えて増加した
  • 前週にコンバージョンがあったのに、コンバージョン数がゼロになった
  • 毎日、1 日の予算上限に達している(予算による制限)
  • 配信が完全に停止した(有効のままインプレッションがゼロ)
4. 広告の不承認とポリシー上の問題
SELECT ad_group_ad.ad.id, ad_group_ad.policy_summary.approval_status,
  ad_group_ad.policy_summary.review_status, campaign.name, ad_group.name
FROM ad_group_ad
WHERE ad_group_ad.status = 'ENABLED'
  AND ad_group_ad.policy_summary.approval_status != 'APPROVED'

DISAPPROVED の広告があれば、🔴 アラートを出します。APPROVED_LIMITED(配信中だが制限あり)には、🟡 注意喚起を行います。

5. コンバージョントラッキングの稼働状況
SELECT conversion_action.name, conversion_action.status,
  metrics.conversions, metrics.all_conversions
FROM conversion_action
WHERE segments.date DURING LAST_7_DAYS

先週コンバージョンを記録した主要なコンバージョン アクションで、今週のコンバージョンがゼロの場合は、🔴 アラートを出します。ほぼ確実にトラッキングが壊れています。このスキルで最も重要なチェックです。

6. 予算と入札の変動

入札戦略のステータスが LEARNING に変わったキャンペーンと、目標 CPA/ROAS が設定されているにもかかわらず、実績が目標から 50% を超えて乖離しているキャンペーンを報告します。

7. 出力
Google Ads Monitor — [Account Name]
Week of [YYYY-MM-DD] – [YYYY-MM-DD]

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

Performance (7d vs prior 7d)
- Spend ........ $X,XXX  (+/-X% WoW)
- Conversions .. XXX     (+/-X% WoW)
- CPA .......... $XX     (+/-X% WoW)
- ROAS ......... X.Xx    (+/-X% WoW)

Campaign movers
| Campaign | Type | Spend (WoW) | Conv (WoW) | Note |
|----------|------|-------------|------------|------|

Disapproved / limited ads: [N]
Conversion tracking: [OK / BROKEN — details]

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

今週の指標(費用、コンバージョン数、CPA、ROAS、キャンペーンごとの数値、不承認件数)を指定して、insights/google-ads/monitor/latest に対して write_context_node を呼び出します。これにより、来週、差分を計算できます。また、履歴用に insights/google-ads/monitor/<YYYY-MM-DD> に日付付きのコピーも書き込みます。

9. 指摘事項を記録する — 必要なものだけ

create_finding を作成するのは、実際の問題(不承認、トラッキングの故障、費用の急増、収益性があるのに予算で制限されているキャンペーン)に限ります。通常の数値は記録しません。問題のない週は、指摘事項をゼロ件にします。

{
  "title": "Conversion tracking stopped — 'Lead Form Submit' at 0 this week",
  "body": "'Lead Form Submit' recorded 41 conversions last week, 0 this week, while clicks held steady. The tag or GTM trigger has likely broken. Check the GA4/Ads conversion tag.",
  "action_type": "conversion_tracking",
  "expected_outcome": "Tracking restored; Smart Bidding gets accurate signal again",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

アクションタイプ:conversion_tracking、budget_adjustment、campaign_optimization、policy_fix、bidding_strategy。

重要なルール

  1. スナップショットより傾向を重視します。 必ず前週比の差分を報告してください。単週の数値だけではノイズになります。
  2. 問題点から伝えます。 問題がなければ、その旨を 1 行で伝え、レポートは簡潔にします。
  3. トラッキングの故障は常に重大です。 後続のすべての数値が不正確になります。
  4. 読み取り専用です。 キャンペーンの一時停止や予算変更は行いません。問題を提示するだけにとどめ、対処はしません。

コメント