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

Atributos de recursos

La siguiente consulta de 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 objetos YoutubeVideoAsset de una cuenta de Google Ads filtrando el valor asset.type. Consulta una lista de valores posibles de asset.type.

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 recurso ad_group_asset, puedes 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

Punto clave: El ad_group_ad_asset_view solo devuelve 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 la tabla ad_group_ad_asset_view. Esta vista recopila las métricas de los recursos por anuncio individual. Por lo tanto, cuando se consulta esta vista, se devuelve una fila por cada grupo de anuncios y anuncio.

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 esta vinculación específica de recurso y anuncio. 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 la importancia estadística suficiente para obtener una etiqueta de rendimiento del recurso.
PENDINGEste recurso 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 devuelve 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