Notas da versão

v0 (09/11/2026)

Novos segmentos

Estamos adicionando os seguintes segmentos:

v0 (01/08/2026)

Novos campos

Estamos adicionando synthetic_content_info aos recursos ad e asset, além da mensagem de suporte SyntheticContentInfo, SyntheticContentAttestationStatus e tipos enumerados SyntheticContentSource.

v0 (10/03/2026)

Novos segmentos

Estamos adicionando os seguintes segmentos:

v0 (05/12/2025)

Novas métricas

As seguintes métricas agora estão disponíveis ao consultar o recurso campaign:

Estamos adicionando as seguintes métricas de conversões com dados do carrinho (CwCD):

Novos segmentos

Agora é possível especificar a segmentação por código postal em uma consulta. Confira mais detalhes em segments.geo_target_postal_code.

v0 (10/11/2025)

Novos campos de URL

Estamos adicionando

Novas métricas para UserLocationView

As seguintes métricas agora estão disponíveis ao consultar o recurso user_location_view:

Correção do nome do recurso

O padrão de nome de recurso para os seguintes recursos de rótulo efetivo foi corrigido para usar owner_customer_id e garantir que ele contenha o ID de cliente que é proprietário do rótulo:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (em AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Exemplo: o padrão de CampaignEffectiveLabel mudou de customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} para customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12/06/2025)

Esta atualização inclui novos campos para o recurso customer. Atualize a biblioteca de cliente para aproveitar todas essas mudanças.

Novos campos

Estamos adicionando

para ajudar a navegar pela hierarquia de contas do Search Ads 360.

v0 (21/01/2025)

Esta atualização inclui um novo parâmetro para configurar a expansão do MCC.

Expansão da MCC

Ao consultar um bidding_strategy, agora é possível definir um valor booleano (enable_mcc_expansion) na seção PARAMETERS.

Quando esse parâmetro está ativado, os dados de todas as contas na hierarquia de contas com raiz em customer_id são retornados na resposta.

v0 (08/11/2024)

Esta atualização inclui novos campos e recursos. Atualize a biblioteca de cliente para aproveitar todas essas mudanças.

Novos campos

Estamos adicionando ad_group_ad.effective_labels e ad_group_criterion.effective_labels.

Os rótulos efetivos são herdados ou atribuídos diretamente.

Novos recursos

Visualização de local do usuário

Usá-lo com segmentos geográficos pode gerar métricas relacionadas à região, área metropolitana e cidade.

Consulte os detalhes do recurso user_location_view.

Relacionados aos novos campos effective_labels, há dois novos recursos que mantêm os metadados da associação entre os rótulos efetivos e o ad_group_ad (ad_group_ad_effective_label) ou ad_group_criterion (ad_group_criterion_effective_label).

v0 (07/10/2024)

Esta atualização inclui novas métricas, recursos, campos e algumas novas definições de mapeamento. Atualize a biblioteca de cliente para aproveitar todas essas mudanças.

Métricas adicionadas

cross_device_conversions_by_conversion_date e cross_device_conversions_value_by_conversion_date são compatíveis com estes recursos: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view e shopping_performance_view.

Mapeamentos de campo redefinidos

Os mapeamentos de campo para dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions e dfaTransactionsCrossEnv mudaram em alguns relatórios legados.

Campo Anteriormente Nova definição
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

Lista de relatórios legados que mudaram o mapeamento de campos

Novos campos

Estamos adicionando campaign.effective_labels e ad_group.effective_labels.

Os rótulos efetivos são herdados ou atribuídos diretamente.

Novos recursos

Relacionados aos novos campos effective_labels, os novos recursos mantêm os metadados da associação entre os rótulos efetivos e a campanha (campaign_effective_label) ou o grupo de anúncios (ad_group_effective_label).

v0 (23/08/2024)

Nesta atualização, os metadados da coluna personalizada adicionam o campo renderType .

Consulte os detalhes de CustomColumnRenderType.

Um novo campo owner_customer_id foi adicionado aos recursos campaign_label, ad_group_label, ad_group_ad_label e ad_group_criterion_label.

Atualize a biblioteca de cliente para aproveitar esses novos campos.

v0 (01/08/2024)

Esta atualização inclui a segmentação por hora e vários campos novos.

Segmentação por hora

Agora é possível especificar a segmentação por hora em uma consulta. Confira mais detalhes em segments.hour.

Confira mais detalhes em customer_manager_link.start_time.

Adicionamos MULTIMEDIA_AD a ad_group_ad.ad.type.

Agora é possível selecionar métricas e segmentos com o tipo MULTIMEDIA_AD. A consulta de atributos específicos de multimídia não é compatível com esta versão.

Adicionamos o tipo de campanha SOCIAL a campaign.advertising_channel_type e o subtipo SOCIAL_FACEBOOK_TRACKING_ONLY a campaign.advertising_channel_sub_type.

Agora é possível selecionar métricas e segmentos com o tipo de campanha SOCIAL e o subtipo SOCIAL_FACEBOOK_TRACKING_ONLY. A consulta de atributos específicos de SOCIAL ou SOCIAL_FACEBOOK_TRACKING_ONLY não é compatível com esta versão.

Adição de suporte para average_quality_score

Confira mais detalhes em métricas

v0 (18/04/2024)

Esta atualização inclui o recurso de estratégia de lances acessível

Estratégia de lances acessível

Representa uma visualização de BiddingStrategies que pertencem ao cliente e são compartilhadas com ele. Ao contrário de BiddingStrategy, esse recurso inclui estratégias que pertencem aos administradores do cliente e são compartilhadas com ele, além de estratégias que pertencem ao cliente. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos de BiddingStrategy.

