Notas da versão

v22 (15 de outubro de 2025)

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

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

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 de formato livre, palavras-chave e contexto da campanha atual.
  • GenerateImages: Gera imagens com base em entradas como URL final, comandos livres, contexto da campanha atual ou recontextualizando imagens de produtos existentes.
  • Os erros durante a geração de recursos são retornados com códigos de AssetGenerationErrorEnum.

Campanhas

• Adicionamos novas metas de lances para campanhas para apps para instalações (ACi) que otimizam sem especificar uma meta. Isso é útil para escalonamento rápido ou quando é difícil determinar a meta certa. Em AppCampaignBiddingStrategyGoalType:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Use com a estratégia padrão Maximizar conversões.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Use com a estratégia padrão Maximizar o valor da conversão.
• Adicionamos suporte ao tipo de estratégia de lances de parcela de voz fixa.
• Adicionamos Campaign.feed_types, mostrando os tipos de feeds anexados a uma campanha. Para campanhas Performance Max, isso pode indicar a categoria de negócios, como MERCHANT_CENTER_FEED para varejo.
• É permitido anexar NEGATIVE_KEYWORDS conjuntos compartilhados a MULTI_CHANNEL (para campanhas para apps) e LOCAL campanhas.

Geração de demanda

• Adicionamos a estratégia de lances de CPC desejado para campanhas Geração de demanda. Essa estratégia define lances para maximizar os cliques com o custo por clique (CPC) desejado configurado.
  • Defina o CPC desejado no nível da campanha usando Campaign.target_cpc.
  • Substitua no nível do grupo de anúncios usando AdGroup.target_cpc_micros.
• Adição de um novo AssetAutomationType:
  • GENERATE_DESIGN_VERSIONS_FOR_IMAGES: disponível para DemandGenMultiAssetAds. Se ativada, essa opção adiciona elementos de design e incorpora recursos de texto aos recursos de imagem para criar novos recursos com proporções diferentes. Os novos DemandGenMultiAssetAds são ativados por padrão.
• Adição de um novo AssetAutomationType:
  • GENERATE_VIDEOS_FROM_OTHER_ASSETS: disponível para DemandGenMultiAssetAds. Se ativada, ela gera vídeos usando outros recursos, como imagens e texto. Esses vídeos podem ser usados para criar novos DemandGenVideoResponsiveAds. Os novos DemandGenMultiAssetAds são ativados por padrão.
• O campo BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros foi renomeado como minimum_budget_amount_micros.

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 sem aviso).
• 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 dos 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.
  • ad_using_product_data: indica se um anúncio usa dados de produtos de um feed do Google Merchant Center.
  • ad_using_video: indica se um anúncio usa um recurso de vídeo.

Planejamento

• Em UserListCrmDataSourceType, adicionamos o valor THIRD_PARTY_PARTNER_DATA.
• Adição de novos códigos de erro relacionados a públicos-alvo de parceiros:
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• O is_active_live_stream_creator foi adicionado a YouTubeMetrics. Retornado por ContentCreatorInsightsService.GenerateCreatorInsights e indica se um criador de conteúdo publicou uma transmissão ao vivo nos últimos 90 dias.

• Adicionamos uma nova mensagem PlannableUserListMetadata que contém UserListCrmDataSourceType em PlannableUserList. Essa mensagem é retornada por "ReachPlanService.ListPlannableUserLists" para mostrar se uma origem de dados de lista de usuários do CRM é FIRST_PARTY ou THIRD_PARTY_PARTNER_DATA.

• Em ReachPlanService, adicionamos o campo trueview_views, que substitui o campo views.

• Em TrendInsight, adicionamos suporte para related_videos e related_creators. Também adicionamos metadados de propriedades de vídeo e datas de publicação em YouTubeVideoAttributeMetadata.video_properties e YouTubeVideoAttributeMetadata.publish_date.

• AudienceInsightsService.GenerateInsightsFinderReport agora é compatível com parental_status e income_ranges, além de combinações AND/OR mais complexas de temas e públicos-alvo.

Relatórios

• Dois novos tipos de clique foram adicionados: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK e CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
• Agora, AssetGroupAsset pode ser segmentado por device, conversion_action, conversion_action_name, e conversion_action_category.
• O AdGroupAdAssetView e o AdGroupAdAssetCombinationView agora oferecem suporte total às métricas de performance e conversão para RESPONSIVE_SEARCH_AD. Antes, apenas as impressões eram retornadas para esse tipo de anúncio nessas visualizações.
• Para facilitar a análise detalhada da Otimização dos Lances Inteligentes, as seguintes métricas agora podem ser segmentadas por campos de data (date, month, quarter, week, year):
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• Adicionamos um novo recurso: TargetingExpansionView, que informa métricas de expansões na segmentação manual, como a expansão sem palavras-chave da IA Max para campanhas de pesquisa.

