Opus Growth

Search Terms Report

Search terms report: every search term Google reports for the period, one row per (ad group + matched keyword) with impressions, clicks, ctr, cost and conversions, so the same term appears once per ad group / keyword…

Tipo
Solo lectura
Créditos
2
Plataforma
Google Ads
Aprobación
No hace falta, nada cambia

Qué hace

Search terms report: every search term Google reports for the period, one row per (ad group + matched keyword) with impressions, clicks, ctr, cost and conversions, so the same term appears once per ad group / keyword it matched. Each row has `bucket`: converter (conversions > 0), waste_candidate (no conversions and cost >= min_waste, not blocked by an existing negative), already_negative (an existing ad group, campaign or shared-list negative already blocks it; the blocking negative is in `already_negative`), or null. `buckets` gives the count and cost of each bucket over all rows; only = converters | waste_candidates | already_negative returns just that bucket's rows. sort: cost | impressions | clicks | conversions. min_clicks: 0 includes terms with impressions but no clicks. Google withholds very low-volume terms behind its privacy threshold. DATE: period ('today', 'yesterday', 'this_month', 'last_7_days', ... or 'YYYY-MM-DD[:YYYY-MM-DD]') overrides days; days=0 = today; start_date/end_date (YYYY-MM-DD) also set an explicit range. campaign_id: one id or comma-separated ids. Smart campaigns are included with campaign_type='SMART' (Google exposes only impressions, clicks and cost for them; conversions=null, bucket=null). limit = rows in this response (no upper bound; 0 = as many as fit, about 380 KB); when has_more is true, page_token=next_page_token returns the next rows without credits or a new query.

La descripción está en inglés porque es el texto oficial que ve tu IA.

MCP: search_terms_report

Cómo usarla

No llamas a las herramientas por su nombre. Escribe lo que quieres en ChatGPT, Claude u otro asistente conectado a Opus Growth; la IA elige esta herramienta cuando encaja.

Parámetros

NombreTipoObligatorioPor defecto
customer_idstringOpcional·Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise.
daysintegerOpcional90Number of calendar days to look back from now for this analysis or report.
min_wastenumberOpcional50.0Minimum waste or spend threshold used to surface an optimisation finding.
periodstringOpcional·Reporting period or date-range preset accepted by this operation.
sortstringOpcionalcostSort field and direction accepted by this operation, in the provider's documented format.
min_clicksintegerOpcional0Numeric min clicks value for search terms report. Use the provider's expected unit, range, and precision.
limitintegerOpcional0Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete.
campaign_idstringOpcional·Exact campaign identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name.
start_datestringOpcional·Inclusive start date for the requested period, in the format required by this tool.
end_datestringOpcional·Inclusive end date for the requested period, in the format required by this tool.
onlystringOpcional·Exact only value for search terms report. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation.
page_tokenstringOpcional·Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page.