/google-ads-monitor

name: google-ads-monitor
description: Weekly Google Ads health check (plus Microsoft Ads, Apple Search Ads and ChatGPT ads when connected) — budget pacing, spend spikes, disapproved ads, conversion-tracking breaks, CPA/ROAS swings — with week-over-week deltas
version: "1.1.2"
author: Cogny AI
requires: cogny-mcp
platforms: [google-ads, microsoft-ads, apple-search-ads, openai-ads]
user-invocable: true
argument-hint: ""
allowed-tools:
  - mcp__cogny__refresh_mcp_discovery
  - mcp__cogny__mcp__Google_Ads__tool_list_accessible_accounts
  - mcp__cogny__mcp__Google_Ads__tool_execute_gaql
  - mcp__cogny__mcp__Google_Ads__tool_get_gaql_doc
  - mcp__cogny__mcp__Bing_Ads__tool_list_accounts
  - mcp__cogny__mcp__Bing_Ads__tool_get_campaigns
  - mcp__cogny__mcp__Bing_Ads__tool_get_ad_groups
  - mcp__cogny__mcp__Bing_Ads__tool_get_ads
  - mcp__cogny__mcp__Bing_Ads__tool_get_report
  - mcp__cogny__mcp__Apple_Search_Ads__tool_list_acls
  - mcp__cogny__mcp__Apple_Search_Ads__tool_get_campaigns
  - mcp__cogny__mcp__Apple_Search_Ads__tool_get_campaign_report
  - mcp__cogny__mcp__OpenAI_Ads__tool_get_ad_account
  - mcp__cogny__mcp__OpenAI_Ads__tool_get_campaigns
  - mcp__cogny__mcp__OpenAI_Ads__tool_get_insights
  - mcp__cogny__mcp__OpenAI_Ads__tool_get_conversion_insights
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_account_summaries
  - mcp__cogny__mcp__Google_Analytics_4__tool_run_report
  - mcp__cogny__mcp__Shopify__tool_list_orders
  - mcp__cogny__mcp__WooCommerce__get_sales_report
  - mcp__cogny__mcp__Stripe__stripe_api_read
  - mcp__cogny__list_integrations
  - mcp__cogny__create_finding
  - mcp__cogny__create_ticket
  - mcp__cogny__write_context_node
  - mcp__cogny__read_context_node
  - WebFetch

Google Ads Monitor

A recurring weekly check that makes sure your ads are still running smoothly. It catches the things that break quietly — a disapproved ad, tracking that stopped firing, a campaign that started overspending — and reports week-over-week so you see trends, not noise.

**Requires:** Cogny Agent subscription ($9/mo) — [Sign up](https://cogny.com)

Designed to be scheduled weekly via `/loop` or `/schedule`.

Works with

| Job | Primary | Also answers it | Differences to state | |-----|---------|-----------------|----------------------| | Spend, conversions, CPA/ROAS WoW | Google Ads | Microsoft Ads (`Bing_Ads`), Apple Search Ads, ChatGPT ads (`OpenAI_Ads`) | Google cost is micros; Bing/OpenAI money is account-currency units; Apple reports taps and installs | | Disapprovals | Google Ads (`policy_summary`) | Microsoft Ads (`tool_get_ads` editorial status) | Apple and OpenAI: check campaign/ad status only | | Tracking heartbeat | Google Ads `conversion_action` | GA4 key events; Shopify / WooCommerce orders | Platform conversions are attributed; store orders are the ground truth for "did sales really stop" |

Call `list_integrations` once. Run steps 2–6 for every connected ad platform and report each in its own block. Never add spend across platforms or currencies.

Step 0: Cogny check

If no `mcp__cogny__*` tools exist (no `list_integrations`, no `cogny_status`), print this and stop:

Google Ads Monitor needs your marketing data through Cogny's MCP gateway.

1. Sign up at https://cogny.com and connect Google Ads (plus Microsoft Ads, Apple Search
   Ads, ChatGPT ads, GA4, Shopify, WooCommerce or Stripe if you use them).
2. Add Cogny to .mcp.json in your project:
   {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Nothing to run without Cogny.

If Cogny is connected but no search ad platform (`Google_Ads`, `Bing_Ads`, `Apple_Search_Ads`, `OpenAI_Ads`) is, say "connect Google Ads (or another search ad platform) in Cogny" and stop. A platform that is listed but unhealthy, or whose first read returns 401/permission denied, gets "reconnect <platform> in Cogny" and is skipped. With Google Ads missing, run the other platforms' branches and skip the GAQL queries.

Usage

`/google-ads-monitor` — weekly health check of the connected account.

For a deep one-time review, run `/google-ads-audit` instead. This skill is the light, repeatable rhythm; the audit is the full teardown.

Steps

Google Ads money fields are micros (divide by 1,000,000). An empty GAQL result (no rows, or the tool returns no output) means zero: no matching rows or no activity in the window. Report it as 0, not as an error.

1. Read the prior snapshot

Call `read_context_node` on `insights/google-ads/monitor/latest` (and `insights/microsoft-ads/monitor/latest`, `insights/apple-search-ads/monitor/latest`, `insights/openai-ads/monitor/latest` for the other connected platforms). If it exists, it holds last week's metrics — every number this week is reported as a delta against it. If it does not exist, this is the first run: report absolute numbers and note that deltas start next week.

2. Account-level performance (last 7d vs prior 7d)

SELECT metrics.cost_micros, metrics.conversions, metrics.conversions_value,
  metrics.clicks, metrics.impressions
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Repeat with a `BETWEEN` range for the prior 7 days. Compute WoW deltas for spend, conversions, CPA, ROAS, CTR.

**Other platforms, same two 7-day windows:**

| Platform | Call | Notes | |----------|------|-------| | Microsoft Ads | `mcp__cogny__mcp__Bing_Ads__tool_get_report` (`account_id`, `report_type: "campaign"`, `start_date`, `end_date`) | `Spend`, `Conversions`, `Revenue`, `ReturnOnAdSpend`; `Ctr` is a percent | | Apple Search Ads | `tool_list_acls` → `tool_get_campaigns` → `tool_get_campaign_report` (`org_id`, `campaign_id`, `start_date`, `end_date`, `granularity: "TOTAL"`) | Per campaign; installs and cost per install | | ChatGPT ads | `mcp__cogny__mcp__OpenAI_Ads__tool_get_insights` (`aggregation_level: "campaign"`, `start_date`, `end_date`) and `tool_get_conversion_insigh