Informes

Para obtener una lista de recursos y sus atributos, envía una consulta de Google Ads Language (GAQL) al GoogleAdsService. Recursos están representados por la entidad asset, que expone un número de campos específicos de recursos.

Atributos de recursos

La siguiente consulta de GAQL enumera todos los recursos de la cuenta de un anunciante junto con el nombre y 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 enumera los ID de video de YouTube para todos YoutubeVideoAsset en una cuenta por filtrando el valor asset.type (consulta el documentación para obtener una lista de posibles valores de tipo) 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 para los recursos se agregan ad_group_ad_asset_view Esta vista recopila para los recursos por anuncio individual. Por lo tanto, consultar esta vista devuelve una fila por grupo de anuncios y anuncio.

El objeto ad_group_ad_asset_view expone atributo específico de la vista performance_label que Proporciona estadísticas sobre las características de rendimiento de este anuncio de recurso específico sincronizada. Se enumeran los valores posibles de los campos performance_label en la siguiente tabla.

performance_labelDescripción
BESTRecursos con el mejor rendimiento
GOODRecursos con buen rendimiento
LOWRecursos con el peor rendimiento
LEARNINGEl recurso comenzó a recibir impresiones, pero las estadísticas no son lo suficientemente significativas estadísticamente para obtener una etiqueta de rendimiento de activo.
PENDINGEste recurso todavía no tiene información de rendimiento. Esto puede deberse a que aún está en proceso de revisión.
UNKNOWNRepresenta el valor desconocido en esta versión.
UNSPECIFIEDNo se especifica.

La siguiente consulta de GAQL muestra impresiones, clics, costos y conversiones para 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