Relatórios

Você pode obter uma lista de recursos e seus atributos enviando uma consulta do Google Ads idioma (GAQL, na sigla em inglês) para o GoogleAdsService. Recursos são representados pela entidade asset, que expõe um número de campos específicos de ativos.

Atributos de recursos

A consulta GAQL a seguir lista todos os recursos na conta de um anunciante junto com o nome e o 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 dos vídeos do YouTube para todos YoutubeVideoAsset em uma conta ao filtrando o valor asset.type (consulte a documentação para obter 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:

• ad_group_asset
• campaign_asset
• customer_asset

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

Importante :apenas o ad_group_ad_asset_view retorna informações para recursos relacionados a anúncios de aplicativo.

As métricas de desempenho dos recursos no nível do anúncio são agregadas na coluna ad_group_ad_asset_view Esta visualização coleta para recursos por anúncio individual. Assim, a consulta dessa visualização retorna uma linha por grupo de anúncios e anúncio.

O ad_group_ad_asset_view expõe as atributo específico da visualização performance_label que você fornece insights sobre as características de performance do anúncio de recursos pareamento. 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 ser impressões, mas as estatísticas não são estatisticamente significativas o suficiente para obter um rótulo de performance de recursos.
PENDING	Este recurso ainda não tem informações de desempenho. Isso pode ter acontecido porque ela ainda está em revisão.
UNKNOWN	Representa um valor desconhecido nesta versão.
UNSPECIFIED	Não especificado.

A consulta GAQL a seguir retorna impressões, cliques, custos e conversões para 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