Atributos do recurso
Para ver uma lista dos recursos e dos atributos deles, envie uma consulta da Google Ads Query Language (GAQL, na sigla em inglês) ao Google AdsService. Os recursos
são representados pela entidade asset
, que expõe vários
campos específicos do recurso.
A consulta do GAQL a seguir lista todos os recursos na conta de um anunciante com o nome e o tipo de 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 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 com alguns recursos:
Com esses recursos, as métricas dos recursos podem ser consultadas em cada nível.
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 para recursos no anúncio 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
estão enumerados na tabela a seguir.
performance_label | Descrição |
---|---|
BEST | Recursos com melhor performance. |
GOOD | Recursos com boa performance. |
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 conseguir um rótulo de desempenho do recurso. |
PENDING | Este recurso ainda não tem informações de desempenho. Isso pode ter acontecido porque ele ainda está em análise. |
UNKNOWN | Representa valor desconhecido nesta versão. |
UNSPECIFIED | Não especificado. |
A consulta do GAQL a seguir 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