Informes

Para obtener una lista de los recursos y sus atributos, envía una consulta del lenguaje de consulta de Google Ads (GAQL) al 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 de la cuenta de un anunciante junto con el nombre y el 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, la siguiente consulta genera una lista de los IDs de video de YouTube para todos los objetos YoutubeVideoAsset de una cuenta. Para ello, filtra el valor asset.type (consulta la documentación para obtener una lista de posibles tipos de valores) 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 correspondientes a 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 anuncio y grupo de anuncios.

El ad_group_ad_asset_view expone el atributo específico de la vista performance_label, que brinda estadísticas sobre las características de rendimiento de esta vinculación específica de anuncios de elementos. En la siguiente tabla, se enumeran los valores posibles de los campos performance_label.

performance_labelDescripción
BESTRecursos con el mejor rendimiento
GOODRecursos con buen rendimiento.
LOWRecursos con el peor rendimiento.
LEARNINGEl recurso comenzó a obtener impresiones, pero las estadísticas no tienen importancia estadística para obtener una etiqueta de rendimiento del recurso.
PENDINGEste recurso aún 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 las impresiones, los clics, los costos y las conversiones de todos los recursos 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