Relatórios

Visão geral

Estas páginas listam os recursos que podem ser consultados na API Google Ads usando GoogleAdsService.SearchStream ou GoogleAdsService.Search. Os nomes dos recursos são vinculados à própria página. Em cada página, você encontra as seguintes listas:

  • Artefatos (recursos, segmentos ou métricas) que podem ser usados na mesma cláusula SELECT com o recurso
  • Recursos atribuídos com campos que não segmentam métricas quando incluídos nas mesmas cláusulas SELECT e WHERE desses campos

Apresentadas depois dessas listas são as tabelas que consistem em nomes de campos de recursos, segmentos e métricas que podem ser incluídos em uma consulta de pesquisa, quando esse recurso é especificado na cláusula FROM. Cada nome é vinculado à tabela que contém os metadados:

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
Filtrável
Essa linha indica se o campo pode ser usado nas condições da cláusula WHERE da consulta GAQL.
Selecionável
Essa linha indica se o campo pode ser especificado na cláusula SELECT da consulta GAQL.
Sortable
Essa linha indica se o campo pode ser classificado e usado na cláusula ORDER BY da consulta GAQL.
Repetida
Essa linha indica se o campo é repetido, o que precisa ser tratado como uma lista.

Exemplos de relatórios

Lista de todos os recursos