• Adicionamos novos segmentos para campanhas PMax. Consulte Atualizações das campanhas Performance Max.

  Shopping

• Corrigimos o escopo de campanha e grupo de anúncios das métricas no recurso ShoppingProduct.

Metas unificadas

• Adicionamos suporte para metas de retenção de clientes, otimizando o reengajamento de clientes atuais.
  • Configure a segmentação usando CampaignRetentionGoalSettings.target_option:
    • TARGET_SPECIFIC: Usa apenas usuários de listas associadas à campanha. No momento, só é possível usar uma lista de permissões.
    • TARGET_ALL (Padrão): segmenta todos os usuários para retomada de engajamento.

Vídeo

• Renomeamos várias métricas relacionadas a visualizações de vídeo:
  • average_cpv agora é trueview_average_cpv
  • video_view_rate agora é video_trueview_view_rate
  • video_views agora é video_trueview_views
  • video_view_rate_in_feed agora é video_trueview_view_rate_in_feed
  • video_view_rate_in_stream agora é video_trueview_view_rate_in_stream
  • video_view_rate_shorts agora é video_trueview_view_rate_shorts
• Adicionamos métricas para o tempo de exibição de anúncios em vídeo:
  • video_watch_time_duration_millis: Tempo total de exibição.
  • average_video_watch_time_duration_millis: tempo médio de exibição por impressã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 o desempenho dessas combinações específicas. Uma versão futura vai incluir uma visualização adicional com dados das campanhas Performance Max. Se você quiser evitar migrar 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

• Adição dos campos terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info e promotion_qr_code_info em PromotionAsset. Os campos de código de barras e QR code estão localizados no promotion_trigger oneof. Consulte o artigo da Central de Ajuda Sobre os recursos de promoção.

• Adicionamos FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION a AssetAutomationTypeEnum. Com essa configuração, você controla a geração automática de recursos de texto e páginas de destino do URL final nas campanhas de pesquisa.

• Adicionamos um novo serviço AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset para remover recursos criados automaticamente de Campaign. Esse serviço aceita apenas a remoção do recurso de expansão de URL final.

• Adição de DESCRIPTION_PREFIX à enumeração ServedAssetFieldType. Isso corrige um problema em que o served_asset_field_type em ad_group_ad_asset_combination_view era UNKNOWN para recursos que serviam como um prefixo de descrição.

Campanhas

• Adicionamos um novo valor de enumeração MISSING_LOCATION_TARGETING a CampaignPrimaryStatusReason. Esse novo motivo de status será retornado apenas para campanhas restritas por local que não especificam a segmentação por local. Para campanhas com restrição de local, qualquer tentativa de adicionar uma segmentação por local fora da área permitida vai resultar no erro de critério LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.

• Adicionamos suporte para parceiros de integração de terceiros nos níveis VideoCustomer.third_party_integration_partners e Campaign.third_party_integration_partners. Consulte o artigo da Central de Ajuda Acompanhar conversões de apps com a análise de aplicativos de terceiros.

• Agora é possível definir o campo advertising_partner_ids para um Campaign atual. Antes, esse campo só podia ser definido para uma nova campanha durante a criação dela. O campo ainda é imutável depois de definido.

• Ao usar uma lista compartilhada do tipo TYPE_PLACEMENT_LIST definida no nível da conta de administrador, os anunciantes agora podem usar os critérios CustomerNegativeCriterion para excluir uma lista de canais em contas de cliente de anunciantes individuais.

• Adição de DESCRIPTION_PREFIX à enumeração ServedAssetFieldType. Isso corrige um problema em que o served_asset_field_type no ad_group_ad_asset_combination_view era UNKNOWN para recursos que serviam como um prefixo de descrição.

• Adição de suporte para o campo target_roas_tolerance_percent_millis nas estratégias de lances MaximizeConversionValue e TargetRoas. TargetRoas.target_roas_tolerance_percent_millis está disponível apenas para estratégias de portfólio, que só podem ser usadas em campanhas de pesquisa.

• Mudança em um código de erro ProductGroup. Para solicitações com uma falha parcial ativada, LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION será retornado em vez de INVALID_LISTING_GROUP_HIERARCHY.

• Adicionamos um novo recurso LocationInterestView que resume a performance dos critérios de interesse por local do grupo de anúncios.

Conversões

• Adicionamos ENGAGED_VIEW como um novo valor para o segmento conversion_attribution_event_type.

