google_ads_search_terms_review
Score search terms in a Google Ads campaign against six rules and split them into add, exclude, or watch buckets. Uses target CPA to surface high-value actions.
Instructions
Score every search term in a Google Ads campaign against six hardcoded rules and split them into add / exclude / watch buckets. Returns {campaign_id, ad_group_id, period, target_cpa, target_cpa_source, add_candidates, exclude_candidates, watch_candidates, summary:{total_search_terms, add_count, exclude_count, watch_count}, intent_analysis?}. Each candidate has {search_term, action, match_type ('EXACT'|'PHRASE'), score (40-90), reason, metrics:{conversions, clicks, cost, ctr}}. target_cpa is resolved from the explicit argument first, then the campaign's bidding strategy, then last-30-days actual CPA; target_cpa_source reports which path ('explicit'|'bidding_strategy'|'actual'|'none'). New terms absent from the previous period are routed to watch_candidates. Read-only — emits candidates but does not add or exclude anything. Default period is LAST_7_DAYS. For keyword/N-gram overlap stats use google_ads_search_terms_analyze; for the raw query log use google_ads_search_terms_report.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Reporting window for the metrics. Default 'LAST_7_DAYS' — this tool is tuned for short-horizon comparison. Use LAST_14_DAYS or LAST_30_DAYS for longer baselines. | |
| target_cpa | No | Optional explicit target CPA in account currency (e.g. 3000 = ¥3,000). Exclusion rule 4 fires at cost >= target_cpa * 2. Falls back to the campaign's bidding strategy target, then last-30-days actual CPA; if none can be resolved, CPA-gated rules are skipped. | |
| campaign_id | Yes | Campaign ID as a numeric string without dashes (e.g. '23743184133'). Obtain via google_ads_campaigns_list. | |
| customer_id | No | Google Ads customer ID as a 10-digit string without dashes (e.g. '1234567890'). Optional — falls back to GOOGLE_ADS_CUSTOMER_ID / GOOGLE_ADS_LOGIN_CUSTOMER_ID from the configured credentials when omitted. |