Anúncio da v24 da API Google Ads

Quarta-feira, 22 de abril de 2026

Hoje, anunciamos o lançamento da v24 da API Google Ads. Para usar os novos recursos da v24, faça upgrade das bibliotecas de cliente e do código do cliente. Todas as bibliotecas de cliente e exemplos de código atualizados foram publicados.

Participe de uma apresentação ao vivo desta versão no nosso evento "Destaques da versão da API Google Ads" no Discord, no nosso YouTube Live para desenvolvedores do Google Ads ou no nosso evento do LinkedIn Live amanhã (23 de abril, às 10h, horário do leste dos EUA). O evento também será gravado e postado no YouTube para quem não puder participar ao vivo. Se você tiver dúvidas ou quiser discutir este post, entre em contato pelo canal #ads-api no Discord.

Novos recursos

Suporte para conversões com dados do carrinho: as conversões com dados do carrinho são uma extensão do rastreamento de conversões no seu site ou app. Com elas, você pode fornecer os detalhes dos produtos vendidos em cada transação, o que ajuda a acessar vendas avançadas, relatórios de lucro e insights para contas e campanhas do Google Ads, como quantidade de pedidos, média de itens no carrinho, receita e lucro bruto.

A API Google Ads v24 adiciona suporte para esse recurso da seguinte forma:

  • Adicionamos um novo recurso CartDataSalesView que permite segmentar as métricas de conversão não apenas pelo clique no produto, mas também pelo produto vendido, com segmentos como product_sold_brand. Com eles, os anunciantes podem ver estatísticas sobre os produtos que os clientes realmente compraram depois de clicar nos anúncios, mesmo que o anúncio fosse de um produto diferente.
  • Adicionamos várias métricas "all" que não recebem lances, que também incluem as conversões que suas campanhas não estão otimizando ativamente, por exemplo, all_cost_of_goods_sold_micros. As novas métricas são adicionadas a todos os recursos que aceitam métricas de lances correspondentes.
  • Adicionamos o segmento conversion_attribution_event_type ao recurso ShoppingPerformanceView, permitindo que ele seja selecionado com dados do carrinho e outras métricas de conversão. Esse segmento indica se a conversão é atribuída a um clique ou a uma visualização e é necessário para reconhecer as estatísticas de dados do carrinho produzidas por conversões de visualização.

Recursos atualizados

A versão v24 apresenta atualizações para recursos que exigem mudanças no código ao fazer upgrade. Abordamos as mais importantes aqui. Confira as notas da versão para ver a lista completa de mudanças.

Configurações de exclusão de conteúdo de vídeo em campanhas: simplificamos a definição de configurações de exclusão de conteúdo de vídeo em campanhas individuais. Essa configuração está disponível no nível do cliente e se aplica a todas as campanhas. Essas configurações de exclusão de conteúdo oferecem mais controle e ajudam a excluir tipos de conteúdo que, embora estejam em conformidade com nossas políticas, não são adequados à sua marca ou empresa. Acesse https://support.google.com/google-ads/answer/7515513 para saber mais sobre as configurações de exclusão de conteúdo de vídeo.

Mudanças em AudienceInsightsService: como parte de uma refatoração de código, movemos o campo de solicitação InsightsAudience.topic_audience_combinations para o namespace common. Talvez seja necessário atualizar as diretivas de importação em algumas linguagens de programação.

Mudanças no ReachPlanService: como parte de uma refatoração de código, movemos o campo youtube_select_lineups do serviço ReachPlanService.ListPlannableProducts. As escalações agora estão disponíveis no campo youtube_select_lineup_targeting. Os Lineups do YouTube Select são produtos de reserva para que os clientes qualificados segmentem canais que fazem parte do 1% mais acessado do YouTube com os públicos-alvo mais fiéis de um determinado mercado. Saiba mais.

Mudanças no ContentCreatorInsightsService: como parte de uma refatoração de código, removemos o campo is_brand_connect_creator dos serviços ContentCreatorInsightsService.GenerateCreatorInsights e ContentCreatorInsightsService.GenerateTrendingInsights.
Os usuários precisam procurar um criador para ter a opção CREATOR_PARTNERSHIPS disponível em partnership_opportunities. O pacote de produtos Parcerias com Criadores do YouTube no Google Ads é o local onde você pode encontrar criadores de conteúdo do YouTube para fazer parcerias relacionadas a conteúdo patrocinado e gerenciar suas parcerias de maneira eficiente. Saiba mais.

Mudanças no KeywordPlanIdeaService: para oferecer uma experiência mais simplificada e confiável, unificamos nossa infraestrutura de estimativa. 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. Vamos compartilhar uma postagem mais detalhada no blog sobre essa mudança nos próximos dias.

Mudanças no recurso campaign_budget: removemos o segmento ad_sub_network_type do recurso campaign_budget porque ele é incompatível com essa visualização.

Mudanças nas visualizações de recursos: removemos o segmento click_type das visualizações ad_group_asset, campaign_asset e customer_asset. Essa mudança está alinhada a uma alteração recente no produto que removeu esse segmento do Google Ads para evitar a deturpação de dados. Use a segmentação click_type do recurso ad_group_ad para ver detalhes sobre a performance do anúncio e o recurso com que ele foi veiculado.

Mudanças no anúncio responsivo em vídeo: VideoResponsiveAdInfo agora é mutável. Como parte dessa mudança, marcamos videos, business_name e logo_images como campos obrigatórios nos objetos DemandGenVideoResponsiveAdInfo e VideoResponsiveAdInfo.

Mudanças no ShareablePreviewService: atualizamos o ShareablePreviewService.GenerateShareablePreviews para não usar mais falhas parciais. As solicitações vão gerar um erro se falharem para qualquer ID. Saiba mais.

Estes recursos podem ajudar você a começar:

Para suporte técnico, entre em contato pelo link https://support.google.com/google-ads/contact/google_ads_api.

Retrato do autor - , equipe da API Google Ads

Marcadores: google-ads-api, release