Las dimensiones desglosan una métrica por un atributo. No todas las dimensiones son compatibles con todas las métricas; el Explorer impide automáticamente las combinaciones incompatibles (por ejemplo, Decline rate y Show rate no se pueden desglosar por Currency).
Las siguientes están en desarrollo. Aparecen en el selector, pero se muestran como ‘Not compatible’ para todas las métricas hasta que se implementen.
Una sentencia AQL es una única pregunta compuesta por cláusulas. Solo
SELECT y un rango de tiempo (SINCE) son obligatorios; todo lo demás es opcional. Cuando incluyes cláusulas opcionales, deben aparecer en este orden:
Las palabras clave no distinguen entre mayúsculas y minúsculas (
SELECT y select funcionan igual) y las sentencias no terminan en punto y coma. Los valores de texto van entre comillas dobles; los números y las listas no.SELECTenumera las métricas que se van a medir, separadas por comas, por ejemploSELECT revenue, impressions, accept_rate.GROUP BYdesglosa esas métricas por una o más dimensiones, comodate,device,surfaceofunnel. SinGROUP BY, obtienes un único total para todo el período.
WHERE acota los datos antes de medirlos. Combina condiciones con AND.
=, !=, IN, NOT IN, >, <, >= y <=. Usa una lista con IN para buscar coincidencias con varios valores:
experiment no es un campo filtrable; no tiene un rollup de origen, por lo que WHERE experiment IN [...] se rechaza con filters on "experiment" are not supported.
El filtro de funnel admite selección múltiple: is one of (IN) incluye solo los embudos seleccionados, is not one of (NOT IN) los excluye. Cuando agrupas por Funnel y aplicas un filtro is one of, el gráfico muestra una línea por cada embudo seleccionado, sin agruparlos en “Other”.
Toda consulta necesita un rango de tiempo, definido con SINCE:
Preestablecidos disponibles:
last_1d, last_7d, last_30d, last_90d, this_month, last_month y this_year.
GRAINdefine el tamaño del intervalo para las series temporales:day,weekomonth. (hourse analiza correctamente, pero ningún rollup sirve datos por hora, así que una consulta así se rechaza congroup_by / time_grain combination is not supported.)COMPAREsuperpone un segundo período. Usaprevious_period, la ventana de igual duración inmediatamente anterior.previous_yearestá oculto en el selector Compare porque el almacén de datos no contiene datos anteriores a febrero de 2026; sigue pudiendo escribirse en AQL solo para que las consultas guardadas anteriormente sigan analizándose.
Los datos de informes empiezan en febrero de 2026, así que una ventana anterior a esa fecha devuelve resultados vacíos para ambos períodos.
CHARTdefine cómo se muestra el resultado:scorecard,line_chart,bar_chart,area_chart,funnel_chartotable.TIMEZONEdefine la zona horaria usada para agrupar las fechas, como un nombre IANA entre comillas, por ejemploTIMEZONE "America/New_York". El valor predeterminado es UTC (consulta Zonas horarias).
funnel_chart tiene requisitos específicos:
- Modo de ubicación. Agrupa por
placementy selecciona una métrica. Las etapas se ordenan según la secuencia canónica de ubicaciones (upsell predeterminado, luego downsell, luego upsells adicionales). Solo se representa la primera métrica; las métricas adicionales se indican en una nota al pie. - Modo de métricas. Selecciona dos o más métricas sin
GROUP BY. Cada métrica se convierte en una etapa del embudo en el orden de la consulta (por ejemplo,SELECT impressions, conversionsmuestra la caída de impresiones a conversiones). Todas las métricas deben compartir la misma unidad.
ORDER BYordena los resultados por una métrica o dimensión, conASCoDESC.LIMITlimita el número de filas devueltas, útil para preguntas de tipo “top N”.
impressions, accept_rate y rpv no se pueden desglosar por dispositivo; su rollup es tienda × superficie × día, sin columna de dispositivo. Usa revenue (u otra métrica basada en conversiones) para comparar dispositivos.Las consultas que incluyen Impressions, Accept Rate o Revenue Per Visit siempre agrupan las fechas en UTC, independientemente de la zona horaria que selecciones, porque provienen de un rollup diario que se informa en días UTC. Si una consulta mezcla una de ellas con otras métricas, todo el conjunto de resultados vuelve a UTC para que los intervalos de fecha sigan alineados.
TIMEZONE, que aparece entre CHART y ORDER BY:
TIMEZONE) acepta un conjunto cerrado de diez zonas. Cualquier otra zona horaria IANA se rechaza por no ser compatible.
Si Lock reporting timezone está habilitado en tus ajustes de analíticas, seleccionar Account default usa esa zona horaria bloqueada (la barra de herramientas muestra la zona resuelta, por ejemplo Timezone: Account default (Paris (CET))). La página de ajustes de analíticas acepta la lista IANA completa, pero Reports solo respeta las diez zonas anteriores; si tu zona bloqueada no es una de ellas, Account default se resuelve silenciosamente a UTC. Si Lock reporting timezone no está habilitado, Account default vuelve a UTC.
Cuando se establece una zona horaria, la agrupación por fecha usa la hora local en lugar de UTC. Por ejemplo, un evento a las
2026-03-29T01:30:00Z cae el 28 de marzo en Nueva York (ET), pero el 29 de marzo en París (CET). Las consultas sin zona horaria, incluidas las guardadas anteriormente, siguen ejecutándose en UTC.