• Os clientes não terão mais acesso ao modo debug_enabled no ConversionUploadService. Esse campo, se definido como TRUE, era usado anteriormente para distinguir o erro CLICK_NOT_FOUND de SUCCESS para importações de conversões otimizadas para leads.

Geração de demanda

• Adição de um código de erro CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. No futuro, esse erro será retornado ao tentar definir um valor de orçamento muito baixo para uma campanha Geração de demanda. Os detalhes sobre o orçamento mínimo necessário podem ser encontrados no novo campo de detalhes do erro budgetDailyMinimumErrorDetails.

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 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 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

• Adicionamos um novo método ReachPlanService.ListPlannableUserInterests, que permite aos anunciantes descobrir os interesses do usuário (afinidades e no mercado) compatíveis com ReachPlanService.GenerateReachForecast. O método permite pesquisar tipos específicos de interesse do usuário e consultar nomes e caminhos.

• Adicionamos AdditionalApplicationInfo a ReachPlanService.ListPlannableUserLists como um campo de entrada opcional.

• Adicionamos suporte a AudienceInsightsService.ListAudienceInsightsAttributes para buscar as listas de usuários próprios disponíveis para o ID do cliente que faz a solicitação.

• Adicionamos suporte para listas de usuários próprios ao AudienceInsightsService.GenerateAudienceCompositionInsights para buscar insights de públicos-alvo que segmentam uma lista de usuários. Qualquer solicitação que tenha como destino uma lista de usuários vai retornar apenas o índice de público-alvo e estará disponível apenas para os seguintes AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.

• Atualizamos o tipo de entrada de público-alvo para InsightsAudience em AudienceInsightsService.GenerateTargetingSuggestionMetrics. A nova entrada de público-alvo permite uma combinação AND-of-ORs de interesses do usuário, oferecendo suporte a métricas de alcance potencial para definições de público-alvo mais personalizadas.

• Adicionamos a parcela de público-alvo a TrendInsightMetrics para mostrar a parcela de um público-alvo em uma tendência.

• Adicionamos novas categorias relacionadas a KnowledgeGraphAttributeMetadata para que os usuários possam filtrar os atributos do Knowledge Graph por categoria.

Relatórios

• Agora há várias métricas novas disponíveis para AssetGroupAsset, ChannelAggregateAssetView e CampaignAggregateAssetView. Além disso, para ChannelAggregateAssetView e CampaignAggregateAssetView, impressions, que antes era zerado para campanhas Performance Max, agora vai informar o valor real.

• Tornamos o recurso AssetSet selecionável com ChangeStatus para que os usuários possam receber mais informações sobre o recurso do tipo AssetSet ou CampaignAssetSet em uma consulta.

• Tornamos o recurso CampaignAssetSet selecionável com ChangeStatus para que os usuários possam receber mais informações sobre o recurso do tipo AssetSet ou CampaignAssetSet em uma consulta.

• Adicionamos um novo segmento search_term_targeting_status que pode ser selecionado na visualização de termos de pesquisa da campanha.

• Foi adicionado um novo final_url_expansion_asset_view.

• Adição de suporte para as métricas value_adjustment e all_value_adjustment no relatório AssetGroup.

• Feito AssetGroupAsset segmentável por ad_network_type.

• Adicionamos um novo segmento landing_page_source que pode ser usado com o recurso landing_page_view.

• Adicionamos um novo segmento search_term_match_source que pode ser selecionado nas visualizações de termo de pesquisa e termo de pesquisa da campanha.

• Adicionamos um novo segmento match_type que pode ser selecionado na visualização de palavra-chave.

• Adição de suporte para métricas de clusters de intenção de consulta única com:

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• Adicionamos um novo tipo de clique VEHICLE_ASSETS na segmentação click_view para rastrear e gerar relatórios de cliques relacionados aos formatos de anúncio específicos dos recursos de veículo.

Análise detalhada de Lances Inteligentes para estratégias de lances de ROAS desejado na pesquisa

• Agora é possível ativar a Otimização dos Lances Inteligentes em campanhas de pesquisa definindo o campo target_roas_tolerance_percent_millis nas estratégias de lances MaximizeConversionValue e TargetRoas com qualquer valor divisível por 1.000 entre 10.000 (10%) e 30.000 (30%), inclusive. As estratégias de lances MaximizeConversionValue também precisam ter o campo target_roas definido. TargetRoas.target_roas_tolerance_percent_millis está disponível apenas para estratégias de portfólio. Confira nossa postagem do blog sobre a Análise detalhada de lances inteligentes e o artigo da Central de Ajuda.

