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

En la siguiente consulta de GAQL, se enumeran todos los recursos de la cuenta de un anunciante junto con el nombre y el tipo de valor correspondientes.

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 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 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 los posibles valores de tipo) 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 los recursos

Es posible usar una serie de valores para consultar las métricas de los recursos:

• ad_group_asset
• campaign_asset
• customer_asset

Estos valores permiten consultar las métricas de los recursos 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 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 aplicación.

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 los recursos por anuncio individual. Por lo tanto, consultar esta vista muestra una fila por grupo de anuncios y anuncio.

ad_group_ad_asset_view expone el atributo específico de la vista performance_label que brinda información sobre las características de rendimiento de esta vinculación específica de recursos y anuncios. Los valores posibles de los campos performance_label se enumeran en la siguiente tabla.

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 son lo suficientemente significativas desde el punto de vista estadístico como para obtener una etiqueta de rendimiento del recurso.
PENDING	Este recurso todavía no tiene información de rendimiento. Esto puede deberse a que aún está en proceso de revisión.
UNKNOWN	Representa un 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 recursos de una cuenta 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 precisa para los recursos mutable.

Para la fuente del uso de los recursos de RSA, usa AdGroupAdAsset.source.