Notas da versão

v21 (06/08/2025)

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 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. 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 Alcance um novo nível de 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 se saíram. 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

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

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

• Ao usar uma lista compartilhada do tipo TYPE_PLACEMENT_LIST definida no nível da conta de administrador, os anunciantes agora podem usar critérios de 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 carteira, 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 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

• 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 nosso post no 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

• Adicionamos YouTubeVideoListAsset. Também adicionamos 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 clique expostos: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK e PRODUCT_ASSETS.

• Adicionamos o campo allow_non_skippable_in_stream a VideoAdInventoryControl para permitir 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

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

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.

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

• 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 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 se 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 e análise geográfica mais detalhadas para insights dos criadores 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 no anúncio político 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 tiverem declarado por conta própria 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.
• 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 mensal de alcance da frequência de destino.
• 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.
  • Adicionamos 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.

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 em 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 usando 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. Acesse Notas de migração para conferir a lista de todas as entidades removidas.

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 da marca em campanhas Performance Max, use um CampaignService.EnablePMaxBrandGuidelines recém-adicionado. Não é possível desativar as diretrizes da 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

v18 (16/10/2024)

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

Gerenciamento de conta

• (Somente para contas na lista de permissão) Adicionamos DataLinkService.CreateDataLink, que permite vincular uma conta do Google Ads a vídeos de criadores de conteúdo hospedados no canal do YouTube do criador. Com a vinculação de vídeos, a conta do Google Ads pode veicular anúncios de parceria usando vídeos de criadores de conteúdo.

Grupos de anúncios

• Adicionamos AdGroup.exclude_demographic_expansion, que permite impedir a expansão de dados demográficos quando optimized_targeting_enabled é true. Antes, esse recurso era compatível apenas com a Geração de demanda.

Anúncios

• Adição de AdGroupAd.ad_group_ad_asset_automation_settings, que permite ativar ou desativar a geração automática de recursos nos anúncios.
• Os seguintes valores foram adicionados a AssetAutomationType:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• Adicionamos o AdNetworkType.GOOGLE_OWNED_CHANNELS, usado por anúncios veiculados em canais do Google, como YouTube, Gmail e feed do Discover.

Recursos

• AssetType.DISCOVERY_CAROUSEL_CARD foi renomeado como AssetType.DEMAND_GEN_CAROUSEL_CARD.

Campanhas

• Adicionamos metrics.store_visits_last_click_model_attributed_conversions, que retorna o número de visitas à loja atribuídas pelo modelo de último clique de uma campanha.
• Adicionamos as seguintes métricas relacionadas a visualizações de vídeo para uma campanha:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Adicionamos metrics.results_conversions_purchase, que retorna compras de conversão para os resultados de metas unificadas de uma campanha.
• Mudança do valor padrão de DemandGenCampaignSettings.upgraded_targeting de false para true.

Critério

• Adicionamos content_criterion_view, que retorna métricas de performance de conteúdos segmentados, como palavras-chave, canais e tópicos, para campanhas de display, Geração de demanda e de vídeo.

Hotel e viagem

• Suporte para feeds de viagem nos anúncios de pesquisa
  • Adicionamos ClickType.TRAVEL_ASSETS para permitir a segmentação de métricas de feeds de viagem nos anúncios de pesquisa.
  • Adicionamos AssetSetType.TRAVEL_FEED que pode ser usado para ativar e desativar o uso de feeds de viagem nos anúncios de pesquisa.
• (Somente para contas na lista de permissão) Adicionamos o itinerário de viagem como uma nova regra de valor da conversão com os seguintes campos e valores novos:
  • ConversionValueRule.itinerary_condition com ValueRuleItineraryCondition, que permite especificar uma janela de reserva futura, uma duração do itinerário e dias de início da viagem na semana
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Adicionamos os seguintes segmentos aos relatórios de campaign e ad_group para permitir a segmentação de dados de performance com base em destinos específicos (cidades, países e regiões) para campanhas de hotel e de pesquisa:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Serviços locais

• PhoneCallDetails.call_recording_url vai ficar vazio, em vez de fornecer um URL inválido se a gravação de chamada não existir para a conversa de lead dos Serviços locais especificada.
• Adicionamos CategoryBid.target_cpa_bid_micro que permite definir o CPA desejado de uma categoria usando Campaign.local_services_campaign_settings.

Performance Max

• Suporte para diretrizes de marca
  • Adicionamos Campaign.brand_guidelines_enabled, que mostra se as diretrizes da marca estão ativadas para uma campanha Performance Max específica. Se ativados, os recursos com field_type definido como BUSINESS_NAME, LOGO, LANDSCAPE_LOGO precisam ser vinculados como recursos CampaignAsset em vez de recursos AssetGroupAsset.
  • Adicionamos erros CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED e CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, que indicam que as campanhas Performance Max com diretrizes de marca ativadas não têm os recursos CampaignAsset necessários vinculados à campanha.
  • Quando as diretrizes de marca estão ativadas, pelo menos um recurso com field_type definido como BUSINESS_NAME e pelo menos um com LOGO precisam ser vinculados à campanha como recursos CampaignAsset. As campanhas Performance Max para vendas on-line com um feed de produtos precisam atender a esse requisito apenas quando há recursos vinculados aos grupos de recursos da campanha.
  • Os seguintes valores foram adicionados a AssetLinkError:
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, que é gerado ao tentar vincular recursos de marca a campanhas como recursos CampaignAsset em vez de AssetGroupAsset em campanhas Performance Max com diretrizes de marca não ativadas.
  • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL erro, que é gerado ao tentar vincular recursos de marca a campanhas como recursos AssetGroupAsset em vez de recursos CampaignAsset em campanhas Performance Max com as diretrizes da marca ativadas.
• Adicionamos performance_max_placement_view, que retorna impressões dos canais em que os anúncios Performance Max foram veiculados.
• Adicionado AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planejamento

• (Somente para contas na lista de permissões) Adicionamos um novo serviço com o método ContentCreatorInsightsService.GenerateCreatorInsights, que permite aos usuários conferir insights sobre os principais criadores de conteúdo do YouTube. Assim, os clientes podem pesquisar criadores de conteúdo com base em uma combinação de segmentação por público-alvo e conteúdo ou insights de criadores com base em uma lista de IDs de canais do YouTube.
• Atualizações do AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • audience, baseline_audience e data_month foram movidos para audience_definition.
  • Adicionamos audience_description para gerar sugestões de segmentação com base em uma descrição de texto em formato livre usando IA generativa.
• Adicionamos AudienceInsightsService.GenerateTargetingSuggestionMetrics, que retorna métricas de alcance potencial para determinadas combinações de segmentação por público-alvo.

Recomendações

• RecommendationService.GenerateRecommendations agora pode ser usado para gerar recomendações sobre sugestões de orçamento otimizado durante a criação da campanha, incluindo o tipo de recomendação CAMPAIGN_BUDGET em GenerateRecommendationsRequest.recommendation_types[]. Isso funciona para campanhas Performance Max e de pesquisa.

Relatórios

• Substituímos os campos summary_row_setting e return_total_results_count de SearchGoogleAdsRequest pelo campo search_settings cujo tipo é SearchSettings com os seguintes campos:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Adicionamos as seguintes métricas sobre cliques inválidos gerais, como os gerados por bots ou rastreadores, que têm padrões irregulares. Eles podem ser consultados com o relatório campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Os seguintes valores foram adicionados a QuotaError:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Notas de lançamento arquivadas

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