Relatórios

Visão geral

Essas 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, as listas a seguir são exibidas:

  • 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 vão segmentar métricas quando incluídos nas mesmas cláusulas SELECT e WHERE desses campos de recursos

As tabelas consistem em nomes de campos de recursos, segmentos e métricas que podem ser incluídos em uma consulta de pesquisa quando esses recursos são especificados na cláusula FROM. Cada nome está vinculado à tabela que contém os metadados dele:

  • 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 de BiddingStrategies que pertence ao cliente e a compartilha com o cliente. Diferentemente da BiddingStrategy, este recurso inclui estratégias que pertencem aos gerentes do cliente e foram compartilhadas com ele, além das estratégias pertencentes a esse cliente. Este recurso não oferece 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 em si, além das alterações aprovadas mais recentemente no orçamento e das propostas propostas com aprovação pendente. As alterações propostas com aprovação pendente, se houver, são encontradas em 'proposta_pendente' Detalhes eficazes sobre o orçamento são encontrados em campos com prefixo "#39;approval_', 'adjusted_' e aqueles sem prefixo". Como alguns detalhes eficazes podem ser diferentes do que o usuário solicitou (por exemplo, o limite de gastos), essas diferenças são empilhadas usando os campos 'proposed_', 'approval_' e possivelmente 'adjusted_'. Esse recurso é modificado usando AccountBudgetProposal e não pode ser transformado diretamente. Um orçamento pode ter no máximo uma proposta pendente a qualquer momento. Ele é lido em pending_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 'Aprovado' e 'adjusted' , que seriam idênticos.
