A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google searchads-api-announcements para ficar por dentro das próximas melhorias e versões.

Esta página foi traduzida pela API Cloud Translation.

ad_group_audience_view

Uma visualização do público-alvo do grupo de anúncios. Inclui dados de performance de interesses e listas de remarketing para anúncios da Rede de Display e da Rede de Display do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público-alvo.

Recursos atribuídos
ad_group
ad_group_criterion
campaign
cliente

Os campos dos recursos acima podem ser selecionados junto com esse recurso nas cláusulas SELECT e WHERE. Esses campos não segmentam as métricas na cláusula SELECT.

Segmentar recursos
bidding_strategy
user_list

Os campos dos recursos acima, quando selecionados junto com esse recurso nas cláusulas SELECT e WHERE, segmentarão as métricas.

Campos/segmentos/métricas

Esta página mostra todas as métricas e segmentos que podem ser colocados na mesma cláusula SELECT que os campos de ad_group_audience_view. No entanto, quando você especifica ad_group_audience_view na cláusula FROM, algumas métricas e segmentos não podem ser usados. Use o filtro a seguir para mostrar apenas os campos que podem ser usados quando ad_group_audience_view é especificado na cláusula FROM.

O ad_group_audience_view está especificado na cláusula FROM da consulta?

Campos de recursos
resource_name

Segmentos
ad_network_type
conversion_action_name
data
device
mês
trimestre
semana
ano

Métricas
all_conversions
all_conversions_by_conversion_date
all_conversions_value
all_conversions_value_by_conversion_date
average_cpc
average_cpm
cliques
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
cost_micros
cross_device_conversions
cross_device_conversions_by_conversion_date
cross_device_conversions_value
cross_device_conversions_value_by_conversion_date
ctr
impressões

ad_group_audience_view.resource_name
Descrição do campo	O nome do recurso da visualização de público-alvo do grupo de anúncios. Os nomes dos recursos da visualização do público-alvo do grupo de anúncios têm o formato: `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}`
Categoria	`ATTRIBUTE`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetida	Falso

segments.ad_network_type
Descrição do campo	Tipo de rede de publicidade.
Categoria	`SEGMENT`
Tipo de dados	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
Digite o URL	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.conversion_action_name
Descrição do campo	Nome da ação de conversão.
Categoria	`SEGMENT`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.date
Descrição do campo	Data a que as métricas se aplicam. No formato aaaa-MM-dd, por exemplo, 2018-04-17.
Categoria	`SEGMENT`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.device
Descrição do campo	Dispositivo a que as métricas se aplicam.
Categoria	`SEGMENT`
Tipo de dados	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.month
Descrição do campo	Mês conforme representado pela data do primeiro dia de um mês. no formato aaaa-MM-dd.
Categoria	`SEGMENT`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.quarter
Descrição do campo	Trimestre conforme representado pela data do primeiro dia de um trimestre. Usa o ano para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 01/04/2018. no formato aaaa-MM-dd.
Categoria	`SEGMENT`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.week
Descrição do campo	É a semana definida como de segunda a domingo e representada pela data de segunda-feira. no formato aaaa-MM-dd.
Categoria	`SEGMENT`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.year
Descrição do campo	Ano, formatado como aaaa.
Categoria	`SEGMENT`
Tipo de dados	`INT32`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.all_conversions
Descrição do campo	O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.all_conversions_by_conversion_date
Descrição do campo	O número total de conversões. Isso inclui todas as conversões, independentemente do valor de include_in_conversions_metric. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.all_conversions_value
Descrição do campo	Valor de todas as conversões.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.all_conversions_value_by_conversion_date
Descrição do campo	Valor de todas as conversões. Quando essa coluna é selecionada com a data, os valores na coluna de data significam a data da conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.average_cpc
Descrição do campo	O custo total de todos os cliques dividido pelo número total de cliques recebidos. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.average_cpm
Descrição do campo	Custo médio por mil impressões (CPM médio). Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.clicks
Descrição do campo	O número de cliques.
Categoria	`METRIC`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.client_account_conversions
Descrição do campo	O número de conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo include_in_client_account_conversions_metric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.client_account_conversions_value
Descrição do campo	O valor das conversões da conta de cliente. Isso inclui apenas as ações de conversão em que o atributo include_in_client_account_conversions_metric está definido como "true". Se você usar lances com base em conversões, suas estratégias serão otimizadas para essas conversões.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.client_account_view_through_conversions
Descrição do campo	O número total de conversões de visualização. Elas acontecem quando um cliente vê um anúncio gráfico ou rich media e depois conclui uma conversão no seu site sem interagir (por exemplo, clicar) com outro anúncio.
Categoria	`METRIC`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.cost_micros
Descrição do campo	A soma de seus custos de CPC e seu custo por mil impressões (CPM, na sigla em inglês) durante o período. Essa métrica é um valor monetário e é retornada na moeda do cliente por padrão. Consulte o parâmetro metrics_currency em https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Categoria	`METRIC`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.cross_device_conversions
Descrição do campo	Conversões geradas quando um cliente clica em um anúncio usando um dispositivo e realiza a conversão em outro dispositivo ou navegador. As conversões em dispositivos diferentes já estão incluídas em all_conversions.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.cross_device_conversions_by_conversion_date
Descrição do campo	O número de conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.cross_device_conversions_value
Descrição do campo	A soma do valor das conversões em dispositivos diferentes.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.cross_device_conversions_value_by_conversion_date
Descrição do campo	A soma do valor das conversões em dispositivos diferentes por data de conversão. Os detalhes das colunas by_conversion_date estão disponíveis em https://support.google.com/sa360/answer/9250611.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.ctr
Descrição do campo	O número de cliques que seu anúncio recebe (cliques) dividido pelo número de vezes que ele é exibido (impressões).
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.impressions
Descrição do campo	Contagem da frequência com que seu anúncio foi exibido em uma página de resultados de pesquisa ou em um site na Rede do Google.
Categoria	`METRIC`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

ad_group_audience_view

Campos/segmentos/métricas

ad_group_audience_view.resource_name

segments.ad_network_type

segments.conversion_action_name

segments.date

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_by_conversion_date

metrics.all_conversions_value

metrics.all_conversions_value_by_conversion_date

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.cost_micros

metrics.cross_device_conversions

metrics.cross_device_conversions_by_conversion_date

metrics.cross_device_conversions_value

metrics.cross_device_conversions_value_by_conversion_date

metrics.ctr

metrics.impressions