Notas da versão

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 (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 efetivos são 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 efetivos e 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.

Os rótulos efetivos são 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 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.

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

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.

MULTIMEDIA_AD foi adicionado a ad_group_ad.ad.type

Agora é possível selecionar métricas e segmentos com o tipo MULTIMEDIA_AD. Não é possível consultar atributos específicos de multimídia nesta versão.

O tipo de campanha SOCIAL foi adicionado 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. 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 são 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. Confira mais detalhes na documentação sobre colunas personalizadas.

Variáveis personalizadas do Floodlight

Agora, as variáveis personalizadas do Floodlight podem ser especificadas em uma consulta para estatísticas após 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 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 conversão.

Visualização de desempenho do Shopping

Consulte os detalhes do recurso shopping_performance_view.

Acesse

Consulte os detalhes do recurso visit.

v0 (2023-08-15)

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.

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.

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

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

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

Consulte os detalhes do recurso ad_group.

Lances

Consulte os detalhes do recurso bidding_strategy.

Campanhas

Confira os detalhes do recurso campanha.

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

  • 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

  • SearchAds360Service é usado para recuperar vários recursos em uma única consulta. Os recursos pesquisá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

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