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.

visualização_do_local_do_usuário

Uma visualização da localização do usuário. A visualização de localização do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Ele informa as métricas no local físico real do usuário por local segmentado ou não segmentado. Se outros campos de segmento forem usados, você poderá receber mais de uma linha por país.

Recursos atribuídos
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
ad_group
campaign

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 user_location_view. No entanto, quando você especifica user_location_view na cláusula FROM, não é possível usar algumas métricas e segmentos. Use o filtro a seguir para mostrar apenas os campos que podem ser usados quando user_location_view é especificado na cláusula FROM.

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

Campos de recursos
country_criterion_id
resource_name
targeting_location

Segmentos
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
data
day_of_week
dispositivo
geo_target_city
geo_target_metro
geo_target_region
mês
trimestre
semana
ano

Métricas
all_conversions
all_conversions_from_interactions_rate
all_conversions_value
average_cost
average_cpc
average_cpm
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversões
conversions_from_interactions_rate
conversions_value
cost_micros
cost_per_all_conversions
cost_per_conversion
cross_device_conversions
cross_device_conversions_value
ctr
impressões
interaction_event_types
interaction_rate
interações
value_per_all_conversions
value_per_conversion

user_location_view.country_criterion_id
Descrição do campo	ID do critério do país.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

user_location_view.resource_name
Descrição do campo	O nome do recurso da visualização de local do usuário. Os nomes dos recursos de visualização de localização do usuário têm o formato: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
Categoria	`ATTRIBUTE`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetida	Falso

user_location_view.targeting_location
Descrição do campo	Indica se o local foi segmentado ou não.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
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
Descrição do campo	Nome do recurso da ação de conversão.
Categoria	`SEGMENT`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.conversion_action_category
Descrição do campo	Categoria de ação de conversão.
Categoria	`SEGMENT`
Tipo de dados	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
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.day_of_week
Descrição do campo	Dia da semana, por exemplo, SEGUNDA-FEIRA.
Categoria	`SEGMENT`
Tipo de dados	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
Digite o URL	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
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.geo_target_city
Descrição do campo	Nome do recurso da constante de segmentação por área geográfica que representa uma cidade.
Categoria	`SEGMENT`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.geo_target_metro
Descrição do campo	Nome do recurso da constante de segmentação por área geográfica que representa uma área metropolitana.
Categoria	`SEGMENT`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

segments.geo_target_region
Descrição do campo	Nome do recurso da constante de segmentação por área geográfica que representa uma região.
Categoria	`SEGMENT`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
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 civil para trimestres. Por exemplo, o segundo trimestre de 2018 começa em 2018-04-01. 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_from_interactions_rate
Descrição do campo	Todas as conversões de interações (como opostas a conversões de visualização) divididas pelo número de interações com anúncios.
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.average_cost
Descrição do campo	Valor médio que você paga por interação. Esse valor é o custo total dos seus anúncios dividido pelo número total de interações.
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.conversions
Descrição do campo	O número de conversões. Isso inclui apenas ações de conversão em que o atributo include_in_conversions_metric está definido como verdadeiro. 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.conversions_from_interactions_rate
Descrição do campo	Conversões com lances possíveis (de interação) médias por interação qualificada. Mostra com que frequência, em média, uma interação com o anúncio leva a uma conversão que recebe lances.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.conversions_value
Descrição do campo	A soma dos valores das conversões incluídas no campo "conversões". Essa métrica só será útil se você inserir um valor para suas ações de conversão.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
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.cost_per_all_conversions
Descrição do campo	O custo das interações com anúncios dividido por 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.cost_per_conversion
Descrição do campo	Custo médio de conversões qualificadas por conversão que pode ser usada em lances.
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
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_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.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

metrics.interaction_event_types
Descrição do campo	Os tipos de interação com pagamentos e sem custo.
Categoria	`METRIC`
Tipo de dados	`ENUM`
Digite o URL	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetida	Verdadeiro

metrics.interaction_rate
Descrição do campo	A frequência com que as pessoas interagem com seu anúncio depois da exibição dele. Esse é o número de interações dividido pelo número de vezes que seu anúncio é exibido.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.interactions
Descrição do campo	O número de interações. Uma interação é a principal ação do usuário associada a um formato de anúncio (cliques em anúncios de texto e do Shopping, visualizações de anúncios em vídeo etc.).
Categoria	`METRIC`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

metrics.value_per_all_conversions
Descrição do campo	O valor de todas as conversões dividido pelo número 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.value_per_conversion
Descrição do campo	O valor da conversão que pode ser usada em lances dividido pelo número de conversões que podem ser usadas em lances. Mostra o valor médio de cada uma das conversões que podem receber lances.
Categoria	`METRIC`
Tipo de dados	`DOUBLE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetida	Falso

visualização_do_local_do_usuário Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Campos/segmentos/métricas

user_location_view.country_criterion_id

user_location_view.resource_name

user_location_view.targeting_location

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.geo_target_city

segments.geo_target_metro

segments.geo_target_region

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_value

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

metrics.conversions_from_interactions_rate

metrics.conversions_value

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cost_per_conversion

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.value_per_all_conversions

metrics.value_per_conversion

visualização_do_local_do_usuário