Notas da versão

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

v19.1 (16-04-2025)

Os recursos e mudanças a seguir foram adicionados à versão 19.1.

Recursos

• Foi adicionado um campo asset_coverage para AssetGroup, que retorna informações sobre lacunas no 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 força do anúncio de um grupo de recursos.

Campanhas

• Agora é possível avaliar ou dar feedback sobre leads em campanhas de Serviços Locais. Como parte dessa mudança, a v19.1
  • Foi adicionado um novo serviço chamado LocalServicesLeadService. Você pode usar o método ProvideLeadFeedback para fazer upload da nota e do feedback de leads.
  • Um novo campo chamado lead_feedback_submitted foi adicionado a LocalServicesLead para ajudar a determinar se o feedback foi enviado a um lead.
• Adicionamos uma nova coluna de métricas biddable_cohort_app_post_install_conversions para campanhas para apps.

Geração de demanda

• Foram introduzidos outros métodos no Planejamento de serviços para oferecer suporte à Geração de demanda.

• Foi adicionado suporte aos controles de canais nas campanhas Geração de demanda no nível do grupo de anúncios. É 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 do YouTube
  • YouTube Shorts
  • Discover
  • Gmail
  • Display

• Um novo tipo de recurso foi exposto 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 recurso em ChangeStatusResourceType:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• É possível extrair esses três tipos mais detalhados do 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. Esse campo era 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 um novo RPC ProvideLeadFeedback a LocalServicesLeadService para fornecer feedback sobre a qualidade de LocalServicesLead.
• Foi adicionado um novo campo lead_feedback_submitted ao recurso LocalServicesLead que confirma se o 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 programável TARGET_FREQUENCY para gerar uma previsão de alcance mensal de frequência de destino.
• Adicionamos um novo método, ReachPlanService.GenerateConversionRates, que permite que os anunciantes solicitem taxas de conversão sugeridas para produtos programáveis compatíveis.
• Previsão de 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 DEMAND_GEN_MAX_CONVERSIONS programável 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. Este campo é obrigatório para solicitações de previsão de Geração de demanda. Ele não é compatível com outros produtos programáveis.
  • Foi adicionado um novo campo conversions às previsões retornadas. Esse campo contém o número de conversões em um determinado ponto da curva de alcance. As conversões são compatíveis apenas com o produto planificável DEMAND_GEN_MAX_CONVERSIONS.

Recomendações

• O novo campo ad_strength está disponível para ImprovePerformanceMaxAdStrengthRecommendation, que retorna a pontuação atual da 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 em 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. Consulte 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 foram introduzidas, coviewed_impressions e primary_impressions.
  • Dois novos segmentos foram introduzidos, chamados de adjusted_age_range e adjusted_gender.
  • 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 precisa ser selecionado para extrair estatísticas válidas para essas colunas.
  • No momento, esse recurso está disponível apenas para clientes da lista de permissões.

v19 (26/02/2025)

Os recursos e mudanças a seguir foram adicionados à versão 19.

Gerenciamento da conta

• Os seguintes valores foram adicionados a CustomerError para considerar as próximas mudanças:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Anúncios

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

Recursos

• (Somente para contas na lista de permissões) Adicionado suporte a recursos de mensagem com Asset.business_message_asset, BusinessMessageAsset e os seguintes tipos enumerados e erros.
  • Tipos enumerados:
    • 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 visualização da página de destino.
• A AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS agora está ativada por padrão para anúncios responsivos em vídeo da Geração de demanda.
• (Somente para contas na lista de permissões; a lista está fechada no momento) Foram adicionados Asset.app_deep_link_asset e AppDeepLinkAsset.

Conversões

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

Feeds

• Todas as entidades relacionadas ao feed foram removidas, como Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view etc. Agora, os usuários precisam usar assets para alcançar o mesmo objetivo. Acesse as Notas de migração para conferir a lista de todas as entidades removidas.

Hotel e viagens

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

