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