Intervalli di date

Google Ads Query Language ti consente di specificare l'intervallo di date nei seguenti modi:

Intervallo di date personalizzato

Puoi specificare le date nel formato esteso (YYYY-MM-DD) o di base (YYYYMMDD) ISO 8601. Per una maggiore 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 valori letterali dell'intervallo di date predefiniti. 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:

Intervallo di date I report vengono generati per…
TODAY Solo oggi.
YESTERDAY Solo ieri.
LAST_7_DAYS Gli ultimi 7 giorni, escluso oggi.
LAST_BUSINESS_WEEK La settimana lavorativa di 5 giorni, dal lunedì al venerdì, della settimana lavorativa precedente.
THIS_MONTH Tutti i giorni del mese corrente.
LAST_MONTH Tutti i giorni del mese precedente.
LAST_14_DAYS Gli ultimi 14 giorni, escluso oggi.
LAST_30_DAYS Gli ultimi 30 giorni, escluso oggi.
THIS_WEEK_SUN_TODAY Il periodo compreso tra la domenica precedente e il giorno corrente.
THIS_WEEK_MON_TODAY Il periodo compreso tra il lunedì precedente e il giorno corrente.
LAST_WEEK_SUN_SAT Il periodo di 7 giorni che inizia la domenica precedente.
LAST_WEEK_MON_SUN Il periodo di 7 giorni che inizia il lunedì precedente.

Esempio:

segments.date DURING LAST_30_DAYS

Periodo di tempo predefinito

Alcuni campi di 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: primo giorno del trimestre di calendario (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 dell'anno 2026, utilizza la seguente condizione, specificando il primo giorno del mese:

segments.month = '2026-05-01'

Limiti di lookback storici

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 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 alla finestra di 37 mesi non vanno a buon fine con DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED nella v24 e versioni successive (o DateRangeError.UNKNOWN nella v23).
  • 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 la finestra 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 per segments.month, segments.quarter o segments.year).
Indietro
Struttura della query
Avanti
Distinzione tra maiuscole e minuscole