Performance Max

• (Somente para contas na lista de permissões) Diretrizes da marca
  • O Campaign.brand_guidelines_enabled passou a ser 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 nas campanhas Performance Max atuais, use uma CampaignService.EnablePMaxBrandGuidelines recém-adicionada. Não é possível desativar as diretrizes da marca.
  • Campaign.brand_guidelines e BrandGuidelines foram adicionados para permitir a configuraçã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 gerar automaticamente recursos de vídeo aprimorados para campanhas Performance Max.

Planejamento

• (Somente para contas na lista de permissões) Foi adicionado o ContentCreatorInsightsService.GenerateTrendingInsights, que permite que os usuários vejam os temas de conteúdo em alta no YouTube para determinadas definições de público-alvo.
• Foi adicionado GenerateCreatorInsightsRequest.country_locations[] para especificar os países em que os critérios serão pesquisados.
• A GenerateCreatorInsightsRequest.search_brand foi adicionada para especificar uma marca na pesquisa de criadores
• Foram adicionados novos campos a YouTubeChannelInsights para fornecer mais informações do canal para solicitações search_channels:
  • channel_url
  • channel_description
  • top_videos
• Foram adicionados 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 vinculações de dados criadas 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 dos seguintes tipos enumerados:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

v18 (16/10/2024)

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

Gerenciamento da conta

• (Somente para contas na lista de permissões) Adicionamos o DataLinkService.CreateDataLink, que permite vincular uma conta do Google Ads a vídeos hospedados no canal do criador de conteúdo. 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

• Foi adicionado o AdGroup.exclude_demographic_expansion, que permite excluir a expansão de dados demográficos quando optimized_targeting_enabled está true, um recurso que antes só era compatível 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
• Adicionado AdNetworkType.GOOGLE_OWNED_CHANNELS, que é usado por anúncios veiculados em canais do Google, como o YouTube, o Gmail e o feed do Discover.

Recursos

• AssetType.DISCOVERY_CAROUSEL_CARD foi renomeado como AssetType.DEMAND_GEN_CAROUSEL_CARD.

Campanhas

• Adição de 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 às visualizações de vídeo de uma campanha:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Adicionado metrics.results_conversions_purchase, que retorna compras de conversão para os resultados de metas unificadas de uma campanha.
• O valor padrão de DemandGenCampaignSettings.upgraded_targeting foi alterado de false para true.

Critério

• Adição de 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 vídeo.

Hotel e viagens

• Suporte para feeds de viagem nos anúncios de pesquisa
  • A ClickType.TRAVEL_ASSETS foi adicionada para permitir a segmentação de métricas dos feeds de viagem nos anúncios de pesquisa.
  • Foi adicionado o AssetSetType.TRAVEL_FEED, que pode ser usado para ativar e desativar o uso do feed de viagens nos anúncios de pesquisa.
• (Somente para contas na lista de permissões) Foi adicionado o itinerário de viagem como uma nova regra do valor da conversão com os seguintes campos e valores:
  • ConversionValueRule.itinerary_condition com ValueRuleItineraryCondition, que permite especificar uma janela de reserva futura, a duração do itinerário e o dia da semana de início da viagem
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Adicionamos os seguintes segmentos para os relatórios 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 ficará vazio, em vez de fornecer um URL inválido se a gravação de chamada não existir para a conversa de lead do Serviços locais.
• Foi adicionado 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
  • Foi adicionado o Campaign.brand_guidelines_enabled, que mostra se as diretrizes da marca estão ativadas para uma determinada campanha Performance Max. Se ativada, os recursos com field_type definidos como BUSINESS_NAME, LOGO, LANDSCAPE_LOGO precisam ser vinculados como recursos CampaignAsset em vez de AssetGroupAsset.
  • Foram adicionados 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 recursos AssetGroupAsset em campanhas Performance Max com diretrizes de marca não ativadas.
    • Erro BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, que é gerado ao tentar vincular recursos da marca a campanhas como recursos AssetGroupAsset em vez de CampaignAsset em campanhas Performance Max com diretrizes da marca ativadas.
