Notas da versão

v0 (2026-08-01)

Novos campos

Estamos adicionando synthetic_content_info aos recursos ad e asset, além da mensagem de suporte SyntheticContentInfo, SyntheticContentAttestationStatus, e das enumerações SyntheticContentSource.

v0 (2026-03-10)

Novos segmentos

Estamos adicionando os seguintes segmentos:

v0 (2025-12-05)

Novas métricas

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

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

Novos segmentos

A segmentação por código postal agora pode ser especificada em uma consulta. Confira mais detalhes em segments.geo_target_postal_code.

v0 (2025-11-10)

Novos campos de URL

Estamos adicionando

Novas métricas para UserLocationView

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

Correção do nome do recurso

O padrão de nome do recurso para os seguintes recursos de rótulo eficaz foi corrigido para usar owner_customer_id e garantir que ele contenha o ID do cliente 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 (2025-06-12)

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

Novos campos

Estamos adicionando

para ajudar a percorrer a hierarquia de contas do Search Ads 360.

v0 (2025-01-21)

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

Expansão de 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 enraizadas em customer_id são retornados na resposta.

v0 (2024-11-08)

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 eficazes são rótulos herdados ou atribuídos diretamente.

Novos recursos

Visualização da localização do usuário

Usar esse recurso com segmentos geográficos pode gerar métricas relacionadas a 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 eficazes e o ad_group_ad (ad_group_ad_effective_label) ou ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

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, dfaTransactionsCrossEnv foram alterados para 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 eficazes são rótulos herdados ou atribuídos diretamente.

Novos recursos

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

v0 (2024-08-23)

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

Consulte os detalhes de CustomColumnRenderType.

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

Atualize a biblioteca de cliente para aproveitar esses novos campos.

v0 (2024-08-01)

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

Segmentação por hora

A segmentação por hora agora pode ser especificada em uma consulta. Confira mais detalhes em segments.hour.

Confira mais detalhes em customer_manager_link.start_time

MULTIMEDIA_AD adicionado a ad_group_ad.ad.type

As métricas e os segmentos agora podem ser selecionados com o tipo MULTIMEDIA_AD. A consulta de atributos específicos de multimídia não é compatível com esta versão.

Tipo de campanha SOCIAL adicionado a campaign.advertising_channel_type e subtipo SOCIAL_FACEBOOK_TRACKING_ONLY a campaign.advertising_channel_sub_type

As métricas e os segmentos agora podem ser selecionados 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 (2024-04-18)

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

Estratégia de lances acessível

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

Consulte os detalhes do recurso accessible_bidding_strategy.

v0 (2024-02-12)

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

Colunas personalizadas

As colunas de conversão personalizada e as colunas de fórmula personalizada agora podem ser especificadas em uma consulta. Confira mais detalhes na documentação de colunas personalizadas.

Variáveis personalizadas do Floodlight

As variáveis personalizadas do Floodlight agora podem ser especificadas em uma consulta para estatísticas após 30/01/2024. Confira mais detalhes na documentação de variáveis personalizadas do Floodlight.

v0 (2023-11-09)

Esta atualização inclui os seguintes recursos. Acesse os links para conferir os campos que podem ser consultados para esses recursos e as 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 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 da combinação principal 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 conversion.

Visualização de performance do Shopping

Consulte os detalhes do recurso shopping_performance_view.

Acessar

Consulte os detalhes do recurso visit.

v0 (2023-08-15)

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

Acesse os links para conferir os campos que podem ser consultados para esses recursos e as 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

Consulte os detalhes do recurso asset.

Grupo de recursos

Consulte os detalhes do recurso asset_set.

Conjunto de recursos

Consulte os detalhes do recurso asset_set_asset.

Recurso da campanha

Consulte os detalhes do recurso campaign_asset.

Grupo de recursos de campanha

Consulte os detalhes do recurso campaign_asset_set.

Recurso do cliente

Consulte os detalhes do recurso customer_asset.

Grupo de recursos do cliente

Consulte os detalhes do recurso 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 (2023-05-15)

Esta atualização inclui o seguinte recurso. Acesse os links para conferir os campos que podem ser consultados para esse recurso e as 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 (2023-04-06)

Esta atualização inclui os seguintes recursos. Acesse os links para conferir os campos que podem ser consultados para cada recurso e as métricas e segmentações que podem ser usadas com ele.

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

Consulte os detalhes do recurso ad_group_audience_view.

Rótulo do 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 do termo 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 (2022-12-05)

A versão v0 inclui os seguintes recursos e serviços. Acesse os links para conferir os campos que podem ser consultados para cada recurso e as 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.

Keyword

Consulte os detalhes do recurso keyword_view.

Product Group

Consulte os detalhes do recurso product_group_view.

SearchAds360FieldService

  • SearchAds360FieldService fornece um catálogo de todos os campos consultáveis. Os metadados desses campos incluem descrições, tipos e compatibilidade com outros campos. Saiba mais.

SearchAds360Service

  • SearchAds360Service é destinado à recuperação de vários recursos em uma única consulta. Os recursos consultáveis incluem:

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

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

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

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