Skip to main content
Cada consulta que creas en el Explorer es una sentencia de AftersellQL (AQL). La mayor parte del tiempo creas las consultas de forma visual y nunca escribes AQL a mano; esta página es la referencia de las métricas y dimensiones que puedes elegir, de la forma de texto de AQL y de las reglas de zona horaria.

Métricas disponibles

Estas son las métricas que puedes elegir, agrupadas de la misma forma que en el selector de métricas.

Ingresos y ganancias

Conversiones

Interacción

Rendimiento de la tienda

Red Rokt

Dimensiones

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).

Dimensiones disponibles

Dimensiones no disponibles

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.

Sintaxis de las sentencias AQL

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:
Un ejemplo mínimo, ingresos de upsell y tasa de aceptación diarios de los últimos 30 días:
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.

SELECT y GROUP BY

  • SELECT enumera las métricas que se van a medir, separadas por comas, por ejemplo SELECT revenue, impressions, accept_rate.
  • GROUP BY desglosa esas métricas por una o más dimensiones, como date, device, surface o funnel. Sin GROUP BY, obtienes un único total para todo el período.

Filtrar con WHERE

WHERE acota los datos antes de medirlos. Combina condiciones con AND.
impressions, accept_rate y rpv no se pueden filtrar ni agrupar por dispositivo, embudo, ubicación ni producto; su rollup de origen no tiene esa columna. Añadir WHERE device = "mobile" a una consulta que seleccione cualquiera de ellas se rechaza con metric "impressions" cannot be filtered by "device".
Las comparaciones admitidas son =, !=, 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”.

Rangos de tiempo y comparaciones

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.
  • GRAIN define el tamaño del intervalo para las series temporales: day, week o month. (hour se analiza correctamente, pero ningún rollup sirve datos por hora, así que una consulta así se rechaza con group_by / time_grain combination is not supported.)
  • COMPARE superpone un segundo período. Usa previous_period, la ventana de igual duración inmediatamente anterior. previous_year está 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.

Elegir un gráfico

  • CHART define cómo se muestra el resultado: scorecard, line_chart, bar_chart, area_chart, funnel_chart o table.
  • TIMEZONE define la zona horaria usada para agrupar las fechas, como un nombre IANA entre comillas, por ejemplo TIMEZONE "America/New_York". El valor predeterminado es UTC (consulta Zonas horarias).
El tipo funnel_chart tiene requisitos específicos:
  • Modo de ubicación. Agrupa por placement y 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, conversions muestra la caída de impresiones a conversiones). Todas las métricas deben compartir la misma unidad.
El modo de ubicación necesita una métrica que se pueda desglosar por ubicación. impressions, accept_rate y rpv no se pueden; para ellas, el gráfico de embudo muestra “These metrics can’t be grouped by placement”.

Ordenar y limitar

  • ORDER BY ordena los resultados por una métrica o dimensión, con ASC o DESC.
  • LIMIT limita el número de filas devueltas, útil para preguntas de tipo “top N”.

Más ejemplos

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.

Zonas horarias

De forma predeterminada, las consultas se ejecutan en UTC. Puedes cambiar la zona horaria para que los resultados agrupados por fecha reflejen la hora local (consulta Configurar una zona horaria para ver los pasos en la barra de herramientas).
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.

La cláusula TIMEZONE

Especifica una zona horaria directamente en AQL con la cláusula TIMEZONE, que aparece entre CHART y ORDER BY:
Cuando está presente, la cláusula anula la selección de la barra de herramientas para esa consulta y se conserva al guardar y volver a cargar.

Zonas horarias disponibles

El selector (y la cláusula TIMEZONE) acepta un conjunto cerrado de diez zonas. Cualquier otra zona horaria IANA se rechaza por no ser compatible.

Account default y cómo afecta la zona horaria a los resultados

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.