Zero métricas

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 consultas.

Métricas zero nos resultados da pesquisa

Ao executar uma consulta, você pode encontrar métricas zero para entidades. Conheça os possíveis motivos:

  • As entidades não são qualificadas para exibição.
  • Elas foram pausadas no período do relatório.

Com os resultados da consulta, geralmente é possível saber a performance das suas campanhas. Nesse contexto, as 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 em linguagem de consulta do Google Ads.

A consulta a seguir demonstra como remover explicitamente as métricas zero com um predicado:

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

Excluir métricas zero por segmentação

As métricas zero são sempre excluídas ao segmentar um relatório, desde que todas as selecionadas métricas sejam zero (consulte Linhas retornadas com métricas zero).

A segmentação de um relatório é feita incluindo qualquer campo segments na cláusula SELECT da consulta de pesquisa. A filtragem em 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 divididas com uma linha para cada data. As datas sem métricas não são retornadas em um relatório.

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 métricas zero

As linhas cujas métricas selecionadas são todas zero não serão retornadas durante a segmentação. Por exemplo, considere a consulta a seguir 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 retenção 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 períodos 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 período de 11 anos terminar 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.

Anterior
Segmentação
Avançar
Etiquetas