Opus Growth

Keyword Report

Keyword performance with Quality Score (and its three components) for every keyword that had impressions in the period, sorted by cost.

Tipo
Somente leitura
Créditos
2
Plataforma
Google Ads
Aprovação
Não precisa, nada muda

O que faz

Keyword performance with Quality Score (and its three components) for every keyword that had impressions in the period, sorted by cost. DATE: period ('today', 'last_7_days', ... or 'YYYY-MM-DD[:YYYY-MM-DD]') overrides days; days=0 = today. `active` = the keyword is serving now; paused/removed keywords that had impressions in the period are included as history. include_zero_impressions=true adds keywords with no impressions in the period (the full keyword inventory). Each row has `flags`: low_quality_score (QS 1-3) and/or zero_conversion_spend (cost > 0, no conversions). Summary fields (total_rows, active_count, active_match_types, quality_score_histogram, low_quality_score_total/cost, zero_conversion_spenders_total/cost) cover all rows; only = low_quality_score | zero_conversion_spenders | active returns just those rows. 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; offset=next_offset also works.

A descrição está em inglês porque é o texto oficial que sua IA vê.

MCP: keyword_report

Como usar

Você não chama as ferramentas pelo nome. Escreva o que quer no ChatGPT, Claude ou outro assistente conectado ao Opus Growth; a IA escolhe esta ferramenta quando ela serve.

Parâmetros

NomeTipoObrigatórioPadrão
customer_idstringObrigatório·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.
periodstringOpcional·Reporting period or date-range preset accepted by this operation.
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.
offsetintegerOpcional0Zero-based position at which to start reading results. Use the next_offset returned by the previous response when present.
include_zero_impressionsbooleanOpcionalfalseWhether to include zero impressions in this operation's result or change.
onlystringOpcional·Exact only value for keyword 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.