Notas da versão

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 os controles de segmentação e criativos são veiculados quando definidos. A automação de recursos de texto e os controles de lista de marcas definidos em solicitações da versão anterior ainda serão respeitados até que a IA Max para campanhas de pesquisa seja ativada e desativada explicitamente. 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 termo de pesquisa quando uma campanha principal tiver ativado a IA Max para campanhas de pesquisa. Confira nosso post no blog Otimize a performance 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 ativar a IA Max para campanhas de pesquisa na campanha.

  • Adicionamos suporte para aplicar controles de segmentação no nível do grupo de anúncios na IA Max para campanhas de 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 uma visualização adicional com dados das campanhas Performance Max. Se você quiser evitar a migração da sua implementação para receber dados da 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 na publicidade política 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 no nível 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 publicidade 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 em 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 na publicidade política da UE também foram feitas nas versões v19.2 e v21.

Mudanças na publicidade política da UE

  • Adicionamos 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 no nível 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 declararem se contêm publicidade 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 você pode atualizar o campo google_ads_conversion_customer em um cliente atual para ativar o acompanhamento de conversões de várias contas ou mudar a conta mãe de acompanhamento de conversões para outra conta de administrador.

  • Adicionamos o campo ClickConversion.user_ip_address. O Google Ads não oferece suporte à correspondência de endereços IP para usuários finais no Espaço Econômico Europeu (EEE), no Reino Unido (RU) ou na Suíça (CH). Adicione uma 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 coletados nos seus sites, apps e outras propriedades e peça consentimento quando exigido por lei ou pelas políticas do Google aplicáveis. Confira mais detalhes na página Sobre a importação de conversões off-line.

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

Vídeos

  • Adicionamos 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 aparecem diretamente ao lado do frame estático do vídeo 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.

v19.2 (06/08/2025)

Essas mudanças na publicidade política da UE também foram feitas nas versões v20.1 e v21.

Mudanças na publicidade política da UE

  • Adicionamos 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 no nível 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. Aguarde o anúncio dessa mudança.

  • Os testes e experimentos vão gerar um ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se as campanhas do experimento não declararem se contêm publicidade política segmentada para a União Europeia.

v19.1 (16/04/2025)

Os seguintes recursos e mudanças foram adicionados na v19.1.

Recursos

Campanhas

Geração de demanda

Histórico de alterações

  • Adição de suporte a mais três tipos de recursos em ChangeStatusResourceType:
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • É possível recuperar esses três tipos mais refinados no relatório change_status.

Conversões

  • Agora é possível definir o campo google_ads_conversion_customer ao criar um novo cliente usando a API Google Ads. Antes, esse era um campo somente leitura.

    OBSERVAÇÃO:esse recurso está disponível apenas para uma lista de permissões fechada. Para usar, entre em contato com seu gerente de contas.

  • Agora é possível especificar o tipo de cliente associado à conversão ao fazer upload de conversões off-line.

  • Um novo campo session_attributes foi introduzido para ClickConversion.

Anúncios dos Serviços Locais

Serviços de planejamento

  • Adição de suporte para previsões mensais de frequência desejada em ReachPlanService.GenerateReachForecast.
  • Adicionamos um novo método ReachPlanService.GenerateConversionRates, que permite aos anunciantes solicitar taxas de conversão sugeridas para produtos planejáveis compatíveis.
  • Previsão da Geração de demanda em ReachPlanService.GenerateReachForecast:
    • Agora os desenvolvedores podem solicitar previsões de alcance para campanhas Geração de demanda. Os desenvolvedores podem usar o novo código de produto planejável DEMAND_GEN_MAX_CONVERSIONS para gerar previsões de alcance da Geração de demanda.
    • Adição de um novo campo conversion_rate que permite aos desenvolvedores que solicitam previsões de alcance da Geração de demanda fornecer uma taxa de conversão. As taxas de conversão sugeridas podem ser recuperadas usando o novo método ReachPlanService.GenerateConversionRates. Esse campo é obrigatório para solicitações de previsão de Geração de demanda. Ele não é compatível com outros produtos planejáveis.
    • Adição de um novo campo conversions às previsões retornadas. Esse campo contém o número de conversões em um determinado ponto na curva de alcance. As conversões são compatíveis apenas com o produto planejável DEMAND_GEN_MAX_CONVERSIONS.

Recomendações

Vídeos

  • Adicionamos suporte somente leitura para anúncios em áudio. Acesse a Central de Ajuda do Google Ads para saber mais sobre esse recurso. Essa mudança expõe:
  • Adicionamos novas métricas e segmentos às métricas de alcance da consulta com ajuste de demonstração. Como parte dessas mudanças,
    • Duas novas colunas de métricas chamadas coviewed_impressions e primary_impressions foram introduzidas.
    • Dois novos segmentos chamados adjusted_age_range e adjusted_gender foram introduzidos.
    • Se um dos dois novos segmentos for selecionado com um campo de métrica de alcance (coviewed_impressions, primary_impressions, unique_users ou average_impression_frequency_per_user), o outro segmento também precisará ser selecionado para recuperar estatísticas válidas para essas colunas.
    • No momento, esse recurso está disponível apenas para clientes na lista de permissões.

v19 (26/02/2025)

Os seguintes recursos e mudanças foram adicionados na v19.

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

Gerenciamento de conta

  • Adicionamos os seguintes valores a CustomerError para considerar as próximas mudanças:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Anúncios

Recursos

Conversões

Feeds

  • Removemos todas as entidades relacionadas a feeds, como Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view etc. Agora, os usuários precisam usar assets para alcançar o mesmo objetivo.

Hotel e viagem

Performance Max

Planejamento

Vídeos

Notas de lançamento arquivadas

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