• Adicionamos performance_max_placement_view, que retorna impressões dos canais em que os anúncios Performance Max foram veiculados.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION adicionado

Planejamento

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

Recomendações

• Agora, o RecommendationService.GenerateRecommendations 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

• Os campos summary_row_setting e return_total_results_count de SearchGoogleAdsRequest foram substituídos pelo campo search_settings, cujo tipo é SearchSettings, com os seguintes campos:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Foram adicionadas 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

v17.1.0 (7 de agosto de 2024)

Os novos recursos e atualizações a seguir foram adicionados à v17_1.

Recursos

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() permite remover recursos automáticos vinculados aos anúncios responsivos de pesquisa.

Públicos-alvo

• Novos valores de enumeração em UserListCustomerTypeCategory:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

Campanhas

• ShareablePreviewService.GenerateShareablePreviews() gera os URLs shareable_preview_url na resposta para visualizações de anúncios compartilháveis de grupos de recursos ativados e pausados.
  • O campo expiration_date_time indica a data de validade dos URLs na resposta.
  • Se ocorrer um erro, o método vai retornar partial_failure_error em vez dos URLs.

Histórico de alterações

• Novo tipo de recurso de mudança de status: ASSET_GROUP.

Conversões

• Novo campo de segmento para a versão da SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, que expõe os diagnósticos de upload de conversões no nível da ação de conversão.
• As métricas a seguir são adicionadas aos relatórios de diagnóstico off-line para informar o número de conversões enviadas que ainda estão sendo processadas:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Planejamento

• AudienceInsights.GenerateAudienceOverlapInsights(), que aceita um atributo principal de entrada e uma coleção de atributos de público-alvo e retorna as estimativas da sobreposição do alcance potencial do YouTube entre o atributo principal e os atributos de público-alvo.

Relatórios

• Suporte para segmentar per_store_view com base em segments.date

Vídeos

• Suporte para a recuperação de informações relacionadas às seguintes estratégias de lances padrão para campanhas de vídeo usando relatórios, como ad_group, campaign:
  • Campaign.fixed_cpm (CPM fixo (custo por mil impressões))
  • Campaign.target_cpv (CPV desejado (custo por visualização))
• Campaign.video_campaign_settings, que permite determinar em quais inventários os anúncios em vídeo podem ser veiculados usando os seguintes campos de relatório:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, que permite segmentar os seguintes relatórios com base no tipo de formato de anúncio em vídeo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05/06/2024)

Os recursos e mudanças a seguir foram adicionados à versão 17.

Anúncios

• AdService.getAd foi removido. Isso alinha o AdService a outros serviços na API Google Ads. Consulte Como buscar objetos para saber a maneira recomendada de buscar anúncios e outros tipos de recursos.
• Foram adicionadas mais validações para ImageAdInfo.image_asset relacionadas a dimensões e formato. Os seguintes erros podem ser gerados se a imagem for inválida:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Recursos

• Foi adicionado um novo tipo enumerado: ClickType.AD_IMAGE
• Adicionamos os seguintes relatórios com novas métricas para campanhas Performance Max e de pesquisa:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Públicos-alvo

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED adicionado

Jobs em lote

• Foi adicionado BatchJobError.REQUEST_TOO_LARGE, que será gerado quando o AddBatchJobOperationsRequest enviado for maior que 10484504 bytes.
• Adição de suporte para definir MutateOperation.asset_group_operation ao usar BatchJobService. Assim, você pode usar o processamento em lote para criar e gerenciar campanhas Performance Max completas. Confira nosso novo guia dedicado.

Campanhas

