Para obtener una lista de recursos y sus atributos, envía una consulta del lenguaje de consulta de Google Ads (GAQL) a GoogleAdsService. Los recursos se representan con la entidad asset, que expone una serie de campos específicos de recursos.
Atributos de recursos
La siguiente consulta de GAQL enumera todos los recursos de 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
Ten en cuenta que hay atributos de tipo específico que puedes agregar a la consulta
anterior para leer propiedades específicas de los recursos, como
ImageAsset o
YoutubeVideoAsset.
Por ejemplo, en la siguiente consulta, se enumeran los IDs de video de YouTube de todos los objetos YoutubeVideoAsset de una cuenta filtrando el valor asset.type (consulta la documentación para obtener una lista de 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:
Estos valores permiten consultar las métricas de los recursos en cada nivel correspondiente.
Por ejemplo, cuando se consulta el valor ad_group_asset, se puede usar el campo ad_group.id
para segmentar los resultados y 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. Esta vista recopila métricas de elementos por anuncio individual. Por lo tanto, si se consulta esta vista, se muestra una fila por cada grupo de anuncios y anuncio.
El ad_group_ad_asset_view expone el atributo específico de la vista performance_label que proporciona estadísticas sobre las características de rendimiento de esta combinación específica de elementos y anuncios. En la siguiente tabla, se enumeran los valores posibles de los campos performance_label.
performance_label | Descripción |
|---|---|
BEST | Recursos con el mejor rendimiento |
GOOD | Recursos con buen rendimiento |
LOW | Recursos con el peor rendimiento |
LEARNING | El recurso comenzó a recibir impresiones, pero las estadísticas no tienen importancia estadística 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 proceso de revisión. |
UNKNOWN | Representa el valor desconocido en esta versión. |
UNSPECIFIED | No se especifica. |
La siguiente consulta de GAQL muestra las impresiones, los clics, los costos y las conversiones de todos los elementos de una cuenta durante el último mes, ordenados 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