É 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 asset entidade, que expõe vários
campos específicos do recurso.
Atributos de recursos
A consulta GAQL a seguir lista todos os recursos na conta de um anunciante 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,
filtrando o valor asset.type. Consulte uma lista de
valores de tipo possíveis) 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, é 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
As métricas de performance no nível do anúncio para recursos são agregadas em
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 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 um 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 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
Fonte dos recursos
Asset.source só é preciso para
mutable
recursos.
Para a origem dos recursos de RSA, use,
AdGroupAdAsset.source.