Você pode ver uma lista de recursos e seus atributos enviando uma consulta da 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.
Atributos de recursos
A consulta do GAQL a seguir lista todos os recursos na conta de um anunciante junto 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 de vídeo do YouTube para todos os objetos YoutubeVideoAsset
em uma conta, filtrando o valor asset.type
(consulte a documentação para ver 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:
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
As métricas de desempenho 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. 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 o
atributo específico de 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 | 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 importantes o suficiente para receber 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 revisão. |
UNKNOWN | Representa um 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 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