Para obtener una lista de recursos y sus atributos, envía una consulta con el lenguaje de consultas de Google Ads (GAQL) a GoogleAdsService. Los recursos se representan con la entidad asset, que expone varios campos específicos del recurso.
Atributos de recursos
La siguiente consulta de GAQL enumera todos los recursos en la cuenta de un anunciante junto con su nombre y tipo de recurso.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Puedes agregar atributos específicos del tipo a esta consulta para leer propiedades específicas de los recursos, como ImageAsset o YoutubeVideoAsset.
Por ejemplo, en la siguiente consulta, se enumeran los IDs de los videos de YouTube de todos los objetos YoutubeVideoAsset de una cuenta filtrando el valor asset.type. Consulta una lista de los valores de tipo posibles) 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 los recursos
Es posible usar una serie de valores para consultar las métricas de los recursos:
Con estos recursos, puedes consultar las métricas de los recursos en cada nivel correspondiente.
Por ejemplo, cuando consultas el recurso ad_group_asset, puedes usar el campo ad_group.id para segmentar los resultados y, de este modo, recuperar las métricas de cada combinación única de ad_group y 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 a nivel del anuncio
Las métricas de rendimiento a nivel del anuncio para los recursos se agregan en ad_group_ad_asset_view. En esta vista, se recopilan métricas de los recursos por anuncio individual. Por lo tanto, si consultas esta vista, se mostrará una fila por cada grupo de anuncios y anuncio.
El objeto ad_group_ad_asset_view expone el atributo específico de la vista performance_label, que proporciona información sobre las características de rendimiento de este par específico de recurso y anuncio. En la siguiente tabla, se enumeran los valores posibles de los campos performance_label.
performance_label | Descripción |
|---|---|
BEST | Son los recursos con el mejor rendimiento. |
GOOD | Recursos con buen rendimiento |
LOW | Recursos con el peor rendimiento |
LEARNING | El recurso comenzó a obtener impresiones, pero las estadísticas no son lo suficientemente significativas como para obtener una etiqueta de rendimiento del recurso. |
PENDING | Este recurso aún no tiene información de rendimiento. Esto puede deberse a que aún está en revisión. |
UNKNOWN | Representa un valor desconocido en esta versión. |
UNSPECIFIED | No se especifica. |
La siguiente consulta de GAQL devuelve las impresiones, los clics, los costos y las conversiones de todos los recursos de una cuenta durante el último mes, ordenados por su 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
Fuente del recurso
Asset.source solo es preciso para los recursos de mutable.
Para la fuente de uso de los recursos de RSA, usa AdGroupAdAsset.source.