Períodos

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

Período personalizado

Puedes especificar las fechas en formato extendido (YYYY-MM-DD) o básico (YYYYMMDD) de ISO 8601. 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íodo predefinidos. El operador DURING solo admite períodos predefinidos y no se puede usar con cadenas de fechas personalizadas.

La lista de períodos predefinidos válidos es la siguiente:

Período Los informes se generan para lo siguiente:
TODAY Solo hoy.
YESTERDAY Solo ayer.
LAST_7_DAYS Los últimos 7 días, sin incluir hoy.
LAST_BUSINESS_WEEK La 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 hoy.
LAST_30_DAYS Los últimos 30 días, sin incluir 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 El período de 7 días que comienza el domingo anterior.
LAST_WEEK_MON_SUN El período de 7 días que comienza el lunes anterior.

Ejemplo:

segments.date DURING LAST_30_DAYS

Período predefinido

Algunos campos de fecha se refieren a un período predefinido, específicamente:

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

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

  • segments.week: Es el 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: Es el primer día del trimestre del 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 muestra un error QueryError.MISALIGNED_DATE_FOR_FILTER. También puedes filtrar estos segmentos con el operador DURING con un período predefinido.

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

segments.month = '2026-05-01'

Límites de la ventana de visualización histórica

La disponibilidad de los datos de informes históricos depende del nivel de detalle de los segmentos de fechas 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 filtran por un período inferior a un mes) para fechas posteriores al 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á de la ventana 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 filtra por segments.month, segments.quarter o segments.year).
Anterior
Estructura de una consulta
Siguiente
Distinción de mayúsculas