Notas da versão

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 de nome de recurso

O padrão de nome do recurso para os seguintes recursos de rótulo efetivo 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 (12/06/2025)

Essa 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 da 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 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.

Em relação 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 o ad_group_criterion (ad_group_criterion_effective_label).

v0 (07/10/2024)

Essa 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 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 de agosto de 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.

Não se esqueça de atualizar a biblioteca de cliente para aproveitar esses novos campos.

v0 (01/08/2024)

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

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

Adicionado 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 de abril de 2024)

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

Estratégia de lances acessível

Representa uma visualização das BiddingStrategies pertencentes ao cliente e compartilhadas com ele. Ao contrário de "BiddingStrategy", esse recurso inclui estratégias de lances pertencentes a gerentes do cliente e compartilhadas com ele, além das estratégias de lances pertencentes ao 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 (12 de fevereiro de 2024)

Essa atualização inclui acesso a colunas 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 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 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 da principal combinação 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

Confira detalhes do recurso conversion.

Visualização da performance no 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.

Recurso do grupo de recursos

Consulte os detalhes do recurso asset_set_asset.

Recurso da campanha

Consulte os detalhes do recurso campaign_asset.

Grupo de recursos da 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 PARÂMETROS.

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 (06/04/2023)

Esta atualização inclui os seguintes recursos. Acesse os links para conferir os campos que podem ser consultados para cada recurso, além das 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 de 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 de página da Web

Consulte os detalhes do recurso webpage_view.

Rótulo

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 conferir os campos que podem ser consultados para 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

Confira 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 fornece 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 é usado para recuperar vários recursos em uma única consulta. Os recursos consultáveis incluem:

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

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

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

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