• A Discovery foi renomeada para Geração de demanda em todos os campos, tipos enumerados e erros de todos os recursos da API Google Ads, como campanhas, anúncios e recursos. Por exemplo, AdvertisingChannelType.DISCOVERY agora é AdvertisingChannelType.DEMAND_GEN.
• Foi adicionado o Campaign.keyword_match_type para que você possa definir o tipo de correspondência de palavra-chave para todas as palavras-chave em uma campanha.

Conversões

• Para conversões da SKAdNetwork,
  • segments.sk_ad_network_conversion_value foi renomeado como segments.sk_ad_network_fine_conversion_value.
  • segments.sk_ad_network_redistributed_fine_conversion_value foi adicionado.
• As métricas a seguir são retornadas com a resposta, mesmo quando são zero. Isso as torna consistentes com outras métricas.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Critérios

• Adicionado aos seguintes campos para AdGroupCriterion mostrar se o critério do grupo de anúncios está sendo veiculado ou os motivos pelos quais ele não está veiculando:
  • primary_status
  • primary_status_reasons
• Inclusão de suporte a metrics.search_impression_share para gender_view.
• Inclusão de suporte a metrics.phone_calls para keyword_view.

Serviços locais

• Adicionado LocalServicesLeadService.AppendLeadConversation() usado para anexar um novo LocalServicesLeadConversation a LocalServicesLead, que envia as mensagens aos usuários pelos canais apropriados, como SMS, dependendo de como o lead foi criado.
  • O tamanho de AppendLeadConversationRequest.conversations é limitado a 1.000.
  • Apenas LocalServicesLead com lead_type definido como LeadType.MESSAGE pode ser especificado em Conversation.local_services_lead.
• Foram adicionados novos valores de tipo enumerado a ConversationType:
  • WHATSAPP para representar uma conversa iniciada pelo WhatsApp.
  • ADS_API para representar uma conversa introduzida usando o novo método LocalServicesLeadService.AppendLeadConversation().
• Os seguintes campos foram adicionados a local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Relatórios

• Agora é possível selecionar apenas campos relacionados a um produto vinculado ao consultar product_link. A seleção de vários campos de vários produtos vinculados vai gerar QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Por exemplo, product_link.advertising_partner.customer e product_link.data_partner.data_partner_id não podem ser selecionados na mesma consulta.
• Transmitir um page_size para GoogleAdsService.Search resultará em um erro RequestError.PAGE_SIZE_NOT_SUPPORTED.

Shopping

• Foi adicionado um novo relatório shopping_product, que corresponde à página Produtos da interface do Google Ads. Ele aceita o retorno de dados relacionados ao estado atual dos produtos das contas do Google Merchant Center vinculadas a uma conta do Google Ads.
  • É possível filtrar as métricas do relatório shopping_product usando segments.date ao usar GoogleAdsService.Search ou GoogleAdsService.SearchStream. A segmentação por data não é permitida e vai retornar um erro ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Metas unificadas

• A UserListCustomerTypeService.MutateUserListCustomerTypes() foi adicionada para configurar tipos de clientes de público-alvo.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings foi removido. Para configurar as configurações de público-alvo das metas do ciclo de vida do cliente, use UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Anexe ou remova uma lista de usuários definindo UserListCustomerType.customer_type_category para UserListCustomerTypeCategory.PURCHASERS para incluir ou excluir a lista de uma definição de cliente atual para as metas do ciclo de vida do cliente, respectivamente. Acesse segmentar seus públicos-alvo para mais detalhes.

Vídeos

• Os seguintes valores foram adicionados a ContentLabelType. É possível excluir estes ContentLabelTypes no nível do cliente:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• Adição de AdVideoAsset.ad_video_asset_info para oferecer suporte a preferências de inventário para recursos de vídeo ao criar DemandGenVideoResponsiveAdInfo.
• (Somente contas na lista de permissões) Campaign.video_brand_safety_suitability tornou-se mutável.

Notas de lançamento arquivadas

Consulte Versões descontinuadas para conferir as Notas de lançamento arquivadas.