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:
categorydata typetype URLfilterableselectablesortablerepeated
- Filtrável
- Esta linha indica se o campo pode ser usado nas condições da cláusula
WHEREda consulta. - Selecionável
- Esta linha indica se o campo pode ser especificado na cláusula
SELECTda consulta. - Sortable
- Esta linha indica se o campo pode ser classificado e usado na
cláusula
ORDER BYda 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. |