Simplificação das métricas de previsão de palavras-chave na API Google Ads v24

Quinta-feira, 23 de abril de 2026

Para oferecer uma experiência mais simplificada e confiável, unificamos nossa infraestrutura de estimativas. A API Google Ads v24 apresenta um método GenerateKeywordForecastMetrics atualizado que simplifica o processo de planejamento, concentrando-se nas métricas que mais afetam sua performance.

O que muda?

Para simplificar nossos sistemas e focar nos dados principais que impulsionam o planejamento de pesquisa, a API Google Ads v24 apresenta as seguintes melhorias:

1. Alinhamento com estratégias de lances

Para oferecer uma experiência mais consistente nas ferramentas do Google Ads, as previsões agora se concentram exclusivamente nas métricas principais que são diretamente afetadas pela estratégia de lances escolhida. Esse alinhamento garante que os dados usados no planejamento sejam sincronizados com os indicadores de performance de alto impacto das suas campanhas reais:

• CPC manual e Maximizar cliques: as previsões mostram cliques, CPC médio e custo.
• Maximizar conversões: as previsões mostram as conversões, o CPA médio e o custo.
• Foco nas métricas: para manter a consistência em toda a plataforma, as previsões não incluem mais dados de várias métricas (como estimativas de conversão para estratégias orientadas a cliques) ou métricas secundárias, como impressões e valor da conversão.

2. Parâmetros de solicitação simplificados

Fizemos as seguintes atualizações para simplificar as solicitações de estimativa, melhorar a confiabilidade do sistema e remover entradas que têm um efeito mínimo na precisão geral da estimativa:

• CampaignToForecast.geo_modifiers[] foi substituído por CampaignToForecast.geo_target_constants[].
• ForecastAdGroup.biddable_keywords[] foi substituído por ForecastAdGroup.keywords[].
• Os seguintes campos foram removidos:
  • CampaignToForecast.keyword_plan_network
  • CampaignToForecast.negative_keywords
  • ForecastAdGroup.max_cpc_bid_micros
  • ForecastAdGroup.negative_keywords
  • CriterionBidModifier

Cronograma

A transição segue nosso ciclo padrão de lançamento e desativação:

• Abril de 2026: a v24 da API Google Ads será disponibilizada com a funcionalidade GenerateKeywordForecastMetrics atualizada.
• Fevereiro de 2027: a v23 da API Google Ads será desativada. No momento, todas as versões da API Google Ads vão usar essa infraestrutura unificada de estimativa.

Próximas etapas

Os desenvolvedores que usam GenerateKeywordForecastMetrics precisam revisar as integrações para garantir a compatibilidade com o conjunto de parâmetros atualizado na v24. Consulte o guia "Gerar métricas de previsão" e a referência da v24 de GenerateKeywordForecastMetrics para saber mais sobre o uso.

Se tiver dúvidas sobre este aviso ou quiser conversar com nossa equipe e a comunidade, entre em contato pelo servidor do Discord da comunidade de anúncios e medição.

 - Laura Chevalier, equipe da API Google Ads

Marcadores: google-ads, google-ads-api, keyword-optimizer, keywords