Tipos de recurso
accessibility_bidding_strategy Representa uma visualização das BiddingStrategies de propriedade do cliente e compartilhadas com ele. Em contraste com a estratégia de lances, este recurso inclui estratégias que pertencem aos gerentes do cliente e são compartilhadas com ele, além das estratégias que pertencem a este cliente. Este recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos BiddingStrategy.
account_budget Um orçamento em nível de conta. Ele contém informações sobre o orçamento, além das alterações aprovadas mais recentemente no orçamento e as propostas de proposta com aprovação pendente. As alterações propostas com aprovação pendente, se houver, são encontradas em 'proposta_pendente'. Detalhes efetivos sobre o orçamento podem ser encontrados nos campos prefixados 'approved_', 'adjusted_' e nos que não têm prefixos. Como alguns detalhes eficazes podem ser diferentes do que o usuário solicitou originalmente (por exemplo, um limite de gastos), essas diferenças são justificadas com os campos 'proposed_', 'approved_' e possivelmente 'adjusted_'. Esse recurso é alterado com AccountBudgetProposal e não pode ser alterado diretamente. Um orçamento pode ter, no máximo, uma proposta pendente a qualquer momento. Ela é lida por pendente_proposta. Depois de aprovado, o orçamento pode estar sujeito a ajustes, como ajustes de crédito. Os ajustes criam diferenças entre os campos 'aprovados' e 'adjusted' , que seriam idênticos a outros.
account_budget_proposta Uma proposta de orçamento no nível da conta. Nem todos os campos prefixados com 'proposed' podem não ser aplicados diretamente. Por exemplo, os limites de gastos propostos podem ser ajustados antes da aplicação. Este campo será verdadeiro se o campo 'proposed' tiver uma contraparte 'aprovado' por exemplo, limites de gastos. O tipo de proposta (proposta_tipo) altera quais campos são obrigatórios e quais precisam permanecer vazios.
link da conta Representa a conexão de compartilhamento de dados entre uma conta do Google Ads e outra
ad_group [grupo_de_anúncios] Um grupo de anúncios.
ad_group_ad Um anúncio de grupo.
ad_group_ad_asset_Combinação_view (em inglês) Visualização da combinação de recursos dos anúncios do grupo de anúncios. Agora, oferecemos suporte somente a adgroupAdAssetCombinationView para anúncios responsivos de pesquisa, com mais tipos de anúncios planejados para o futuro.
ad_group_ad_asset_view (em inglês) Um link entre um adgroupAd e um Asset. No momento, só há suporte para adgroupAdAssetView para AppAds.
ad_group_ad_label Uma relação entre um anúncio de grupo de anúncios e um marcador.
ad_group_asset É uma vinculação entre um grupo de anúncios e um recurso.
ad_group_audience_view (em inglês) Uma visualização do público-alvo do grupo de anúncios Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados no nível do público-alvo.
ad_group_bid_modifier (em inglês) Representa um modificador de lance do grupo de anúncios.
ad_group_critérios Um critério do grupo de anúncios.
ad_group_Criterian_customizer (em inglês) Um valor do personalizador para o CustomrAttribute associado no nível do GiB.
ad_group_critul_label Uma relação entre um critério de grupo de anúncios e um rótulo.
ad_group_critériosn_simulation (em inglês) Uma simulação de critério de grupo de anúncios. As combinações aceitas de tipo de canal de publicidade, tipo de critério, tipo de simulação e método de modificação da simulação são detalhadas abaixo, respectivamente. Operações de simulação de CPV de hotel a partir da V5. 1. DISPLAY – KEYWORD – CPC_BID – UNIFORM 2. PESQUISA - PALAVRA-CHAVE - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTÉIS - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTÉIS - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_customizer (em inglês). Um valor do personalizador para o CustomrAttribute associado no nível do grupo de anúncios.
ad_group_extension_setting Uma configuração de extensão de grupo de anúncios.
feed_do_grupo_de_anúncios Um feed de grupo de anúncios
ad_group_label [etiqueta_do_grupo_de_anúncios] Uma relação entre um grupo de anúncios e um rótulo.
ad_group_simulation (em inglês) Uma simulação de grupo de anúncios. As combinações aceitas de tipo de canal de publicidade, tipo de simulação e método de modificação da simulação são detalhadas abaixo, respectivamente. 1. PESQUISA - CPC_BID - PADRÃO 2. PESQUISA - CPC_BID - UNIFORM 3. PESQUISA – TARGET_CPA – UNIFORM 4. PESQUISA – TARGET_ROAS – UNIFORM 5. DISPLAY - CPC_BID - PADRÃO 6. DISPLAY - CPC_BID - UNIFORM 7 DISPLAY – TARGET_CPA – UNIFORM
ad_parameter Um parâmetro de anúncio usado para atualizar valores numéricos (como preços ou níveis de inventário) em qualquer linha de texto de um anúncio (incluindo URLs). Pode haver no máximo dois AdParameters por critério do grupo de anúncios. (um com parâmetro_index = 1 e outro com parâmetro_index = 2) No anúncio, os parâmetros são referenciados por um marcador do formulário "{param#:value}". Por exemplo, "{param1:$17}"
ad_schedule_view (em inglês) Uma visualização da programação de anúncios resume o desempenho das campanhas de acordo com os critérios AdSchedule.
age_range_view (em inglês) Uma visualização de faixa etária.
recurso O recurso faz parte de um anúncio, que pode ser compartilhado entre vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset), etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o utiliza.
asset_field_type_view (em inglês) Uma visualização de tipo de campo de recurso. Essa visualização informa métricas não contadas em excesso para cada tipo de campo de recurso quando o recurso é usado como extensão.
asset_group Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo de recursos. O AssetGroupSignal é usado para associar um sinal a um grupo de recursos.
asset_group_asset AssetGroupAsset é o vínculo entre um recurso e um grupo de recursos. A adição de um AssetGroupAsset vincula um recurso a um grupo de recursos.
asset_group_listing_group_filter AssetGroupListingGroupFilter representa um nó da árvore de filtros do grupo de fichas em um grupo de recursos.
asset_group_product_group_view Uma visualização do grupo de produtos do grupo de recursos.
asset_group_signal (link em inglês) AssetGroupSignal representa um sinal em um grupo de recursos. A existência de um indicador informa à campanha de maior desempenho quem está mais propenso a fazer uma conversão. As campanhas de maior desempenho usam o sinal para buscar novas pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.
asset_set Um conjunto que representa um conjunto de recursos. Use AssetSetAsset para vincular um recurso ao conjunto de recursos.
asset_set_asset AssetSetAsset é o vínculo entre um recurso e um conjunto de recursos. A adição de um AssetSetAsset vincula um recurso a um conjunto de recursos.
público-alvo O público-alvo é uma opção eficaz de segmentação. Com ele, você pode cruzar vários atributos de segmento, como informações demográficas e afinidades detalhadas, para criar públicos-alvo que representam seções dos seus segmentos.
batch_job (em inglês) Uma lista de mutações sendo processadas de forma assíncrona. As transformações são enviadas pelo usuário. As mutações por conta própria não são legíveis, e os resultados da tarefa só podem ser lidos usando AutorizarService.ListCaptureResults.
bidding_data_exclusion Representa uma exclusão de dados de lances. Consulte "Sobre exclusões de dados" em https://support.google.com/google-ads/answer/10370710.
bidding_seasonally_adjustment (em inglês) Representa um ajuste periódico para lances. Consulte "Sobre os ajustes periódicos" em https://support.google.com/google-ads/answer/10369906.
bidding_strategy Uma estratégia de lances
bidding_strategy_simulation Uma simulação da estratégia de lances. As combinações aceitas de tipo e método de modificação da simulação são detalhadas abaixo, respectivamente. 1. TARGET_CPA – UNIFORM 2. TARGET_ROAS – UNIFORM
billing_setup É uma configuração de faturamento, que associa uma conta para pagamentos e um anunciante. Uma configuração de faturamento é específica de um anunciante.
chamada_visualização Uma visualização de chamada que inclui dados para o acompanhamento de anúncios só para chamadas ou de extensões de chamada.
campanha Uma campanha
campaign_asset É um link entre uma campanha e um recurso.
campaign_asset_set CampaignAssetSet é o vínculo entre uma campanha e um conjunto de recursos. Adicionar um CampaignAssetSet vincula um conjunto de recursos a uma campanha.
campaign_audience_view (em inglês) Uma visualização do público-alvo da campanha. Inclui dados de desempenho de interesses e listas de remarketing para anúncios da Rede de Display e do YouTube, além de listas de remarketing para anúncios de pesquisa (RLSA), agregados por critério de campanha e público-alvo. Essa visualização inclui apenas públicos-alvo anexados no nível da campanha.
campaign_bid_modifier (em inglês) Representa um critério modificador de lance somente no nível da campanha.
campaign_budget O orçamento de uma campanha.
campaign_conversion_goal A configuração de lances da campanha especificada somente para todas as ações de conversão com uma categoria e uma origem correspondentes.
critérios_da_campanha Um critério de campanha.
campaign_Criterian_simulation (em inglês) Uma simulação de critério de campanha. As combinações aceitas de tipo de canal de publicidade, IDs de critérios, tipo de simulação e método de modificação de simulação estão detalhadas abaixo, respectivamente. 1. PESQUISA - 30000,30001,30002 - BID_MODIFIER - UNIFORM 2. DISPLAY - 30.001 - BID_MODIFIER - UNIFORM
campaign_customizer (em inglês). Um valor do personalizador para o CustomrAttribute associado no nível da campanha.
campaign_draft Um rascunho de campanha.
experimento_de_campanha Um experimento A/B que compara o desempenho da campanha base (o controle) e uma variação dessa campanha (o experimento).
campaign_extension_setting Uma configuração de extensão de campanha.
campaign_feed (em inglês) Um feed de campanha
campaign_group Um grupo de campanhas.
campaign_label [rótulo_de_campanha] Representa uma relação entre uma campanha e um rótulo.
campaign_shared_set CampaignSharedSets são usados para gerenciar os conjuntos compartilhados associados a uma campanha.
campaign_simulation Uma simulação de campanha As combinações aceitas de tipo de canal de publicidade, tipo de simulação e método de modificação da simulação são detalhadas abaixo, respectivamente. pesq
carrier_constant Um critério de operadora que pode ser usado na segmentação da campanha.
alterar_evento Descreve a alteração granular do recurso retornado de determinados tipos de recurso. Serão exibidas as alterações feitas pela IU, API e novas versões do Editor por usuários externos (incluindo usuários externos e internos que podem ser exibidas externamente) nos últimos 30 dias. A alteração mostra os valores antigos dos campos alterados antes da alteração e os novos valores logo após a alteração. O ChangeEvent pode ter um atraso de até três minutos para refletir uma nova alteração.
change_status (em inglês) Descreve o status do recurso retornado. O ChangeStatus pode ter um atraso de até três minutos para refletir uma nova alteração.
click_view (em inglês) Uma visualização de clique com métricas agregadas em cada nível de clique, incluindo cliques válidos e inválidos. Para campanhas que não são de pesquisa, metric.clicks representa o número de interações válidas e inválidas. As consultas que incluem ClickView precisam ter um filtro que limite os resultados a um dia e podem ser solicitadas até 90 dias antes do momento da solicitação.
combined_audience Descreva um recurso para públicos-alvo combinados que inclua públicos-alvo diferentes.
conversion_action Uma ação de conversão.
conversion_custom_variable Uma variável personalizada de conversão Consulte "Sobre as variáveis personalizadas para conversões" em https://support.google.com/google-ads/answer/9964350
conversion_goal_campaign_config Configurações de meta de conversão para uma campanha.
conversion_value_rule Uma regra de valor da conversão
conversion_value_rule_set Um conjunto de regras de valor da conversão
currency_constant (link em inglês) Uma constante de moeda.
custom_audience (em inglês) Um público-alvo personalizado Esta é uma lista de usuários por interesse.
meta_de_conversão_personalizada Meta de conversão personalizada que pode receber lances de ação arbitrárias.
custom_interest (link em inglês) Um interesse personalizado Esta é uma lista de usuários por interesse.
cliente Um cliente
customer_asset É uma vinculação entre um cliente e um recurso.
cliente_de_clientes Uma vinculação entre o cliente informado e um cliente Os CustomerClients existem apenas para clientes gerentes. Todos os clientes diretos e indiretos incluídos são incluídos, além do próprio gerente.
customer_client_link (link em inglês) Representa a relação do cliente cliente.
customer_conversion_goal Controle de lances para ações de conversão com uma categoria e uma origem correspondentes.
customer_customizer. Um valor do personalizador para o CustomrAttribute associado no nível do cliente.
customer_extension_setting Uma configuração de extensão de cliente.
feed_do_cliente Um feed de cliente.
customer_label [rótulo_do_cliente] Representa uma relação entre um cliente e um rótulo. Talvez esse cliente não tenha acesso a todos os marcadores anexados a ele. Para adicionar mais identificadores de cliente, aumente as permissões com login-customer-id.
customer_manager_link (link em inglês) Representa a relação de vinculação cliente-gerente.
cliente_negativo_de_clientes Um critério negativo para exclusões no nível do cliente.
customer_user_access Representa a permissão de um único usuário em um único cliente.
customer_user_access_invitation Representar um convite para um novo usuário nesta conta do cliente.
customizer_attribute (link em inglês) Um atributo do personalizador. Use CustomerCustomizer, CampaignCustomizer, adgroupCustomizer, ou BuilderCustomizer para associar um atributo personalizado e definir seu valor no nível de critério de cliente, campanha, grupo de anúncios ou grupo de anúncios, respectivamente.
detail_placement_view Uma visualização com métricas agregadas por grupo de anúncios e URL ou vídeo do YouTube.
detail_demografado Informações demográficas detalhadas: uma indústria específica com base em interesses a ser segmentada para alcançar usuários com base em fatos biográficos de longa duração.
display_keyword_view (em inglês) Uma visualização de palavra-chave da Rede de Display.
distance_view (distância_visualização) Uma visualização de distância com métricas agregadas pela distância do usuário em relação às extensões de local de um anunciante. Cada DistanceBucket inclui todas as impressões que estão dentro de sua distância, e uma única impressão contribuirá para as métricas de todos os DistanceBuckets que incluem a distância do usuário.
domain_category Uma categoria gerada automaticamente com o rastreamento de um domínio. Se uma campanha usar a DynamicSearchAdsSetting, as categorias de domínio serão geradas para o domínio. As categorias podem ser segmentadas usando WebpageConditionInfo. Acesse https://support.google.com/google-ads/answer/2471185.
dynamic_search_ads_search_term_view Uma visualização do termo de pesquisa dos anúncios dinâmicos de pesquisa.
expanded_landing_page_view Uma visualização da página de destino com métricas agregadas no nível do URL final expandido.
experimento Um experimento do Google Ads para os usuários testarem mudanças em várias campanhas, compararem o desempenho e aplicarem as mudanças efetivas.
experiment_arm Um experimento do Google Ads para os usuários testarem mudanças em várias campanhas, compararem o desempenho e aplicarem as mudanças efetivas.
extension_feed_item Um item do feed de extensão.
feed um feed;
item_do_feed Um item de feed.
feed_item_set Representa um conjunto de itens do feed. O conjunto pode ser usado e compartilhado entre determinados recursos do item do feed. Por exemplo, o conjunto pode ser referenciado nas funções de correspondência do CustomerFeed, CampaignFeed e adgroupFeed.
feed_item_set_link Representa uma vinculação entre um ChromeVox e um GMSMapViewSet.
feed_item_target Uma segmentação de item de feed.
feed_mapping Um mapeamento de feed.
feed_placeholder_view (em inglês) Uma visualização de marcador de feed.
gender_view Uma visualização de sexo.
geo_target_constant (link em inglês) Uma constante de segmentação por área geográfica.
Geographic_view (em inglês) Uma visualização geográfica. A visualização geográfica inclui todas as métricas agregadas no nível do país, uma linha por país. Informa as métricas na localização física real do usuário ou em uma área de interesse. Se outros campos de segmento forem usados, você poderá receber mais de uma linha por país.
group_placement_view (visualização do grupo de canais) Uma visualização em grupo de veiculações.
hotel_group_view Uma visualização de grupo de hotéis.
hotel_performance_view Uma visualização do desempenho do hotel.
hotel_reconciliation Uma reconciliação de hotel. Ele contém informações de conversão de reservas de hotéis para reconciliação com os registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes do faturamento por meio de uploads em massa.
income_range_view (link em inglês) Uma visualização da faixa de renda.
plano_de_palavra-chave Plano do Planejador de palavras-chave. Número máximo de planos de palavras-chave salvos: 10.000. Será possível remover planos se o limite for atingido.
keyword_plan_ad_group Um grupo de anúncios do Planejador de palavras-chave. Número máximo de grupos de anúncios do plano de palavras-chave por plano: 200.
keyword_plan_ad_group_keyword Uma palavra-chave do grupo de anúncios do plano de palavras-chave. Número máximo de palavras-chave do plano de palavras-chave por plano: 10.000.
campaign_plan_campaign (em inglês) Uma campanha do plano de palavra-chave Número máximo de campanhas de planos de palavras-chave por plano permitido: 1.
keyword_plan_campaign_keyword Uma palavra-chave da campanha do plano de palavras-chave. Somente palavras-chave negativas são compatíveis com a palavra-chave da campanha.
keyword_theme_constante Uma constante de tema de palavra-chave de campanha inteligente.
keyword_view Uma visualização de palavra-chave.
label Um marcador.
landing_page_view. Uma visualização da página de destino com métricas agregadas no nível do URL final não expandido.
language_constant Um idioma.
lead_form_submission_data (em inglês) Dados dos envios de formulário de lead.
eventos_ importantes Um evento importante: um setor específico com base em interesses a ser segmentado para alcançar usuários em meio a marcos importantes da vida.
location_view [visualização_do_local] Uma visualização de local resume o desempenho das campanhas de acordo com os critérios de localização.
managed_placement_view Uma visualização da seleção manual de canais.
media_file (em inglês) Um arquivo de mídia.
mobile_app_category_constant (em inglês) Uma constante de categoria de aplicativo para dispositivos móveis.
mobile_device_constant (link em inglês) Uma constante de dispositivo móvel.
off-line_user_data_job Uma vaga que contém dados off-line de visitantes da loja ou membros de listas de usuários que serão processados de forma assíncrona. Os dados carregados não são legíveis, e os resultados do processamento do job só podem ser lidos usando o GoogleAdsService.Search/SearchStream.
Operating_system_version_constant (em inglês) Uma versão do sistema operacional móvel ou uma variedade de versões, dependendo da operator_type. Lista de plataformas para dispositivos móveis disponíveis em https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
paid_organic_search_term_view (em inglês) Uma visualização dos termos de pesquisa orgânica paga, mostrando estatísticas de pesquisa em anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.
parental_status_view Visualização de status parental.
product_bidding_category_constant Uma categoria de lances do produto.
product_group_view [visualização_do_grupo_de_produtos] Uma visualização do grupo de produtos.
recommendation Uma recomendação.
remarketing_ação Uma ação de remarketing. Snippet de código JavaScript que coletará o ID do produto e o tipo de página que as pessoas acessaram (página do produto, página do carrinho de compras, página de compra, visita geral ao site) no site de um anunciante.
search_term_view (em inglês) Uma visualização de termos de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.
shared_critérios Um critério que pertence a um conjunto compartilhado.
shared_set SharedSets são usados para compartilhar exclusões de critérios em várias campanhas.
shopping_performance_view (link em inglês) Visualização de desempenho do Shopping. Fornece estatísticas da campanha do Shopping agregadas em vários níveis de dimensão do produto. Os valores de dimensão do produto no Merchant Center, como marca, categoria, atributos personalizados, condição e tipo de produto refletirão o estado de cada dimensão na data e hora em que o evento correspondente foi registrado.
smart_campaign_search_term_view Visualização de um termo de pesquisa da campanha inteligente.
configuração de campanha inteligente Configurações para configurar campanhas inteligentes.
third_party_app_analytics_link (link em inglês) Uma conexão de compartilhamento de dados que permite a importação de análises de aplicativos de terceiros para um cliente do Google Ads.
topic_constant Use tópicos para segmentar ou excluir canais da Rede de Display do Google com base na categoria em que está o canal (por exemplo, "Animais de estimação & animais; Animais/Animais de estimação/Cachorros").
topic_view (link em inglês) Uma visualização de tópico.
user_interest Interesse do usuário: uma indústria com base em interesses específica a ser segmentada.
user_list (em inglês) Uma lista de usuários. Esta é uma lista dos usuários que um cliente pode segmentar.
user_location_view Uma visualização de local do usuário. A Visualização do local do usuário inclui todas as métricas agregadas no nível do país, uma linha por país. Informa as métricas no local físico real do usuário por região de segmentação ou não. Se outros campos de segmento forem usados, você poderá receber mais de uma linha por país.
vídeo Um vídeo.
webpage_view. Uma visualização de página da Web.