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 por a asset entidade, que expõe vários campos específicos do recurso.

Atributos de recursos

A consulta da GAQL a seguir lista todos os recursos em uma conta do Google Ads com o nome e 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 YoutubeVideoAsset objetos 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 eles, é possível consultar métricas de recursos em cada nível respectivo. Por exemplo, ao consultar o recurso ad_group_asset, é possível usar o ad_group.id campo 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

Ponto principal: a ad_group_ad_asset_view só retorna informações de 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 na ad_group_ad_asset_view. Essa visualização coleta métricas de recursos por anúncio individual. Assim, a consulta dessa visualização retorna uma linha por grupo de anúncios e anúncio.

A 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 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 rótulo 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 um valor desconhecido nesta versão.
UNSPECIFIED	Não especificado.

A consulta da GAQL a seguir retorna impressões, cliques, custos e conversões de todos os recursos em uma conta do Google Ads no último mês, classificados pelo 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 de RSA, use ad_group_ad_asset_view.source.