Questa guida spiega perché le righe con metriche pari a zero vengono visualizzate nei report dell'API Google Ads e come escluderle o gestirle nelle query.
Metriche pari a zero nei risultati di ricerca
Quando esegui una query, potresti riscontrare metriche pari a zero per le entità. I motivi potrebbero essere i seguenti:
- Le entità non sono idonee per la visualizzazione.
- Sono state messe in pausa nell'intervallo di date del report.
Con i risultati delle query, spesso vuoi ottenere informazioni sul rendimento delle tue campagne. In questo contesto, le metriche pari a zero potrebbero non essere auspicabili. Per generare un report più utile, puoi escludere esplicitamente le metriche pari a zero.
Escludere le metriche pari a zero con un predicato
Un predicato è un'espressione che restituisce TRUE, FALSE o UNKNOWN.
I predicati vengono utilizzati nella condizione di ricerca delle clausole WHERE nel
linguaggio di query Google Ads.
La seguente query mostra come rimuovere esplicitamente le metriche pari a zero con un predicato:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Escludere le metriche pari a zero mediante la segmentazione
Le metriche pari a zero vengono sempre escluse durante la segmentazione di un report, a condizione che tutte le metriche selezionate siano pari a zero (vedi Righe restituite con metriche pari a zero).
La segmentazione di un report viene eseguita includendo qualsiasi campo segments nella clausola SELECT
della query di ricerca (il filtro su un segmento di date principale in WHERE senza
selezionarlo in SELECT non segmenta il report). Ad esempio, se segmenti un report in base a segments.date, le metriche vengono suddivise in una riga per ogni data. Le date senza metriche non vengono restituite in questo tipo di report.
Per la seguente query, il report non includerà le righe con metrica pari a zero:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Righe restituite con zero metriche
Le righe le cui metriche selezionate sono tutte pari a zero non verranno restituite durante la segmentazione. Ad
esempio, considera la seguente query che seleziona 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'
Il report risultante non conterrà righe in cui tutte e tre le metriche selezionate sono pari a zero, ma restituirà righe in cui almeno una delle tre metriche selezionate è maggiore di zero.
Quando esegui query sui dati storici oltre il
periodo di conservazione dei dati, i dati granulari più vecchi di 37 mesi
non sono disponibili e non restituiscono righe. Le richieste di segmenti di date granulari
(segments.date, segments.week e segments.hour) che coprono intervalli precedenti
a 37 mesi restituiscono DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED
nella versione 24 e successive (o DateRangeError.UNKNOWN nella versione 23). I dati aggregati di alto livello (segments.month, segments.quarter e segments.year) vengono conservati per 11 anni, in linea con l'inizio del periodo di calendario completo successivo. Ad esempio, se il limite di ricerca di 11 anni cade il giorno 2015-03-22 (o 2015-03-01), i dati mensili sono disponibili a partire dal primo mese di calendario completo successivo al limite (2015-04-01). Per maggiori dettagli, consulta Intervalli di date.