Notas da versão

v23 (28/01/2026)

Os seguintes novos recursos e atualizações foram adicionados na v23.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Anúncios

  • Adicionamos AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Esse erro é retornado ao tentar compartilhar um anúncio entre vários grupos de anúncios, o que não é mais permitido.
  • Adicionamos novos tipos de formato ao AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK e VERTICAL_ADS_PROMOTION.
  • A compatibilidade com CallAd e CallAdInfo foi removida na v23. Consulte https://support.google.com/google-ads/answer/6341403 para saber mais.

Recursos

Faturamento

Campanhas

Conversões

  • Adicionamos YOUTUBE_FOLLOW_ON_VIEWS a ConversionActionCategory para oferecer suporte ao rastreamento de usuários que assistem um anúncio e depois um vídeo do mesmo canal.

Geração de demanda

Incentivos

  • Adicionamos suporte aos incentivos Escolha sua própria (CYO, na sigla em inglês), permitindo que os parceiros busquem e apliquem de forma programática os incentivos do Google Ads para os clientes:

    • Adicionado IncentiveService:
      • O método FetchIncentive permite buscar incentivos disponíveis para um usuário com base no país, no idioma e, opcionalmente, no e-mail dele. Isso pode retornar opções de incentivo personalizadas do tipo "Escolha a sua" (CYO, na sigla em inglês).
      • O método ApplyIncentive permite aplicar um incentivo selecionado pelo usuário a uma conta de cliente específica do Google Ads.
    • Adicionamos o recurso somente leitura AppliedIncentive, que pode ser consultado usando GoogleAdsService.Search e GoogleAdsService.SearchStream. Ele fornece detalhes sobre os incentivos resgatados, incluindo status, progresso do cumprimento, valores das recompensas e datas relevantes.
    • Adicionamos novos códigos de erro em IncentiveErrorEnum para lidar com problemas relacionados à busca ou aplicação de incentivos.
    • Adicionamos INVALID_EMAIL_ADDRESS a AuthenticationErrorEnum.

  • Para facilitar o tratamento programático mais granular de falhas, vamos adicionar códigos de erro extras a IncentivesService em versões futuras. Recomendamos que você monitore os próximos anúncios e notas de lançamento desses novos códigos de erro para garantir que seus aplicativos possam gerenciar esses novos modos de falha.

Planejamento

Recomendações

  • Adicionamos o campo is_new_customer a GenerateRecommendationsRequest. Quando definido como true para recomendações do tipo CAMPAIGN_BUDGET, ele gera recomendações usando um modelo para novos clientes. Isso é recomendado apenas para clientes sem campanhas.

Relatórios

Shopping

  • Agora, o ShoppingPerformanceView oferece suporte às seguintes métricas segmentadas por data de conversão: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date e value_per_all_conversions_by_conversion_date.
  • O ShoppingPerformanceView agora é compatível com as seguintes métricas competitivas: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Adicionamos product_image_uri a ShoppingProduct.

Anúncios verticais

  • Adicionamos o vertical_ads_format_setting a AdGroup para campanhas de pesquisa que usam feeds de viagem, permitindo o controle sobre quais formatos de anúncio podem ser veiculados.
  • Adição do tipo de critério vertical_ads_item_group_rule_list a AdGroupCriterion. Adição de vertical_ads_item_group_rule a SharedCriterion. Esses critérios permitem segmentar grupos de itens em campanhas de pesquisa com feeds de viagem.
  • Agora você pode conectar um feed de dados de anúncios verticais a uma campanha de pesquisa que está veiculando a IA Max para mostrar anúncios de promoção de propriedade e de viagem com links para reserva ao lado dos seus anúncios de texto. No nível do grupo de anúncios, você pode controlar quais formatos mostrar com a vertical_ads_format_setting e definir um conjunto de regras de grupo de itens para segmentar um subconjunto das suas entidades do feed de dados de anúncios verticais. Além disso, os relatórios agora podem ser segmentados por AdFormatType e dimensões do feed de dados de anúncios verticais.

Vídeo

v22 (15 de outubro de 2025)

