Relatórios

Visão geral

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

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

Depois dessas listas, são apresentadas as tabelas com 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 está vinculado à tabela que contém os metadados:

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

Lista de todos os recursos

Tipos de recurso
accessible_bidding_strategy Representa uma visualização de BiddingStrategies que pertencem ao cliente e são compartilhadas com ele. Ao contrário de BiddingStrategy, esse recurso inclui estratégias que pertencem aos administradores do cliente e são compartilhadas com ele, além das estratégias que pertencem ao cliente. Esse recurso não fornece métricas e expõe apenas um subconjunto limitado dos atributos de BiddingStrategy.
ad_group Um grupo de anúncios.
ad_group_ad Um anúncio do grupo de anúncios.
ad_group_ad_effective_label Uma relação entre um anúncio de grupo de anúncios e um rótulo efetivo. Um rótulo efetivo é herdado ou atribuído diretamente ao anúncio do grupo de anúncios.
ad_group_ad_label Uma relação entre um anúncio de grupo de anúncios e um rótulo.
ad_group_asset Um link entre um grupo de anúncios e um recurso.
ad_group_asset_set AdGroupAssetSet é a vinculação entre um grupo de anúncios e um conjunto de recursos. A criação de um AdGroupAssetSet vincula um conjunto de recursos a um grupo de anúncios.
ad_group_audience_view Uma visualização de 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 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 Representa um modificador de lance de grupo de anúncios.
ad_group_criterion Um critério do grupo de anúncios. O relatório ad_group_criterion só retorna critérios que foram adicionados explicitamente ao grupo de anúncios.
ad_group_criterion_effective_label Uma relação entre um critério do grupo de anúncios e um rótulo efetivo. Um rótulo efetivo é herdado ou atribuído diretamente a esse critério do grupo de anúncios.
ad_group_criterion_label Uma relação entre um critério do grupo de anúncios e um rótulo.
ad_group_effective_label Uma relação entre um grupo de anúncios e um rótulo em vigor. Um rótulo efetivo é herdado ou atribuído diretamente a esse grupo de anúncios.
ad_group_label Uma relação entre um grupo de anúncios e um rótulo.
age_range_view Uma visualização de faixa etária. Representa a visualização das métricas de performance de um cliente (como impressões e cliques) agregadas por faixa etária. Todas as estatísticas são agregadas no nível do grupo de anúncios. Observação: embora seja possível segmentar métricas por faixa etária usando age_range_view ou por gênero usando gender_view, a API Search Ads 360 não permite segmentar métricas por faixa etária e gênero simultaneamente em uma única consulta. A API Search Ads 360 não permite analisar a performance das duas dimensões combinadas.
recurso O recurso é uma parte de um anúncio que pode ser compartilhada 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_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. Adicionar um AssetGroupAsset vincula um recurso a um grupo de recursos.
asset_group_listing_group_filter AssetGroupListingGroupFilter representa um nó de árvore de filtro do grupo de produtos anunciados em um grupo de recursos.
asset_group_signal AssetGroupSignal representa um indicador em um grupo de recursos. A existência de um indicador informa à campanha Performance Max quem tem mais probabilidade de fazer uma conversão. A campanha Performance Max 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.
asset_group_top_combination_view Uma visualização do uso das principais combinações de recursos do grupo de recursos.
asset_set Um conjunto de recursos que representa uma coleção de recursos. Use AssetSetAsset para vincular um recurso a um conjunto de recursos.
asset_set_asset AssetSetAsset é o link entre um recurso e um conjunto de recursos. Adicionar um AssetSetAsset vincula um recurso a um conjunto de recursos.
público-alvo O público-alvo é uma opção de segmentação eficaz que permite cruzar diferentes atributos de segmento, como informações demográficas detalhadas e afinidades, para criar públicos-alvo que representam seções dos seus grupos segmentados.
bidding_strategy Uma estratégia de lances.
campaign Uma campanha.
campaign_asset Um link 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 de público-alvo da campanha. Inclui dados de performance 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 campanha e critério de público-alvo. Essa visualização inclui apenas os públicos-alvo anexados no nível da campanha.
campaign_budget Um orçamento da campanha.
campaign_criterion Um critério de campanha.
campaign_effective_label Representa uma relação entre uma campanha e um rótulo em vigor. Um rótulo efetivo é herdado ou atribuído diretamente a essa campanha.
campaign_label Representa uma relação entre uma campanha e um rótulo.
cart_data_sales_view Visualização de vendas de dados do carrinho. Fornece informações sobre os produtos comprados se as conversões com dados do carrinho estiverem implementadas. As métricas de performance, como receita, lucro bruto, métricas de lead/venda cruzada etc., e os atributos do Merchant Center, como marca, categoria etc., estão disponíveis para produtos definidos em um feed de inventário e vendidos como resultado de anúncios do Google. Para compras atribuídas a cliques em anúncios do Shopping, as dimensões dos produtos clicados e vendidos podem ser visualizadas juntas.
conversion Uma conversão.
conversion_action Uma ação de conversão.
conversion_custom_variable Uma variável personalizada de conversão. Consulte "Sobre métricas e dimensões personalizadas do Floodlight no novo Search Ads 360" em https://support.google.com/sa360/answer/13567857
cliente Um cliente.
customer_asset Um link entre um cliente e um recurso.
customer_asset_set CustomerAssetSet é a vinculação entre um cliente e um conjunto de recursos. Adicionar um CustomerAssetSet vincula um conjunto de recursos a um cliente.
customer_client Um link entre o cliente em questão e uma relação de cliente. Os CustomerClients só existem para clientes administradores. Todas as relações de cliente diretas e indiretas estão incluídas, assim como o próprio administrador.
customer_manager_link Representa a relação de vinculação entre cliente e administrador.
dynamic_search_ads_search_term_view Uma visualização de termo de pesquisa de anúncios dinâmicos de pesquisa.
gender_view Um recurso de visualização de gênero. Representa a visualização das métricas de performance de um cliente agregadas por gênero. Todas as estatísticas são agregadas no nível do grupo de anúncios. Observação: embora seja possível segmentar métricas por faixa etária usando age_range_view ou por gênero usando gender_view, a API Search Ads 360 não permite segmentar métricas por faixa etária e gênero simultaneamente em uma única consulta. A API Search Ads 360 não permite analisar a performance das duas dimensões combinadas.
geo_target_constant Uma constante de segmentação por área geográfica.
keyword_view Uma visualização de palavra-chave.
label Um rótulo.
language_constant Um idioma.
location_view Uma visualização de local resume a performance das campanhas por um critério de local.
product_bidding_category_constant Uma categoria de lances de produtos.
product_group_view Uma visualização de grupo de produtos.
shopping_performance_view Visualização de performance do Shopping. Fornece estatísticas de campanhas Performance Max e 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, estado e tipo de produto, vão refletir o estado de cada dimensão na data e hora em que o evento correspondente foi registrado. O número de impressões e cliques para os quais o shopping_performance_view retorna estatísticas pode ser diferente dos relatórios de campanha. shopping_performance_view mostra as impressões e os cliques nos produtos que aparecem nos anúncios, enquanto os relatórios de campanha mostram as impressões e os cliques nos próprios anúncios. Dependendo do formato, um anúncio pode mostrar de zero a vários produtos, então os números podem não corresponder. Na interface do Search Ads 360, é possível consultar as impressões e os cliques de produtos que aparecem em anúncios selecionando uma coluna de "Atributos do produto" no Editor de Relatórios. Por exemplo, selecionar a coluna "Marca" equivale a selecionar segments.product_brand.
user_list Uma lista de usuários. Esta é uma lista de usuários que um cliente pode segmentar. A chave exclusiva de uma lista de usuários consiste nos seguintes campos: id. O name também precisa ser exclusivo para listas de usuários de um determinado cliente, exceto em alguns casos em que access_reason está definido como SHARED. A violação da restrição de nome exclusivo produz o erro: UserListError.INVALID_NAME.
user_location_view Uma visualização de local 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 na localização física 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.
visit Uma visita.
webpage_view Uma visualização de página da Web.