Consulte os detalhes do recurso accessible_bidding_strategy.

v0 (12/02/2024)

Essa atualização inclui acesso a colunas personalizadas e variáveis personalizadas do Floodlight.

Colunas personalizadas

Agora é possível especificar colunas de conversão personalizada e de fórmula personalizada em uma consulta. Confira mais detalhes na documentação sobre colunas personalizadas.

Variáveis personalizadas do Floodlight

Agora é possível especificar variáveis personalizadas do Floodlight em uma consulta para estatísticas após 30/01/2024. Confira mais detalhes na documentação sobre variáveis personalizadas do Floodlight.

v0 (09/11/2023)

Esta atualização inclui os recursos a seguir. Acesse os links para conferir os campos que podem ser consultados para esses recursos, além das métricas e segmentações que podem ser usadas com eles.

Grupo de recursos

Consulte os detalhes do recurso asset_group.

Recurso do grupo de recursos

Consulte os detalhes do recurso asset_group_asset.

Filtro do grupo de produtos anunciados do grupo de recursos

Consulte os detalhes do recurso asset_group_listing_group_filter.

Indicador do grupo de recursos

Consulte os detalhes do recurso asset_group_signal.

Visualização das principais combinações do grupo de recursos

Consulte os detalhes do recurso asset_group_top_combination_view.

Visualização de vendas de dados do carrinho

Consulte os detalhes do recurso cart_data_sales_view.

Conversão

Consulte os detalhes do recurso de conversão.

Visualização da performance do Shopping

Consulte os detalhes do recurso shopping_performance_view.

Acessar

Confira os detalhes do recurso visit.

v0 (15/08/2023)

Esta atualização inclui os recursos a seguir e um novo parâmetro para configurar a conversão de moedas para métricas.

Acesse os links para conferir os campos que podem ser consultados para esses recursos, além das métricas e segmentações que podem ser usadas com eles.

Recurso do grupo de anúncios

Consulte os detalhes do recurso ad_group_asset.

Conjunto de recursos do grupo de anúncios

Consulte os detalhes do recurso ad_group_asset_set.

Recurso

Confira os detalhes do recurso asset.

Conjunto de recursos

Consulte os detalhes do conjunto de recursos asset_set.

Recurso do conjunto de recursos

Consulte os detalhes do recurso asset_set_asset.

Recurso da campanha

Consulte os detalhes do recurso campaign_asset.

Conjunto de recursos da campanha

Consulte os detalhes do recurso campaign_asset_set.

Recurso do cliente

Consulte os detalhes do recurso customer_asset.

Conjunto de recursos do cliente

Consulte os detalhes do conjunto de recursos customer_asset_set.

Conversão de moeda

É possível especificar a moeda para o cálculo de métricas usando metrics_currency na seção PARAMETERS.

Listar clientes acessíveis

Liste todas as contas acessíveis usando o método ListAccessibleCustomers.

v0 (15/05/2023)

Esta atualização inclui o recurso a seguir. Acesse os links para conferir os campos que podem ser consultados para esse recurso, além das métricas e segmentações que podem ser usadas com ele.

Anúncio do grupo de anúncios

Consulte os detalhes do recurso ad_group_ad.

v0 (06/04/2023)

Esta atualização inclui os recursos a seguir. Acesse os links para ver os campos que podem ser consultados em cada recurso, além das métricas e segmentações que podem ser usadas com ele.

Visualização de público-alvo do grupo de anúncios

Consulte os detalhes do recurso ad_group_audience_view.

Rótulo de critério do grupo de anúncios

Consulte os detalhes do recurso ad_group_criterion_label.

Rótulo do grupo de anúncios

Consulte os detalhes do recurso ad_group_label.

Visualização da faixa etária

Consulte os detalhes do recurso age_range_view.

Critério da campanha

Consulte os detalhes do recurso campaign_criterion.

Rótulo da campanha

Consulte os detalhes do recurso campaign_label.

Visualização de termos de pesquisa dos anúncios dinâmicos de pesquisa

Consulte os detalhes do recurso dynamic_search_ads_search_term_view.

Visualização da página da Web

Consulte os detalhes do recurso webpage_view.

Marcador

Consulte os detalhes do recurso label.

v0 (05/12/2022)

A versão v0 inclui os seguintes recursos e serviços. Acesse os links para ver os campos que podem ser consultados em cada recurso, além das métricas e segmentações que podem ser usadas com ele.

Grupo de anúncios

Consulte os detalhes do recurso ad_group.

Lances

Consulte os detalhes do recurso bidding_strategy.

Campanhas

Consulte os detalhes do recurso campaign.

Ação de conversão

Consulte os detalhes do recurso conversion_action.

Cliente

Consulte os detalhes do recurso customer.

Palavra-chave

Consulte os detalhes do recurso keyword_view.

Product Group

Consulte os detalhes do recurso product_group_view.

SearchAds360FieldService

  • O SearchAds360FieldService oferece um catálogo de todos os campos que podem ser consultados. Os metadados desses campos incluem descrições, tipos e compatibilidade com outros campos. Saiba mais.

SearchAds360Service

  • SearchAds360Service serve para recuperar vários recursos em uma única consulta. Os recursos que podem ser consultados incluem:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • Métricas como impressões e cliques também podem ser recuperadas usando SearchAds360Service para estes recursos:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service permite a segmentação por campos, como os de data. Saiba mais.