Relatórios

É possível acessar uma lista de recursos e seus atributos enviando uma consulta da linguagem de consulta do Google Ads (GAQL) para o GoogleAdsService. Os recursos são representados pela entidade asset, que expõe vários campos específicos do recurso.

Atributos de recursos

A consulta GAQL a seguir lista todos os recursos em uma conta do Google Ads com o nome e o tipo de recurso.

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

É possível adicionar atributos específicos de tipo a essa consulta 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 do Google Ads filtrando o valor asset.type. Confira uma lista de valores asset.type possíveis.

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, é possível consultar métricas de recursos em cada nível respectivo. Por exemplo, ao consultar o recurso ad_group_asset, use o campo ad_group.id para segmentar os resultados e recuperar 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 informações apenas para recursos relacionados a anúncios de app, Geração de demanda e anúncios responsivos de pesquisa.

As métricas de performance no nível do anúncio para recursos são agregadas no ad_group_ad_asset_view. Essa visualização coleta métricas de recursos por anúncio individual. Portanto, a consulta dessa 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 dessa combinação específica de recurso e anúncio. A tabela a seguir enumera os valores possíveis dos campos performance_label.

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 são estatisticamente significativas o suficiente para receber um nível de performance.
PENDING	Esse recurso ainda não tem informações de performance. Isso pode acontecer porque ele ainda está em análise.
UNKNOWN	Representa o valor desconhecido nesta versão.
UNSPECIFIED	Não especificado.

A consulta GAQL a seguir retorna impressões, cliques, custos e conversões de todos os recursos em uma conta do Google Ads 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

Fonte do recurso

Asset.source só é preciso para recursos mutáveis.

Para a origem dos recursos RSA, use ad_group_ad_asset_view.source.