google-ads-intent-map

Google Ads Intent Map

Read first:

• google-ads/references/operator-thesis.md
• google-ads/references/intent-map.md
• google-ads/references/query-patterns.md
• google-ads/references/deliverable-templates.md

Read workspace if available:

• workspace/ads/account.md
• workspace/ads/goals.md
• workspace/ads/intent-map.md
• workspace/ads/queries.md
• workspace/ads/winners.md
• workspace/ads/learnings.md

---

Data Acquisition

Connected Mode (MCP available)

Pull via the search tool on google-ads-mcp:

Primary: All search terms for clustering — last 30 days:

SELECT
  search_term_view.search_term,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.all_conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 1000

Retrieval ladder — if the primary query returns no rows, follow the shared retrieval ladder in data/search-term-retrieval.md. In pmax-fallback mode, use rows for clustering but note that performance metrics are unavailable for intent-class profiling. In limited mode, clustering is blocked — request a UI export.

Supplementary: Campaign and ad group structure (for routing analysis):

SELECT
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.name,
  ad_group.status,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group
WHERE campaign.status = 'ENABLED'
  AND ad_group.status = 'ENABLED'
  AND segments.date DURING LAST_30_DAYS
ORDER BY campaign.name, ad_group.name

See data/gaql-recipes.md for additional queries.

Date Range Fallback

If LAST_30_DAYS returns too few terms for meaningful clustering (<20 terms), fall back to LAST_90_DAYS, then all-time. Intent mapping benefits from volume — more search terms means better clustering. Always state the date range used.