---
name: adspirer-search-google-ads
description: Create and manage Google Ads campaigns through Adspirer — Search, Performance Max, Demand Gen, YouTube, and Display. Use for Google Ads keywords, search terms, quality score, bid strategies, sitelinks and extensions, PMax asset groups, or anything on Google/AdWords. Covers the asset-bundle expiry and ad-group-id traps.
---

# Google Ads

Adapted from the main Adspirer Cursor Google Ads skill. Load the live Search Ads contract first.
Named operations below are discovery candidates, not guaranteed top-level tools. Only execute an
operation returned by the appropriate router. Approval is required for all mutations; read back results.

Google platform operations use `google_ads_read` for reads and `google_ads_write` for writes. Follow `adspirer-search-mcp` for the
two-step: `{"action": "list_tools"}` first, then `{"action": "execute", "tool_name": ..., "arguments": {...}}`.

Account parameter: `customer_id`, as a **string**. Hyphens are stripped for you.
Check the live schema for budget units and confirm the account currency. Never assume USD or convert amounts without authorization.

## Creating a campaign

**1. Pick the type.** If the user just said "create a campaign," run `select_google_campaign_type`
rather than guessing. Search, Performance Max, Demand Gen, YouTube, and Display solve different
problems — `references/campaign-types.md` has the decision tree and the budget each type actually
needs to learn.

**2. Gather what's required.** Budget, final URL, locations, and the conversion goal. Resolve place
names with `resolve_google_locations` instead of guessing geo ids.

**3. Prepare assets.** For Performance Max, run `discover_existing_assets` first — the account
usually already has images and logos, and reusing them is faster and better than asking the user to
upload. Then `validate_and_prepare_assets`.

> **Asset bundles expire after one hour.** If more than an hour passed between preparing assets and
> creating the campaign, re-run `validate_and_prepare_assets` and use the fresh bundle. A stale
> bundle fails at create time.

**4. Get approval, then create paused.** Present the exact account, targeting, assets, and budget for user approval. Set paused status explicitly according to the live schema and verify it; do not assume every creation tool defaults to paused.

**5. Add extensions. This is not optional for Search.** A Search campaign without extensions
underperforms badly and Google will tell you so. Add at least 4 sitelinks, 4–6 callouts, and
structured snippets before you call the build finished. See `references/extensions.md`.

**6. Read it back.** List the campaign and confirm budget, status, and targeting match what you
intended. Then tell the user it is paused and ask whether to resume.

## Keywords and ads attach to ad groups, not campaigns

Account, campaign, and ad-group operations have different scopes. Inspect each schema; never assume all negatives belong to an ad group. Run
`get_campaign_structure` to get them. Do not pass a campaign id where an ad group id is expected.

For keyword research, `research_keywords` returns volume and competition from Google's own planner.
`analyze_search_terms` shows what people actually typed — that's where the negatives come from.

## Bidding

Choose bidding from the user's objective, reliable conversion tracking, budget, and current platform eligibility. Treat reference thresholds as planning heuristics, not universal requirements. Check current Google guidance before prescribing a strategy.

## Reading performance

`get_campaign_performance` is a **direct, top-level tool** — do not route it through `google_ads`.
It returns performance results; card rendering depends on the host. Pass `raw_data: true` when the user wants the numbers rather than
the summary.

For waste, `analyze_wasted_spend` finds spend with no conversions. For a sudden change,
`explain_performance_anomaly` compares windows and attributes the delta.

## Rate limits

Respect current service/platform limits and returned quota errors. Batch only within documented limits; do not assume fixed per-hour quotas.

## References

- `references/campaign-types.md` — which type to use, and the budget each needs
- `references/bidding.md` — bid strategies and when each becomes viable
- `references/pmax-assets.md` — Performance Max asset requirements
- `references/extensions.md` — the mandatory extensions step