• Agora, os relatórios de diversidade agregados são compatíveis com as seguintes métricas para clusters de intenção de consulta únicos. Uma visualização segmentada por tempo está disponível na interface do Google Ads.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

Vídeo

• Adicionado YouTubeVideoListAsset. Também foi adicionado o Asset#youtube_video_list_asset, que pode ser usado para criar um link entre um campaign e um tipo YouTubeVideoListAsset. Consulte o artigo da Central de Ajuda Usar vídeos relacionados.

• Adição de novos campos de metadados a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.

• Novos tipos de cliques expostos: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK e PRODUCT_ASSETS.

• Adicionamos o campo allow_non_skippable_in_stream a VideoAdInventoryControl para que os anúncios responsivos em vídeo sejam veiculados como anúncios in-stream não puláveis. Essa opção está disponível para campanhas que permitem misturar o formato não pulável com outros formatos.

• Adição dos campos Campaign.VideoCampaignSettings.video_ad_sequence e AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting (somente leitura). Consulte o artigo da Central de Ajuda Sobre o sequenciamento de anúncios em vídeo.

• Adição de novos campos de metadados a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.

• Adição do tipo de critério VIDEO_LINEUP e do campo video_lineup a CampaignCriterion e AdGroupCriterion. Esse recurso está disponível apenas para contas na lista de permissão. Entre em contato com seu representante de desenvolvimento de negócios do Google para mais detalhes.

• Adição de um relatório de adequação do conteúdo nos níveis de detalhe e grupo. Consulte o artigo da Central de Ajuda Sobre o relatório "Adequação do conteúdo".

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

• 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 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

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• 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
• value_per_all_conversions_by_conversion_date

Colunas de segmento

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

Campanhas

• Incluímos compatibilidade para adicionar e atualizar palavras-chave negativas no nível da campanha para campanhas Performance Max.

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.

  Observação: esse recurso está em uma lista de permissões fechada. Para usar, entre em contato com seu gerente de contas.

• 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

• Adicionamos novos valores ao segmento ad_network_type, que permite segmentar campanhas Geração de demanda por canal:
  • MAPS
  • GMAIL
  • DISCOVER
• Adicionamos métricas para conversões comparáveis entre plataformas:
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
  • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

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

• Adição de 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 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ões.
• 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ão.
• 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ão.
• 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 o search_attributes oneof é usado 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 do criador de conteúdo. Esse recurso está disponível apenas para contas em uma lista de permissão.
• 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. Assim, é possível 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 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

• 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. 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

• Adicionamos um campo asset_coverage para AssetGroup que retorna informações sobre lacunas no seu grupo de recursos.
  • Contém um subcampo ad_strength_action_items que retorna uma lista de ações que um anunciante pode realizar para melhorar a qualidade do anúncio de um grupo de recursos.

Campanhas

• Agora você pode classificar ou enviar feedback sobre leads nas Campanhas de Serviços Locais. Como parte dessa mudança, a v19.1
  • Adicionamos um novo serviço chamado LocalServicesLeadService. Você pode usar o método ProvideLeadFeedback para fazer upload de classificações e feedback de leads.
  • Adicionamos um novo campo chamado lead_feedback_submitted a LocalServicesLead para ajudar a determinar se o feedback foi enviado a um lead.
• Adicionamos uma nova coluna de métrica biddable_cohort_app_post_install_conversions para campanhas para apps.

Geração de demanda

• Outros métodos foram introduzidos nos serviços de planejamento para oferecer suporte à Geração de demanda.

• Adicionamos suporte aos controles de canais no nível do grupo de anúncios para campanhas Geração de demanda. É possível selecionar um agrupamento geral predefinido de canais ou um subconjunto de canais usando o campo demand_gen_ad_group_settings. Os seguintes canais são compatíveis na versão atual:

  • In-stream do YouTube
  • In-feed no YouTube
  • YouTube Shorts
  • Discover
  • Gmail
  • Display

• Expusemos um novo tipo de recurso para TALL_PORTRAIT_MARKETING_IMAGE. Esse tipo de recurso está relacionado ao campo tall_portrait_marketing_images do formato de anúncio de vários recursos da 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á em uma lista de permissões fechada. Para usar, entre em contato com seu gerente de contas.

  Observação: esse recurso está em 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

• Adicionamos uma nova RPC ProvideLeadFeedback a LocalServicesLeadService para enviar feedback sobre a qualidade de LocalServicesLead.
• Adicionamos um novo campo lead_feedback_submitted ao recurso LocalServicesLead que confirma se um feedback foi fornecido para um recurso específico.

Serviços de planejamento

