Notas da versão

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.

Rótulos efetivos são aqueles herdados ou atribuídos diretamente.

Novos recursos

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

O uso 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 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 e dfaTransactionsCrossEnv mudaram 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.

Rótulos efetivos são aqueles herdados ou atribuídos diretamente.

Novos recursos

Em relação 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.

Veja 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 novos campos.

Segmentação por hora

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

Confira mais detalhes em customer_manager_link.start_time

MULTIMEDIA_AD foi adicionado 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 tem suporte nesta versão.

O tipo de campanha SOCIAL foi adicionado a campaign.advertising_channel_type e o subtipo SOCIAL_FACEBOOK_ adicionada_ONLY a campaign.advertising_channel_sub_type.

As métricas e segmentos agora podem ser selecionados com o tipo de campanha SOCIAL e o subtipo SOCIAL_FACEBOOK_tracking_ONLY. Não é possível consultar atributos específicos do SOCIAL ou do SOCIAL_FACEBOOK_TRACKING_ONLY nesta versão.

Foi adicionado suporte para average_quality_score.

Confira mais detalhes nas métricas

v0 (18/04/2024)

Essa atualização inclui o recurso "Estratégia de lances acessível"

Estratégia de lances acessível

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

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, as colunas de conversão e de fórmula personalizadas podem ser especificadas em uma consulta. Veja mais detalhes na documentação sobre colunas personalizadas.

Variáveis personalizadas do Floodlight

As variáveis personalizadas do Floodlight agora podem ser especificadas em uma consulta para estatísticas posteriores a 30/01/2024. Confira mais detalhes na documentação sobre 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 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 de grupos 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 conversão.

Visualização de desempenho do Shopping

Consulte os detalhes do recurso shopping_performance_view.

Acesse

Consulte 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 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 recurso.

Conjunto 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

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

Conjunto 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 recurso a seguir. 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

Veja os detalhes do recurso ad_group_ad.

v0 (2023-04-06)

Esta atualização inclui os recursos abaixo. 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

Confira 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

Confira 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

Veja os detalhes do recurso webpage_view.

Rótulo

Consulte os detalhes do recurso rótulo.

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

Veja os detalhes do recurso ad_group.

Lances

Veja os detalhes do recurso bidding_strategy.

Campanhas

Veja os detalhes do recurso de campaign.

Ação de conversão

Consulte os detalhes do recurso conversion_action.

Cliente

Consulte os detalhes do recurso cliente.

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 pesquisáveis. Os metadados nesses campos incluem descrições, tipos e compatibilidade com outros campos. Saiba mais.

SearchAds360Service