Períodos

El lenguaje de consulta de Google Ads te permite especificar el período de las siguientes maneras:

Período personalizado

Puedes especificar fechas en formato ISO 8601 extendido (YYYY-MM-DD) o básico (YYYYMMDD). Se recomienda el formato extendido (YYYY-MM-DD) para facilitar la lectura. Usa BETWEEN o los operadores de comparación (=, >, >=, <, <=) con cadenas de fecha personalizadas:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'
segments.date >= '20260701' AND segments.date <= '20260731'

Período predefinido

Usa el operador DURING con literales de períodos predefinidos. El operador DURING solo admite períodos predefinidos y no se puede usar con cadenas de fecha personalizadas.

A continuación, se incluye la lista de rangos de fechas predefinidos válidos:

Período Los informes se generan para…
TODAY Solo por hoy.
YESTERDAY Solo ayer.
LAST_7_DAYS Los últimos 7 días, sin incluir el día de hoy.
LAST_BUSINESS_WEEK Semana laboral de 5 días, de lunes a viernes, de la semana laboral anterior.
THIS_MONTH Todos los días del mes actual.
LAST_MONTH Todos los días del mes anterior.
LAST_14_DAYS Los últimos 14 días, sin incluir el día de hoy.
LAST_30_DAYS Los últimos 30 días, sin incluir el día de hoy.
THIS_WEEK_SUN_TODAY Es el período entre el domingo anterior y el día actual.
THIS_WEEK_MON_TODAY Es el período entre el lunes anterior y el día actual.
LAST_WEEK_SUN_SAT Período de 7 días que comienza el domingo anterior
LAST_WEEK_MON_SUN Período de 7 días que comienza con el lunes anterior

Ejemplo:

segments.date DURING LAST_30_DAYS

Período predefinido

Algunos campos de fecha hacen referencia a un período predefinido, específicamente:

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

Cuando filtres estos segmentos con cadenas de fecha personalizadas (con =, BETWEEN, >=, <=, > o <), debes especificar una fecha que sea el primer día del período:

  • segments.week: Lunes de la semana (por ejemplo, '2026-05-04').
  • segments.month: Primer día del mes (YYYY-MM-01, por ejemplo, '2026-05-01').
  • segments.quarter: Primer día del trimestre calendario (YYYY-01-01, YYYY-04-01, YYYY-07-01 o YYYY-10-01).

Si especificas una fecha que no es el primer día del período, se devuelve un error QueryError.MISALIGNED_DATE_FOR_FILTER. También puedes filtrar estos segmentos con el operador DURING y un período predefinido.

Por ejemplo, para especificar el mes de mayo del año 2026, usa la siguiente condición, en la que se especifica el primer día de ese mes:

segments.month = '2026-05-01'

Límites de períodos históricos

La disponibilidad de los datos de informes históricos depende del nivel de detalle de los segmentos de fecha seleccionados o filtrados:

  • Nivel de detalle diario, semanal y por hora (segments.date, segments.week y segments.hour): Admite una ventana de visualización de hasta 37 meses. Las consultas que segmentan por segments.date, segments.week o segments.hour (o que filtran en un rango de fechas inferior a un mes) para fechas que superan el período de 37 meses fallan con DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED en la versión 24 y posteriores (o DateRangeError.UNKNOWN en la versión 23).
  • Nivel de detalle mensual, trimestral, anual o sin segmentar (segments.month, segments.quarter, segments.year o sin segmento de fecha): Admite hasta 11 años de datos históricos. Para consultar datos históricos más allá del período de 37 meses, segmenta por segments.month, segments.quarter o segments.year, o bien omite los segmentos de fecha en SELECT y asegúrate de que el período de WHERE comience el primer día de un mes y finalice el último día de un mes (o bien aplica filtros en segments.month, segments.quarter o segments.year).