Recupera atributos y métricas de elementos

Atributos del elemento

Para obtener una lista de elementos y sus atributos, envía una consulta del lenguaje de consultas de Google Ads (GAQL) a Google Ads. La entidad asset representa los activos, que expone una serie de campos específicos del elemento.

La siguiente consulta de GAQL enumera todos los elementos de una cuenta del 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 específicos de un tipo que puedes agregar a la consulta anterior para leer propiedades específicas de los elementos, como ImageAsset o YoutubeVideoAsset.

Por ejemplo, en la siguiente consulta, se enumeran los ID de video de YouTube para todos los objetos YoutubeVideoAsset de una cuenta si se filtra el valor asset.type (consulta la documentación para obtener una lista de posibles tipos de valores) de 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 elementos

Las métricas de elementos se encuentran disponibles a través de los siguientes recursos:

Con estos recursos, las métricas de los elementos se pueden consultar en cada nivel correspondiente. Por ejemplo, cuando se consulta el recurso ad_group_asset, se puede usar el campo ad_group.id para segmentar los resultados y, por lo tanto, recuperar métricas para 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 elementos se agregan en el ad_group_ad_asset_view. Esta vista recopila métricas de elementos por anuncio individual. Por lo tanto, cuando se consulta esta vista, se muestra una fila por 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 sincronización de anuncios mediante elementos específicos. Los valores posibles de los campos performance_label se enumeran en la siguiente tabla.

performance_labelDescripción
BESTElementos con el mejor rendimiento
GOODElementos con buen rendimiento
LOWElementos con peor rendimiento
LEARNINGEl elemento comenzó a obtener impresiones, pero las estadísticas no tienen la importancia estadística suficiente para obtener una etiqueta de rendimiento de elementos.
PENDINGEste elemento todavía no tiene información de rendimiento. Esto puede deberse a que aún está en proceso de revisión.
UNKNOWNRepresenta un valor desconocido en esta versión.
UNSPECIFIEDNo se especifica.

La siguiente consulta de GAQL muestra impresiones, clics, costos y conversiones de todos los activos de una cuenta durante el último mes, ordenados según 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