Zero métricas

Neste guia, explicamos 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 para entidades que são zero. Conheça os possíveis motivos:

• As entidades não estão qualificadas para exibição.
• Eles foram pausados no período do relatório.

Com os resultados da consulta, você geralmente quer obter informações sobre a performance das suas campanhas. Nesse contexto, métricas zeradas podem não ser desejáveis. Para produzir um relatório mais útil, exclua explicitamente as métricas zero.

Excluir métricas zero com um predicado

Um predicado é uma expressão que resulta em 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 zeradas por segmentação

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 um segmento principal de data 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. As datas sem métricas não são retornadas nesse relatório.

Para a consulta a seguir, o relatório não vai incluir linhas com métricas zeradas:

SELECT
  campaign.name,
  metrics.impressions,
  segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Linhas retornadas com métricas zero

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 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 ficam indisponí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 anteriores a 37 meses retornam DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED na v24 e em 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 limite de análise de 11 anos cair em 2015-03-22 (ou 2015-03-01), os dados mensais estarão disponíveis a partir do primeiro mês completo após o limite (2015-04-01). Consulte Períodos para mais detalhes.

Supressão de métricas de alcance e valores zero

Além das entidades que não veicularam impressões, as métricas de alcance (como metrics.unique_users e as métricas de intervalo de frequência de metrics.unique_users_two_plus a metrics.unique_users_ten_plus) podem aparecer como zero ou ser omitidas quando os dados de alcance são suprimidos. A métrica metrics.unique_users (e metrics.unique_users_info) é compatível com campanhas de display, de vídeo, Geração de Demanda e para apps, enquanto as métricas de intervalo de frequência metrics.unique_users_*_plus (e metrics.unique_users_*_plus_info) se aplicam a campanhas de vídeo.

A supressão de alcance acontece por vários motivos:

• Limites de privacidade: os dados de alcance são suprimidos quando o número de usuários não atende aos limites de privacidade (como k-anonimato) para proteger a identidade do usuário.
• Limites de qualidade: os dados de alcance poderão ser retidos se não atenderem aos padrões de qualidade.
• Retenção de dados: os dados históricos de alcance são retidos por 3 anos (36 meses). As consultas que abrangem datas além dessa janela de retenção de 3 anos não podem retornar métricas de alcance. As consultas que abrangem datas entre 36 e 37 meses atrás são concluídas sem retornar o DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED descrito na seção anterior, mas omitem as métricas de alcance e retornam DATE_RANGE_BEYOND_RETENTION quando os metadados de alcance complementar são selecionados.

Na v26 e em versões mais recentes, cada métrica de alcance de usuário único tem um campo de metadados complementar do tipo ReachMetricInfo (como metrics.unique_users_info e metrics.unique_users_two_plus_info até metrics.unique_users_ten_plus_info).

Na Linguagem de consulta do Google Ads (GAQL), os campos de alcance complementar são métricas MESSAGE selecionadas diretamente na cláusula SELECT (por exemplo, metrics.unique_users_info). Não anexe .reach_metric_states na cláusula SELECT, porque a seleção de campos de mensagem aninhados na GAQL falha com UNRECOGNIZED_FIELD. Em vez disso, selecionar metrics.unique_users_info retorna uma mensagem ReachMetricInfo que contém o campo de tipo enumerado repetido reach_metric_states do tipo ReachMetricState, que descreve se a métrica foi suprimida ou está completa.

Sempre que uma métrica de alcance é suprimida ou está fora da janela de retenção (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION ou DATE_RANGE_BEYOND_RETENTION), o campo optional int64 em Metrics é desativado (o que resulta em 0 se a presença do campo não for verificada), enquanto LOW_QUALITY ainda preenche a métrica numérica:

• COMPLETE: a métrica de alcance está completa, sem supressão.
• PRIVACY_SUPPRESSION: os dados de alcance foram suprimidos devido a restrições de privacidade.
• QUALITY_SUPPRESSION: os dados de alcance foram suprimidos por motivos de qualidade de dados.
• LOW_QUALITY: a métrica de alcance foi calculada, mas está sinalizada como de baixa qualidade.
• DATE_RANGE_BEYOND_RETENTION: as métricas de alcance não estão disponíveis porque o período está fora do limite de retenção de dados de 3 anos para dados de alcance.

Ao selecionar a métrica de alcance e o campo de metadados associado, seu aplicativo pode distinguir entre o alcance zero real e os valores de alcance que foram suprimidos:

SELECT
  campaign.id,
  campaign.name,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Observação: os campos de metadados de alcance complementar (metrics.unique_users*_info) são métricas MESSAGE com filterable: false e sortable: false, portanto, não podem ser usados em cláusulas WHERE ou ORDER BY. Além disso, as métricas de alcance não podem ser agregadas entre as linhas. A métrica metrics.unique_users só pode ser solicitada para períodos de até 92 dias, enquanto as métricas de intervalo de frequência unique_users_*_plus só podem ser solicitadas para períodos de até 31 dias. Consulte Relatórios de alcance e frequência da campanha para ver a lista completa de métricas de alcance e frequência de vídeo.