En esta guía, se explica por qué aparecen filas con métricas nulas en los informes de la API de Google Ads y cómo excluirlas o controlarlas en tus consultas.
Métricas nulas en los resultados de la búsqueda
Cuando ejecutas una consulta, es posible que encuentres métricas de entidades que son cero. Esto podría deberse a lo siguiente:
- Las entidades no son aptas para mostrarse.
- Se pausaron dentro del período del informe.
Con los resultados de la búsqueda, a menudo querrás obtener información sobre el rendimiento de tus campañas. En este contexto, es posible que las métricas nulas no sean deseables. Para generar un informe más útil, puedes excluir explícitamente las métricas con valor cero.
Excluye las métricas con valor cero con un predicado
Un predicado es una expresión que se evalúa como TRUE, FALSE o UNKNOWN.
Los predicados se usan en la condición de búsqueda de las cláusulas WHERE en el lenguaje de consultas de Google Ads.
En la siguiente consulta, se muestra cómo quitar explícitamente las métricas nulas con un predicado:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Excluye las métricas nulas segmentando los datos
Las métricas nulas siempre se excluyen cuando se segmenta un informe, siempre que todas las métricas seleccionadas sean nulas (consulta Filas devueltas con métricas nulas).
Para segmentar un informe, se debe incluir cualquier campo segments en la cláusula SELECT de la búsqueda (filtrar por un segmento de fecha principal en WHERE sin seleccionarlo en SELECT no segmenta el informe). Por ejemplo, si segmentas un informe por segments.date, las métricas se desglosan con una fila para cada fecha. En este tipo de informe, no se muestran las fechas sin métricas.
En la siguiente búsqueda, el informe no incluirá filas de métricas nulas:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Filas devueltas con cero métricas
No se devolverán las filas cuyas métricas seleccionadas sean todas cero cuando se segmenten los datos. Por ejemplo, considera la siguiente consulta que selecciona metrics.impressions, metrics.clicks y metrics.conversions:
SELECT
ad_group_criterion.criterion_id,
metrics.impressions,
metrics.clicks,
metrics.conversions,
segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'
El informe resultante no contendrá ninguna fila en la que las tres métricas seleccionadas sean cero, pero mostrará filas en las que al menos una de las tres métricas seleccionadas sea mayor que cero.
Cuando consultas datos históricos que superan el período de retención de datos, los datos detallados con más de 37 meses de antigüedad no están disponibles y no se mostrarán filas. Las solicitudes de segmentos de fecha detallados (segments.date, segments.week y segments.hour) que abarcan rangos de más de 37 meses devuelven DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED en la versión 24 y posteriores (o DateRangeError.UNKNOWN en la versión 23). Los datos agregados de alto nivel (segments.month, segments.quarter y segments.year) se conservan durante 11 años, alineados con el inicio del siguiente período calendario completo. Por ejemplo, si el límite de 11 años de retroceso cae en 2015-03-22 (o 2015-03-01), los datos mensuales estarán disponibles a partir del primer mes calendario completo posterior al límite (2015-04-01). Consulta Períodos para obtener más detalles.