Os seguintes novos recursos e atualizações foram adicionados na v22.

Recursos

  • Adicionamos LANDING_PAGE_PREVIEW como um novo tipo de campo de recurso de imagem.
  • Lançamento do AssetGenerationService (Beta):
    • Esse serviço permite gerar recursos de texto e imagem usando IA generativa. Inicialmente, esse serviço está disponível apenas para um grupo limitado de participantes do beta fechado.
    • GenerateText: gera texto com base em entradas como URL final, comandos livres, palavras-chave e contexto da campanha atual.
    • GenerateImages: gera imagens com base em entradas como URL final, comandos livres, contexto da campanha atual ou recontextualização de imagens de produtos atuais.
    • Os erros durante a geração de recursos são retornados com códigos de AssetGenerationErrorEnum.

Campanhas

Geração de demanda

Geral

  • Adicionamos um limite de 10.000 operações por solicitação de AddBatchJobOperations.
  • Atualização no processamento do campo page_size em ListBatchJobResultsRequest:
    • Se page_size não estiver definido ou for 0, o padrão será o máximo de 1.000 (antes retornava INVALID_PAGE_SIZE).
    • Se page_size exceder 1.000, a API vai retornar um erro INVALID_PAGE_SIZE (antes, o limite era de 1.000).
  • Adicionamos um novo código de erro: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED para indicar quando o limite de taxas de ativação do perfil para pagamentos foi excedido.

Performance Max

  • Adicionamos novos valores de AssetAutomationType para campanhas Performance Max:
    • GENERATE_IMAGE_ENHANCEMENT: permite a criação automática de imagens aprimoradas, como o corte automático. Ativado por padrão.
    • GENERATE_IMAGE_EXTRACTION: permite a origem automática de imagens de URLs finais. O padrão é a configuração de extensão de imagem dinâmica no nível da conta.
  • Removemos AssetPerformanceLabel das campanhas Performance Max.
  • A funcionalidade do Campaign.url_expansion_opt_out removido agora é gerenciada definindo o AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION em AssetAutomationSetting.
  • Adicionamos novos segmentos para campanhas Performance Max. Cada um desses segmentos está disponível apenas para campanhas Performance Max e não retorna dados quando qualquer outro tipo de campanha é selecionado.

Planejamento

Relatórios

Metas unificadas

  • Agora é possível usar metas de retenção de clientes para otimizar o reengajamento de clientes atuais.

Vídeo

v21 (06/08/2025)

Consulte Fazer upgrade para a versão mais recente para receber orientações.

AI Max para campanhas de pesquisa

  • Agora você pode usar o campo ai_max_setting.enable_ai_max do Campaign para ativar a IA Max para campanhas de pesquisa. A IA Max para campanhas de pesquisa aumenta o alcance de uma campanha de pesquisa usando a correspondência de termo de pesquisa e permite controlar se a segmentação e os controles de criativo são veiculados quando definidos. A automação de recursos de texto e os controles de lista de marcas definidos em solicitações de versões anteriores ainda serão respeitados até que a IA Max para campanhas de pesquisa seja ativada e desativada explicitamente. O Campaign.ai_max_setting.bundling_required pode ser usado para determinar se a IA Max para campanhas de pesquisa precisa ser ativada para respeitar ou modificar a automação de recursos de texto e os controles de lista de marcas. AdGroup.ai_max_ad_group_setting.disable_search_term_matching pode ser usado para desativar a correspondência de termos de pesquisa quando uma campanha principal tiver ativado a IA Max para campanhas de pesquisa. Confira nosso post no blog Leve sua performance para outro nível com a IA Max para campanhas de pesquisa.

  • Adicionamos CampaignError.AI_MAX_MUST_BE_ENABLED, que é gerado para campanhas de pesquisa quando você ativa FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION sem habilitar a IA Max para campanhas de pesquisa na campanha.

  • Agora é possível aplicar controles de segmentação no nível do grupo de anúncios nas campanhas IA Max para pesquisa. Agora você pode adicionar os seguintes critérios aos grupos de anúncios:

    • Listas de marcas
    • Locais
    • Páginas da Web (regras de URL)

  • Adicionamos o ai_max_search_term_ad_combination_view para gerar relatórios sobre a performance de combinações de termos de pesquisa, títulos e páginas de destino. Essa visualização mostra quais consultas de pesquisa acionaram seus anúncios e como essas combinações específicas performaram. Uma versão futura vai incluir outra visualização com dados de Performance Max. Se você quiser evitar a migração da sua implementação para receber dados de Performance Max, aguarde esse lançamento.

  • Adicionamos AI_MAX como um novo valor para o segmento search_term_match_type.