• Adição de suporte para previsões mensais de frequência desejada em ReachPlanService.GenerateReachForecast.
  • Os desenvolvedores podem definir TargetFrequencyTimeUnit.MONTHLY em TargetFrequencySettings ao usar o código de produto planejável TARGET_FREQUENCY para gerar uma previsão de alcance mensal de frequência desejada.
• 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 que os desenvolvedores que solicitam previsões de alcance da Geração de demanda forneçam 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

• O novo campo ad_strength está disponível para ImprovePerformanceMaxAdStrengthRecommendation, que retorna a pontuação atual de qualidade do anúncio do grupo de recursos associado à recomendação.

  Shopping

• Agora é possível substituir as exclusões de marca para anúncios do Shopping em campanhas Performance Max. Isso é exposto por um novo campo pmax_campaign_settings no nível da campanha e funciona apenas para campanhas PMax para varejo. Um novo erro CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED será gerado se você tentar definir esse campo para um tipo de campanha incompatível.

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:
  • Um novo AdvertisingChannelSubType chamado YOUTUBE_AUDIO.
  • Um novo AdGroupType chamado YOUTUBE_AUDIO.
  • Uma nova enumeração de formato de anúncio chamada YOUTUBE_AUDIO_AD e os campos YouTubeAudioAdInfo correspondentes.
• 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

• Adicionamos DemandGenMultiAssetAdInfo.tall_portrait_marketing_images para oferecer suporte a recursos de imagem no modo retrato com proporção 9:16 em anúncios da Geração de demanda.

Recursos

• (Somente para contas na lista de permissão) Adicionamos suporte a recursos de mensagem por Asset.business_message_asset, BusinessMessageAsset e as seguintes enumerações e erros.
  • Enumerações:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Erros:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• Adição de AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW para oferecer suporte à geração automática de uma prévia da página de destino.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS agora está ativado por padrão para anúncios responsivos em vídeo da Geração de demanda.
• (Apenas para contas na lista de permissões, que está fechada no momento) Adicionamos Asset.app_deep_link_asset e AppDeepLinkAsset.

Conversões

• Metas de conversão
  • LifecycleGoalValueSettings.high_lifetime_value está fora da versão Beta e agora é mutável.
  • Adicionamos CustomerLifecycleGoal.owner_customer para mostrar o nome do recurso do cliente proprietário da meta de ciclo de vida do cliente.
• O uso de ConversionActionType.SALESFORCE foi descontinuado.

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

• Transformamos min_days e max_days de ValueRuleItineraryAdvanceBookingWindow em um campo optional para permitir a especificação de 0 como valor. Isso permite a segmentação de pesquisas de viagens que acontecem hoje.

Performance Max

• (Somente para contas na lista de permissão) Diretrizes da marca
  • Tornou Campaign.brand_guidelines_enabled mutável apenas ao criar uma campanha Performance Max.
  • Isso é incompatível com as campanhas Performance Max para metas de turismo.
  • Para ativar as diretrizes de marca em campanhas Performance Max, use um CampaignService.EnablePMaxBrandGuidelines adicionado recentemente. Não é possível desativar as diretrizes de marca.
  • Adicionamos Campaign.brand_guidelines e BrandGuidelines para permitir a definição das cores e da família de fontes da marca.
  • Novos valores de erro:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Adicionamos AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS para oferecer suporte à geração automática de recursos de vídeo avançados para campanhas Performance Max.

Planejamento

• (Somente para contas na lista de permissão) Adicionamos ContentCreatorInsightsService.GenerateTrendingInsights para que os usuários possam ver os temas de conteúdo em alta no YouTube para determinadas definições de público-alvo.
• Adicionamos GenerateCreatorInsightsRequest.country_locations[] para especificar os países em que os critérios serão pesquisados.
• Adicionamos GenerateCreatorInsightsRequest.search_brand para especificar uma marca e pesquisar criadores de conteúdo
• Adicionamos novos campos a YouTubeChannelInsights para fornecer mais informações de canal para solicitações de search_channels:
  • channel_url
  • channel_description
  • top_videos
• Adicionamos novos campos de metadados a AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Vídeos

• Após o lançamento de DataLinkService.CreateDataLink, adicionamos os seguintes métodos para permitir a mutação de links de dados criados anteriormente:
  • RemoveDataLink para remover vinculações de dados em uma conta do Google Ads
  • UpdateDataLink para aceitar, rejeitar e revogar vinculações de dados em uma conta do Google Ads
• A compatibilidade com VIDEO_OUTSTREAM foi removida das seguintes enumerações:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

Notas de lançamento arquivadas

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