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 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
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 video de YouTube de todos los
YoutubeVideoAsset objetos de una cuenta
filtrando el valor de asset.type. Consulta una lista de
valores de tipo posibles) 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 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
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.
El 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 par específico de recurso y anuncio. En la siguiente tabla, se enumeran los valores posibles de los campos performance_label.
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 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. |
PENDING | Este recurso aún 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 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 preciso para
mutable
recursos.
Para la fuente de uso de los recursos de RSA, usa,
AdGroupAdAsset.source.