Recursos

Campanhas

Conversões

Geração de demanda

Mudanças na publicidade política da UE

Essas mudanças nos anúncios políticos da UE também foram feitas nas versões v19.2 e v20.1.

  • Adicionado Campaign.contains_eu_political_advertising. Esse campo indica se a campanha tem conteúdo de publicidade política segmentado para a União Europeia. Se este campo for definido como CONTAINS_EU_POLITICAL_ADVERTISING, a campanha não será mais veiculada na UE a partir de 22 de setembro de 2025. As chamadas de API para criar uma campanha vão falhar com um erro FieldError.REQUIRED se esse campo não for definido.

    Para campanhas atuais, defina o campo contains_eu_political_advertising antes de tentar mudar a segmentação por proximidade, local ou grupo de locais nos níveis da campanha ou do grupo de anúncios. As chamadas de API para criar ou atualizar esses critérios de campanha ou grupo de anúncios para campanhas atuais vão falhar com um erro CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se a campanha não tiver concluído a autodeclaração.

    Para as versões v19.x e 20.x, a exigência de definir esse campo ainda não é aplicada, mas será no futuro. Essa mudança será anunciada com antecedência.

  • Os testes e experimentos vão gerar um ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se as campanhas do experimento não tiverem declarado por conta própria se contêm propaganda política segmentada para a União Europeia.

Performance Max

  • Para novas campanhas PMax, o valor padrão de Campaign.brand_guidelines_enabled agora é true.

  • Adição do relatório campaign_search_term_view. Essa visualização oferece métricas de termos de pesquisa agregadas no nível da campanha. Essa visualização também apresenta suporte para campanhas Performance Max e termos de pesquisa.

  • Adicionamos PERFORMANCE_MAX como um novo valor para o segmento search_term_match_type.

Planejamento

Relatórios

Vídeo

v20.1 (06/08/2025)

Essas mudanças nos anúncios políticos da UE também foram feitas nas versões v19.2 e v21.

Mudanças na publicidade política da UE

  • Adicionado Campaign.contains_eu_political_advertising. Esse campo indica se a campanha tem conteúdo de publicidade política segmentado para a União Europeia. Se este campo for definido como CONTAINS_EU_POLITICAL_ADVERTISING, a campanha não será mais veiculada na UE a partir de 22 de setembro de 2025.

    Para campanhas atuais, defina o campo contains_eu_political_advertising antes de tentar mudar a segmentação por proximidade, local ou grupo de locais nos níveis da campanha ou do grupo de anúncios. As chamadas de API para criar ou atualizar esses critérios de campanha ou grupo de anúncios para campanhas atuais vão falhar com um erro CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se a campanha não tiver concluído a autodeclaração.

    Para as versões v19.x e 20.x, a exigência de definir esse campo ainda não é aplicada, mas será no futuro. Essa mudança será anunciada com antecedência.

  • Os testes e experimentos vão gerar um ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se as campanhas do experimento não tiverem declarado por conta própria se contêm propaganda política segmentada para a União Europeia.

v20 (04/06/2025)

Os seguintes novos recursos e atualizações foram adicionados na v20.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Recursos

Adicionamos várias métricas e colunas de segmento novas ao relatório asset_group.

Colunas de métricas

Colunas de segmento

Campanhas

