Buscando atributos e métricas de recursos

Atributos de recursos

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

A seguinte consulta do GAQL lista todos os recursos na conta de um anunciante com o nome e tipo do recurso.

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

Há atributos específicos do 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 dos vídeos do YouTube de todos os objetos YoutubeVideoAsset em uma conta filtrando o valor asset.type (consulte a documentação para ver uma lista dos 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:

• ad_group_asset
• campaign_asset
• customer_asset

Com esses recursos, 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

Importante: o ad_group_ad_asset_view retorna somente informações sobre recursos relacionados a anúncios de app.

As métricas de desempenho no nível do anúncio para recursos são agregadas em ad_group_ad_asset_view. Essa visualização coleta métricas de recursos por anúncio individual. Assim, consultar essa visualização 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 fornece insights sobre as características de desempenho desse par específico de anúncios. Os valores possíveis dos campos performance_label são enumerados na tabela a seguir.

performance_label	Descrição
BEST	Os recursos com melhor desempenho
GOOD	Recursos com bom desempenho
LOW	Recursos com pior desempenho.
LEARNING	O recurso começou a receber impressões, mas as estatísticas não são estatisticamente significativas o suficiente para receber um rótulo de desempenho do recurso.
PENDING	Este recurso ainda não tem informações de desempenho. Isso pode acontecer porque ele ainda está em análise.
UNKNOWN	Representa um valor desconhecido nesta versão.
UNSPECIFIED	Não especificado.

A seguinte consulta do GAQL retorna impressões, cliques, custos e conversões de todos os recursos em uma conta durante o último mês, classificados 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