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_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 estadísticamente para obtener una etiqueta de rendimiento de activo. |
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 el valor desconocido en esta versión. |
UNSPECIFIED | No 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