Conversões

  • Agora é possível atualizar o campo google_ads_conversion_customer em um cliente atual para ativar o acompanhamento de conversões de várias contas ou mudar o proprietário do acompanhamento de conversões para outra conta de administrador.

  • Adicionamos o campo ClickConversion.user_ip_address. O Google Ads não é compatível com correspondência de endereços IP para usuários finais no Espaço Econômico Europeu (EEE), no Reino Unido ou na Suíça. Adicione lógica para excluir condicionalmente o compartilhamento de endereços IP de usuários dessas regiões. Forneça aos usuários informações claras e abrangentes sobre os dados que você coleta nos seus sites, apps e outras propriedades e peça consentimento quando exigido por lei ou pelas políticas do Google aplicáveis. Consulte a página Sobre as importações de conversões off-line para mais detalhes.

Geração de demanda

Recomendações

  • Adicionamos suporte a ShoppingSetting durante a criação de campanhas ao usar GenerateRecommendationsRequest.
    • Adicionamos o campo merchant_center_account_id a GenerateRecommendationsRequest para indicar quando as recomendações devem ser geradas para varejo, em vez das campanhas Performance Max padrão.

Planejamento

  • Adicionamos AudienceInsightsDimension.YOUTUBE_LINEUP para substituir AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP em AudienceInsightsService e ContentCreatorInsightsService. Com essa nova dimensão, é possível recuperar insights e metadados dos Lineups do YouTube Select (YTS). Substituímos objetos associados a YOUTUBE_DYNAMIC_LINEUP, como DynamicLineupAttributeMetadata e o AudienceInsightsDynamicLineup, para se alinhar à remoção mais ampla das carteiras dinâmicas no Google Ads. Esse recurso está disponível apenas para contas em uma lista de permissão.
  • Adição de AdditionalApplicationInfo e ApplicationInstance em AudienceInsightsService, ContentCreatorInsightsService e ReachPlanService. Esse recurso está disponível apenas para contas em uma lista de permissão.
  • Atualizamos AudienceInsightsService e ContentCreatorInsightsService para fornecer insights mais detalhados. Agora é possível segmentar os dados dos criadores de conteúdo por dispositivo usando os novos AudienceInsightsDimension.DEVICE e AudienceInsightsAttribute.device nos dois serviços. Esse recurso está disponível apenas para contas em uma lista de permissões.
  • Adicionamos mais métricas de vídeo agregadas a GenerateCreatorInsightsResponse para uma análise mais abrangente dos criadores de conteúdo: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count e is_brand_connect_creator. Esse recurso está disponível apenas para contas em uma lista de permissões.
  • Adição de sub_country_locations a GenerateCreatorInsightsRequest para o ContentCreatorInsightsService. Isso permite especificar locais geográficos subnacionais para refinar as pesquisas de insights do criador de conteúdo. O campo sub_country_locations só é compatível quando você usa o search_attributes oneof no campo criteria. Se sub_country_locations forem fornecidos com outros tipos de critérios, a solicitação será inválida. Isso permite uma segmentação geográfica e uma análise mais detalhadas para insights de criadores de conteúdo. Esse recurso está disponível apenas para contas em uma lista de permissões.
  • Adicionamos ReachPlanService.ListPlannableUserLists, que retorna listas de usuários próprios de um cliente, e UserListInfo às opções de segmentação por público-alvo em GenerateReachForecastRequest. Isso permite recuperar listas de usuários planejáveis para um determinado cliente e gerar previsões de alcance para campanhas que segmentam esses públicos-alvo específicos. Essas melhorias incorporam seus dados de público-alvo próprios diretamente na previsão, melhorando o planejamento de alcance personalizado. A previsão de alcance está disponível apenas para contas na lista de permissão.

Vídeos

  • Adicionamos os anúncios AdFormatType.PAUSE veiculados em vídeos orgânicos do YouTube em telas de TV, que estão incluídos nos relatórios. Eles são exibidos diretamente ao lado do frame de vídeo estático na tela de pausa. Isso não inclui anúncios em vídeo Geração de demanda exibidos no painel de anúncios abaixo ou acima de um vídeo orgânico pausado, que são informados em AdFormatType.INFEED.

Notas de lançamento arquivadas

Consulte Versões descontinuadas para acessar as notas da versão arquivadas.