account_budget_proposta Uma proposta de orçamento em nível de conta. Nem todos os campos prefixados com 'proposed' podem não ser aplicados diretamente. Por exemplo, os limites de gasto propostos podem ser ajustados antes da aplicação. Isso acontecerá se o campo 'proposed' tiver uma contraparte &&39;aprovado' por exemplo, limites de gastos. O tipo de proposta (proposta_tipo) muda os campos que são obrigatórios e os que precisam permanecer vazios.
account_link [link_da_conta] Representa a conexão de compartilhamento de dados entre uma conta do Google Ads e outra
grupo de anúncios [ad_group] Um grupo de anúncios.
ad_group_ad Um anúncio de grupo de anúncios.
ad_group_ad_asset_Combine_view Uma visualização do uso da combinação de recursos do anúncio do grupo de anúncios. Agora, oferecemos suporte apenas para adgroupAdAssetCombinationView para anúncios responsivos de pesquisa, com mais tipos de anúncio planejados para o futuro.
ad_group_ad_asset_view Uma vinculação entre um grupo de anúncios e um recurso. No momento, só há suporte para adgroupAdAssetView para AppAds.
ad_group_ad_label Uma relação entre um anúncio do grupo de anúncios e um rótulo.
ad_group_asset Uma vinculação entre um grupo de anúncios e um recurso.
ad_group_audience_view Uma visualização de 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 da Rede do YouTube e listas de remarketing para anúncios de pesquisa (RLSA) agregadas no nível do público-alvo.
ad_group_bid_modifier (link em inglês) Representa um modificador de lances do grupo de anúncios.
ad_group_criterian (em inglês) É 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_criterian_label Uma relação entre um critério de grupo de anúncios e um rótulo.
ad_group_criterian_simulation (em inglês) Uma simulação do critério do 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 estão detalhadas abaixo, respectivamente. Operações de simulação de protobuf do hotel a partir da V5. 1. DISPLAY - PALAVRA-CHAVE - CPC_BID - UNIFORM 2 PESQUISA – PALAVRA-CHAVE – CPC_BID – UNIFORM 3. SHOPPING – LISTING_GROUP – CPC_BID – UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5 HOTEL - 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.
ad_group_feed (em inglês) Um feed de grupo de anúncios.
ad_group_label [rótulo_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 estã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, incluindo URLs. Pode haver no máximo dois AdParameters por critério de grupo de anúncios. (um com parâmetro_index = 1 e um 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 Uma visualização da programação de anúncios resume o desempenho das campanhas por critérios de AdSchedule.
age_range_view Uma visualização de faixa etária.
recurso O recurso é 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 está usando.
asset_field_type_view Uma visualização de tipo de campo de recurso. Essa visualização informa métricas não registradas em excesso para cada tipo de campo de recurso quando o recurso é usado como extensão.
grupo de recursos [asset_group] Um grupo de recursos. AssetGroupAsset é usado para vincular um recurso ao grupo de recursos. AssetGroupSignal é usado para associar um indicador a um grupo de recursos.
asset_group_asset AssetGroupAsset é o link 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 de grupo de produtos do grupo de recursos.
asset_group_signal (em inglês) AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha de maior desempenho quem tem maior probabilidade de conversão. A campanha de maior desempenho usa o indicador para procurar outras pessoas com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais.
set_do_recurso Um conjunto de recursos que representa um conjunto de recursos. Use AssetSetAsset para vincular um recurso ao conjunto de recursos.
asset_set_asset AssetSetAsset é a vinculação entre um recurso e um conjunto de recursos. Adicionar um AssetSetAsset vincula um recurso a um conjunto de recursos.
público O público-alvo é uma opção de segmentação eficaz. 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 segmentados.
batch_job (em inglês) Uma lista de mutações sendo processados de forma assíncrona. Os muts são enviados pelo usuário. As mutações em si não são legíveis, e os resultados da tarefa só podem ser lidos usando FirebaseUIService.ListAlbumResults.
bidding_data_exclusion Representa uma exclusão de dados dos lances. Consulte "Sobre exclusões de dados" em https://support.google.com/google-ads/answer/10370710.
bidding_seasonality_adjustment Representa um ajuste periódico de lance. Consulte "Sobre ajustes periódicos" em https://support.google.com/google-ads/answer/10369906.
Estratégia de lances Uma estratégia de lances.
bidding_strategy_simulation Uma simulação da estratégia de lances As combinações aceitas de tipo de simulação 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 para cada anunciante.
call_view Uma vista de chamadas que inclui dados para acompanhamento de anúncios só para chamadas ou extensões de chamada.
campanha uma campanha.
campaign_asset Uma vinculação entre uma campanha e um recurso.
campaign_asset_set CampaignAssetSet é a vinculação entre uma campanha e um conjunto de recursos. Adicionar um CampaignAssetSet vincula um conjunto de recursos a uma campanha.
campaign_audience_view 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 da Rede do YouTube e listas de remarketing para anúncios de pesquisa (RLSA), agregadas 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 (link em inglês) Representa um critério exclusivo de lance que pode ser modificado no nível da campanha.
campaign_budget (em inglês) O orçamento de uma campanha.
campaign_conversion_goal A configuração de lances para a 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 da campanha.
campaign_criterian_simulation Simulação de critério de campanha. As combinações aceitas de tipo de canal de publicidade, IDs de critério, tipo de simulação e método de modificação da 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_rascunho Um rascunho de campanha.
campaign_experiment (em inglês) 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 (em inglês) Um grupo de campanhas.
campaign_label [rótulo_da_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 estão detalhadas abaixo, respectivamente. PESQUISA - CPC_BID - PESQUISA UNIFORM - CPC_BID - PESQUISA EM ESCALA - TARGET_CPA - PESQUISA UNIFORM - TARGET_CPA - PESQUISA - PESQUISA - TARGET_ROAS - PESQUISA UNIFORM - TARGET-FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UN FORM - UNI FORM - UNI FORM -
carrier_constant Um critério de operadora que pode ser usado na segmentação da campanha.
change_event 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 (inclusive usuários externos e usuários internos que possam ser mostradas 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 até três minutos de atraso para refletir uma nova alteração.
status_da_alteração 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 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 para datas anteriores a 90 dias antes 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 (em inglês) Uma variável personalizada de conversão Consulte "Sobre 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 do valor da conversão
currency_constant Uma constante de moeda.
custom_audience Um público-alvo personalizado Esta é uma lista de usuários por interesse.
custom_conversion_goal Meta de conversão personalizada que pode receber lances arbitrários de ações de conversão.
custom_interest Um interesse personalizado Esta é uma lista de usuários por interesse.
cliente Cliente.
customer_asset Uma vinculação entre um cliente e um recurso.
customer_client (cliente) Um vínculo entre o cliente especificado e um cliente Os ClientCustomers existem apenas para clientes gerentes. Todos os clientes diretos e indiretos incluídos são incluídos, assim como o próprio administrador.
customer_client_link [link_cliente_do_cliente] Representa a relação de vinculação do cliente do 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.
Customer_feed (em inglês) Um feed de clientes.
customer_label [rótulo_do_cliente] Representa uma relação entre um cliente e um rótulo. Talvez este cliente não tenha acesso a todos os marcadores anexados. Outros identificadores de cliente podem ser retornados ao aumentar as permissões com o login-cliente-ID.
customer_manager_link [link_do_gerente_de_cliente] Representa a relação de vinculação cliente-gerente.
cliente_critérios_negativos É 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 de cliente;
customizer_attribute Um atributo do personalizador. Use CustomerCustomizer, CampaignCustomizer, adgroupCustomizer, ou DrawableCustomizer para associar um atributo personalizador e definir o 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_demographic Informações demográficas detalhadas: uma indústria 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 Uma visualização de palavra-chave da Rede de Display.
distance_view Uma visualização de distância com métricas agregadas pela distância do usuário até as extensões de local do anunciante. Cada DistanceBucket inclui todas as impressões que se enquadram em 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 usa a DynamicSearchAdsSetting, as categorias de domínio sã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 de termo de pesquisa de anúncios dinâmicos de pesquisa.
expand_landing_page_view Uma visualização de página de destino com métricas agregadas no nível do URL final expandido.
experimento Um experimento do Google Ads que permite que os usuários testem mudanças em várias campanhas, comparem o desempenho e apliquem as mudanças efetivas.
experiment_arm (link em inglês) Um experimento do Google Ads que permite que os usuários testem mudanças em várias campanhas, comparem o desempenho e apliquem as mudanças efetivas.
extension_feed_item Um item de feed de extensão.
feed Um feed.
item_do_feed Um item de feed.
set_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 correspondentes de CustomerFeed, CampaignFeed e adgroupFeed.
feed_item_set_link Representa uma vinculação entre um SLO e um SLOSet.
feed_item_target Um destino de item de feed.
feed_mapping (em inglês) Um mapeamento de feed.
feed_placeholder_view Uma visualização de marcador de posição de feed.
gender_view Uma visualização de gênero.
geo_target_constant Uma constante de segmentação por área geográfica.
Ponto de vista geográfico 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. Ele registra as métricas em uma localização física real do usuário ou em uma área de interesse. Se outros campos de segmento forem usados, você poderá ter mais de uma linha por país.
group_placement_view Uma visualização da veiculação em grupo.
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 das reservas de hotel para reconciliação com registros do anunciante. Essas linhas podem ser atualizadas ou canceladas antes do faturamento por meio de uploads em massa.
income_range_view Uma visualização de faixa de renda.
palavra-chave_plano um plano do Planejador de palavras-chave; Número máximo de planos de palavras-chave salvos: 10.000. É possível remover planos se o limite for atingido.
grupo de anúncios [palavra_plano_de_palavra-chave] Um grupo de anúncios do Planejador de palavras-chave. Número máximo de grupos de anúncios de 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 palavras-chave. Número máximo de campanhas de plano de palavras-chave por plano permitido: 1.
palavra-chave_plano_de_campanha_palavra-chave 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_constant Uma constante de tema de palavra-chave das campanhas inteligentes.
view_view Uma visualização de palavra-chave.
label Um marcador.
landing_page_view Uma visualização de 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 Dados de envios de formulário de lead.
life_event (em inglês) Um evento importante: uma indústria específica com base em interesses a ser segmentada para alcançar usuários em meio a marcos importantes da vida.
location_view Uma visualização de local resume o desempenho das campanhas por critério de local.
view_placement_view Uma visualização de canal gerenciada.
file_file (em inglês) Um arquivo de mídia.
mobile_app_category_constant Uma constante de categoria de aplicativo para dispositivos móveis.
mobile_device_constant Uma constante de dispositivo móvel.
Offline_user_data_job Uma vaga que contém dados do usuário off-line de visitantes da loja ou membros de uma lista 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 da vaga só podem ser lidos usando o GoogleAdsService.Search/SearchStream.
Operand_system_version_constant Uma versão do sistema operacional para dispositivos móveis ou uma variedade de versões, dependendo do 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. Uma visualização paga de termos de pesquisa orgânica que fornece uma visualização das estatísticas de pesquisa de anúncios e listagens orgânicas agregadas por termo de pesquisa no nível do grupo de anúncios.
parental_status_view Uma visualização de status parental.
product_bidding_category_constant Uma categoria de lances de produto.
product_group_view Uma visualização de 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) em um site do anunciante.
search_term_view Uma visualização de termo de pesquisa com métricas agregadas por termo de pesquisa no nível do grupo de anúncios.
critérios_compartilhados Um critério que pertence a um conjunto compartilhado.
shared_set SharedSets é usado para compartilhar exclusões de critério em várias campanhas.
shopping_performance_view Visã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 do 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.
campaign_search_term_view Uma visualização de termos de pesquisa de campanhas inteligentes.
Configuração inteligente de campanhas inteligentes Definições para configurar campanhas inteligentes.
Terceiro_app_analytics_link 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 na Rede de Display do Google com base na categoria em que o canal se enquadra (por exemplo, "Pets & Animais/Animais de estimação/Cachorros").
topic_view Uma visualização de tópico.
user_interest Um interesse do usuário: uma indústria com base em interesses a ser segmentada.
lista_de_usuários Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar.
user_location_view Uma visualização de local do usuário. Ela 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 região de segmentação ou não. Se outros campos de segmento forem usados, você poderá ter mais de uma linha por país.
vídeo Um vídeo.
page_view Uma visualização de página da Web.