Esta página foi traduzida pela API Cloud Translation.

Relatórios

Para consultar uma lista de recursos e os atributos deles, envie uma consulta da Linguagem de consulta do Google Ads (GAQL, na sigla em inglês) para o serviço GoogleAdsService. Os recursos são representados pela entidade asset, que expõe vários campos específicos deles.

Atributos de recursos

A consulta GAQL a seguir lista todos os recursos na conta de um anunciante, além do nome e tipo do recurso.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Há atributos específicos de tipo que podem ser adicionados à consulta acima para ler propriedades específicas de recursos como ImageAsset ou YoutubeVideoAsset.

Por exemplo, a consulta a seguir lista os IDs de vídeos do YouTube para todos os objetos YoutubeVideoAsset em uma conta filtrando o valor asset.type (consulte a documentação para uma lista de possíveis valores de tipo) para YoutubeVideoAsset.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Métricas de recursos

As métricas de recursos são disponibilizadas por meio de alguns recursos:

Com eles, as métricas de recursos podem ser consultadas em cada nível respectivo. Por exemplo, ao consultar o recurso ad_group_asset, o campo ad_group.id pode ser usado para segmentar os resultados, recuperando métricas para cada combinação exclusiva de ad_group e asset:

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

Métricas no nível do anúncio

As métricas de performance dos recursos no nível do anúncio são agregadas no ad_group_ad_asset_view. Essa visualização coleta métricas de recursos por anúncio individual. Assim, essa consulta retorna uma linha por grupo de anúncios e anúncio.

O ad_group_ad_asset_view expõe o atributo específico da visualização performance_label, que oferece insights sobre as características de performance desse pareamento específico de recurso e anúncio. Os valores possíveis dos campos performance_label são enumerados na tabela a seguir.

`performance_label`	Descrição
`BEST`	Recursos com melhor performance.
`GOOD`	Recursos com boa performance.
`LOW`	Recursos com pior performance.
`LEARNING`	O recurso começou a receber impressões, mas as estatísticas não têm significância estatística o suficiente para receber um rótulo de performance do recurso.
`PENDING`	Esse recurso ainda não tem informações de desempenho. Isso pode ter acontecido porque ele ainda está em revisão.
`UNKNOWN`	Representa um valor desconhecido nesta versão.
`UNSPECIFIED`	Não especificado.

A seguinte consulta da GAQL retorna impressões, cliques, custos e conversões de todos os recursos em uma conta durante o último mês, ordenados por performance_label:

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

Recursos automáticos

Recursos