Informes

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 asset entidad, que expone varios campos específicos del recurso.

Atributos de recursos

La siguiente consulta GAQL enumera todos los recursos en una cuenta de Google Ads junto con el nombre y el tipo de valor correspondientes.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Puedes agregar atributos de tipo específico 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 videos de YouTube de todos los YoutubeVideoAsset objetos de una cuenta de Google Ads filtrando el valor de asset.type. Consulta una lista de los valores asset.type posibles.

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 consultas el valor ad_group_asset, puedes usar el ad_group.id campo 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

Punto clave: ad_group_ad_asset_view solo muestra información de los recursos relacionados con los anuncios de aplicaciones, las campañas de generación de demanda y los anuncios de búsqueda responsivos.

Las métricas de rendimiento a nivel del anuncio para los recursos se agregan en el ad_group_ad_asset_view. Esta vista recopila métricas de los recursos por anuncio individual. Por lo tanto, la consulta de esta vista muestra una fila por grupo de anuncios y anuncio.

The 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 emparejamiento específico de anuncio y recurso. 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 son lo suficientemente significativas desde el punto de vista estadístico 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 GAQL muestra las impresiones, los clics, los costos y las conversiones de todos los recursos de una cuenta de Google Ads 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 mutables.

Para la fuente de los recursos de RSA, usa ad_group_ad_asset_view.source.

Anterior
Subir vídeos