google_ads_search_terms_review
Score every search term against six rules to split them into add, exclude, or watch candidates. Provides detailed metrics and reasons for each candidate to optimize campaign performance.
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 |
|---|---|---|---|
| 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. | |
| campaign_id | Yes | Campaign ID as a numeric string without dashes (e.g. '23743184133'). Obtain via google_ads_campaigns_list. | |
| 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. |