Intervalli di date

Il linguaggio di query Google Ads ti consente di specificare l'intervallo di date nei seguenti modi:

• Intervallo di date personalizzato
• Intervallo di date predefinito
• Periodo di tempo predefinito
• Limiti di ricerca storica

Intervallo di date personalizzato

Puoi specificare le date nel formato ISO 8601 esteso (YYYY-MM-DD) o di base (YYYYMMDD). Per una migliore leggibilità, è consigliato il formato esteso (YYYY-MM-DD). Utilizza BETWEEN o gli operatori di confronto (=, >, >=, <, <=) con stringhe di date personalizzate:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

Intervallo di date predefinito

Utilizza l'operatore DURING con i valori letterali dell'intervallo di date predefinito. L'operatore DURING supporta solo intervalli di date predefiniti e non può essere utilizzato con stringhe di date personalizzate.

Di seguito è riportato l'elenco degli intervalli di date predefiniti validi:

Esempio:

segments.date DURING LAST_30_DAYS

Periodo di tempo predefinito

Alcuni campi data si riferiscono a un periodo di tempo predefinito, in particolare:

• segments.week
• segments.month
• segments.quarter

Quando filtri in base a questi segmenti con stringhe di date personalizzate (utilizzando =, BETWEEN, >=, <=, > o <), devi specificare una data che corrisponda al primo giorno del periodo di tempo:

• segments.week: il lunedì della settimana (ad esempio, '2026-05-04').
• segments.month: il primo giorno del mese (YYYY-MM-01, ad esempio, '2026-05-01').
• segments.quarter: il primo giorno del trimestre solare (YYYY-01-01, YYYY-04-01, YYYY-07-01 o YYYY-10-01).

Se specifichi una data che non è il primo giorno del periodo, viene restituito un errore QueryError.MISALIGNED_DATE_FOR_FILTER. Puoi anche filtrare questi segmenti utilizzando l'operatore DURING con un intervallo di date predefinito.

Ad esempio, per specificare il mese di maggio 2026, utilizza la seguente condizione, specificando il primo giorno del mese:

segments.month = '2026-05-01'

Limiti di ricerca storica

La disponibilità dei dati dei report storici dipende dalla granularità dei segmenti di date selezionati o filtrati:

• Granularità giornaliera, settimanale e oraria (segments.date, segments.week e segments.hour): supporta una finestra temporale retrospettiva fino a 37 mesi. Le query che segmentano per segments.date, segments.week o segments.hour (o filtrano in base a un intervallo di date inferiore a un mese) per date successive al periodo di 37 mesi non vanno a buon fine e restituiscono DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED nella versione 24 e successive (o DateRangeError.UNKNOWN nella versione 23).
• Granularità mensile, trimestrale, annuale o non segmentata (segments.month, segments.quarter, segments.year o nessun segmento di data): supporta fino a 11 anni di dati storici. Per eseguire query sui dati storici oltre il periodo di 37 mesi, segmenta per segments.month, segments.quarter, segments.year o ometti i segmenti di data in SELECT e assicurati che l'intervallo di date WHERE inizi il primo giorno di un mese e termini l'ultimo giorno di un mese (o filtri su segments.month, segments.quarter o segments.year).