Intervalli di date

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

Intervallo di date personalizzato

Puoi specificare le date in formato ISO 8601 esteso (YYYY-MM-DD) o di base (YYYYMMDD). Per una maggiore leggibilità, è consigliabile utilizzare il formato esteso (YYYY-MM-DD). Utilizza BETWEEN o gli operatori di confronto (=, >, >=, <, <=) con le 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 gli 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 per oggi.
YESTERDAY Solo per 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 con la domenica precedente.
LAST_WEEK_MON_SUN Il periodo di 7 giorni che inizia con il lunedì precedente.

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 questi segmenti con stringhe di date personalizzate (utilizzando =, BETWEEN, >=, <=, >, o <), devi specificare una data che sia il 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 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 di quel 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 di massimo 37 mesi. Le query che segmentano per segments.date, segments.week, o segments.hour (o filtrano su un intervallo di date inferiore al mese) per le date oltre la finestra di 37 mesi non riescono a eseguire l'operazione con DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED in v24 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 date): 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 date 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).
Indietro
Struttura della query
Avanti
Distinzione tra maiuscole e minuscole