Este guia explica por que as linhas com métricas zero aparecem nos relatórios da API Google Ads e como excluí-las ou processá-las nas suas consultas.
Métricas zero nos resultados da pesquisa
Ao executar uma consulta, você pode encontrar métricas de entidades que são zero. Conheça os possíveis motivos:
- As entidades não estão qualificadas para exibição.
- Elas foram pausadas dentro do período do relatório.
Com os resultados da consulta, muitas vezes você quer obter informações sobre a performance das suas campanhas. Nesse contexto, métricas zero podem não ser desejáveis. Para gerar um relatório mais útil, você pode excluir explicitamente as métricas zero.
Excluir métricas zero com um predicado
Um predicado é uma expressão que é avaliada como TRUE, FALSE ou UNKNOWN.
Os predicados são usados na condição de pesquisa das cláusulas WHERE na Linguagem de consulta do Google Ads.
A consulta a seguir demonstra como remover explicitamente métricas zero com um predicado:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Excluir métricas zero segmentando
As métricas zero são sempre excluídas ao segmentar um relatório, desde que todas as métricas selecionadas sejam zero. Consulte Linhas retornadas com métricas zero.
Para segmentar um relatório, inclua qualquer campo segments na cláusula SELECT da consulta de pesquisa. Filtrar por um segmento de data principal em WHERE sem selecioná-lo em SELECT não segmenta o relatório. Por exemplo, se você segmentar um relatório por segments.date, as métricas serão detalhadas com uma linha para cada data. Datas sem métricas não são retornadas em um relatório desse tipo.
Para a consulta a seguir, o relatório não vai incluir linhas de métrica zero:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Linhas retornadas com zero métricas
As linhas em que todas as métricas selecionadas são zero não serão retornadas ao segmentar. Por
exemplo, considere a seguinte consulta que seleciona metrics.impressions,
metrics.clicks e 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'
O relatório resultante não vai conter linhas em que todas as três métricas selecionadas sejam zero, mas vai retornar linhas em que pelo menos uma das três métricas selecionadas seja maior que zero.
Ao consultar dados históricos além do período de armazenamento de dados, os dados granulares com mais de 37 meses não ficam disponíveis e não retornam linhas. As solicitações de segmentos de data granulares (segments.date, segments.week e segments.hour) que abrangem intervalos com mais de 37 meses retornam DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED na v24 e versões mais recentes (ou DateRangeError.UNKNOWN na v23). Os dados agregados de alto nível (segments.month, segments.quarter e segments.year) são retidos por 11 anos, alinhados ao início do próximo período completo do calendário. Por exemplo, se o corte de 11 anos for em 2015-03-22 (ou 2015-03-01), os dados mensais estarão disponíveis a partir do primeiro mês civil completo após o corte (2015-04-01). Consulte Períodos para mais detalhes.