> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explorer

> Construye consultas e informes de analíticas personalizados usando el Explorer en Aftersell.

El Explorer te permite construir consultas de analíticas personalizadas usando un constructor de consultas flexible (AftersellQL). Puedes seleccionar métricas, agrupar resultados por dimensiones, aplicar filtros y visualizar los datos en gráficos o tablas. Las consultas guardadas se pueden agregar a informes como widgets para un monitoreo continuo.

<Tip>
  Construyes las consultas visualmente con menús — no se requiere sintaxis. Si prefieres escribir las consultas directamente, el Explorer también expone el texto AftersellQL subyacente. Consulta [Escribir consultas AQL](#writing-aql-queries) más abajo para la referencia de la sintaxis.
</Tip>

***

<div id="available-metrics">
  ## Métricas disponibles
</div>

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

<div id="revenue-profit">
  ### Ingresos y beneficios
</div>

| Métrica                      | Descripción                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Revenue**                  | Ingresos por upsell en la moneda nativa de tu tienda.                                                                                                                                                                                                                                                                                                                                            |
| **Revenue (USD)**            | Ingresos por upsell normalizados a USD para comparaciones entre monedas.                                                                                                                                                                                                                                                                                                                         |
| **Revenue Per Visit**        | Ingresos por upsell por sesión de impresión. No se puede desglosar por producto, ubicación, embudo ni dispositivo.                                                                                                                                                                                                                                                                               |
| **Avg. Conversion Value**    | Ingresos por oferta aceptada. También llamado Valor Promedio de Upsell.                                                                                                                                                                                                                                                                                                                          |
| **Upsell Revenue Per Order** | Ingresos por upsell (USD) divididos entre el total de pedidos. Solo a nivel de tienda.                                                                                                                                                                                                                                                                                                           |
| **Product Profit**           | Ingresos menos el costo de los bienes vendidos (COGS) de los productos vendidos por upsell. Depende del COGS configurado por el comerciante, así que trátalo como una estimación: los productos sin costo registrado reportan los ingresos como beneficio, y la cobertura de costos varía según la tienda. Solo a nivel de producto; no se puede desglosar por embudo, ubicación ni dispositivo. |

<div id="conversions">
  ### Conversiones
</div>

| Métrica          | Descripción                                                                    |
| ---------------- | ------------------------------------------------------------------------------ |
| **Conversions**  | Sesiones únicas que aceptaron una oferta.                                      |
| **Accept Rate**  | Conversiones divididas entre impresiones.                                      |
| **Units Sold**   | Unidades totales vendidas mediante ofertas de upsell.                          |
| **Decline Rate** | Porcentaje de ofertas post-compra rechazadas explícitamente. Solo post-compra. |

<div id="engagement">
  ### Interacción
</div>

| Métrica         | Descripción                                               |
| --------------- | --------------------------------------------------------- |
| **Impressions** | Sesiones únicas que vieron una oferta.                    |
| **Show Rate**   | Porcentaje de decisiones que resultaron en una impresión. |

<div id="store-performance">
  ### Rendimiento de la tienda
</div>

| Métrica                       | Descripción                                                                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Total Store Revenue**       | Ingresos totales de pedidos pagados en Shopify. Solo a nivel de tienda — no se puede desglosar por superficie, embudo, ubicación ni dispositivo. |
| **Orders**                    | Total de pedidos pagados en Shopify. Solo a nivel de tienda.                                                                                     |
| **Average Total Order Value** | Ingresos de la tienda divididos entre pedidos. Valor promedio de pedido a nivel de tienda.                                                       |

<div id="rokt-network">
  ### Red de Rokt
</div>

| Métrica                        | Descripción                                                                                                       |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Rokt Revenue**               | Ingresos de la red de Rokt atribuidos a tu tienda.                                                                |
| **Rokt Transactions**          | Recuento de transacciones de la red de Rokt para tu tienda.                                                       |
| **Rokt Revenue / Transaction** | Ingresos de Rokt divididos entre transacciones por intervalo de tiempo.                                           |
| **Rokt Impressions**           | Impresiones totales de la red de Rokt en las ubicaciones de tu tienda. Distinto de las **Impressions** de upsell. |
| **Rokt Referrals**             | Referencias de la red de Rokt — interacciones positivas que enviaron al comprador a un socio de Rokt.             |

***

<div id="dimensions">
  ## Dimensiones
</div>

Las dimensiones te permiten desglosar las métricas por un atributo específico. No todas las dimensiones son compatibles con todas las métricas.

<Note>
  Algunas combinaciones de dimensión y métrica son incompatibles. Por ejemplo, **Decline rate** y **Show rate** no se pueden desglosar por **Currency**. El Explorer previene automáticamente las combinaciones incompatibles.
</Note>

<div id="available-dimensions">
  ### Dimensiones disponibles
</div>

| Dimensión     | Descripción                                                                                                                                                             |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date**      | Agrupa los resultados por día, semana o mes.                                                                                                                            |
| **Surface**   | La superficie del upsell (por ejemplo, post-compra, checkout, página de producto).                                                                                      |
| **Funnel**    | El embudo específico al que pertenece la oferta.                                                                                                                        |
| **Product**   | El producto vendido por upsell.                                                                                                                                         |
| **Placement** | La ubicación dentro de un embudo.                                                                                                                                       |
| **Device**    | El tipo de dispositivo (escritorio o móvil).                                                                                                                            |
| **Scope**     | El alcance de la decisión (Flow, Experience, Placement o ItemSlot).                                                                                                     |
| **Currency**  | El código de moneda ISO (por ejemplo, USD, EUR, GBP). Útil para tiendas multi-moneda. Compatible con métricas a nivel de tienda y la mayoría de las métricas de upsell. |

<div id="unavailable-dimensions">
  ### Dimensiones no disponibles
</div>

Las siguientes dimensiones están en desarrollo. Aparecen en el selector pero aún no están disponibles como desglose. En su lugar, se muestran como 'Not compatible' para todas las métricas. **Este documento se actualizará cuando estas dimensiones estén completamente implementadas.**

| Dimensión         | Descripción                                                         |
| ----------------- | ------------------------------------------------------------------- |
| **Flow type**     | El tipo de flujo de upsell.                                         |
| **Experiment**    | La variante de la prueba A/B o experimento.                         |
| **Outcome**       | El resultado de la decisión (por ejemplo, elegible, sin stock).     |
| **Reason code**   | El motivo del resultado de una decisión.                            |
| **Scope**         | El alcance de la decisión (Flow, Experience, Placement o ItemSlot). |
| **Response type** | La respuesta a la oferta (Accepted, Declined o Timeout).            |

***

<div id="writing-aql-queries">
  ## Escribir consultas AQL
</div>

Cada consulta que construyes en el Explorer es una sentencia de **AftersellQL (AQL)**. La mayor parte del tiempo construyes las consultas visualmente — eligiendo métricas, dimensiones, filtros y un rango de fechas desde los menús — y nunca necesitas escribir AQL a mano.

Para usuarios avanzados, el Explorer también expone la consulta subyacente como texto editable. Esta sección es la referencia para esa forma de texto: qué significan las cláusulas, qué valores aceptan y algunos ejemplos listos para usar.

<div id="how-an-aql-statement-reads">
  ### Cómo se lee una sentencia AQL
</div>

Una sentencia AQL es una sola pregunta compuesta de 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 el orden mostrado abajo.

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT    <metrics>                    -- what to measure (required)
WHERE     <filters>                    -- narrow the data
GROUP BY  <dimensions>                 -- break the numbers down
SINCE     <time range>                 -- the period to cover (required)
GRAIN     <time grain>                 -- bucket size for time series
COMPARE   <comparison>                 -- compare against another period
CHART     <visualization>              -- how to display the result
TIMEZONE  "<timezone>"                 -- timezone for date buckets
ORDER BY  <field> <direction>          -- sort the results
LIMIT     <number>                     -- cap the number of rows
```

Un ejemplo mínimo — ingresos diarios por upsell y tasa de aceptación de los últimos 30 días:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```

<Note>
  Las palabras clave no distinguen entre mayúsculas y minúsculas (`SELECT` y `select` funcionan igual) y las sentencias no terminan con punto y coma. Los valores de texto se envuelven en comillas dobles; los números y las listas no.
</Note>

<div id="picking-what-to-measure-and-how-to-slice-it">
  ### Elegir qué medir y cómo segmentarlo
</div>

* **`SELECT`** lista las métricas 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 solo total para todo el período.

Para la lista completa de métricas y dimensiones disponibles — y qué combinaciones están permitidas — consulta [Métricas disponibles](#available-metrics) y [Dimensiones disponibles](#available-dimensions) más arriba. El Explorer previene automáticamente las combinaciones incompatibles de métrica y dimensión.

<div id="filtering-with-where">
  #### Filtrar con `WHERE`
</div>

`WHERE` restringe los datos antes de medirlos. Combina condiciones con `AND`.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, impressions, accept_rate, rpv
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```

Las comparaciones admitidas son `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` y `<=`. Usa una lista con `IN` para coincidir con varios valores:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE experiment IN ["variant_a", "variant_b"]
```

<div id="filtering-by-multiple-funnels">
  #### Filtrar por múltiples embudos
</div>

El filtro de **funnel** admite operadores de selección múltiple para que puedas limitar una consulta a un subconjunto de tus embudos:

* **is one of** — incluye solo los embudos seleccionados (`IN`).
* **is not one of** — excluye los embudos seleccionados (`NOT IN`).

Cuando eliges **is one of** o **is not one of**, el campo de valor cambia a una lista desplazable de casillas de verificación que muestra todos los nombres de tus embudos. Selecciona tantos embudos como necesites.

Cuando agrupas los resultados por **Funnel** y aplicas un filtro **is one of**, el gráfico de líneas muestra una línea por cada embudo seleccionado — incluso si seleccionas más que el número predeterminado de series. Ningún embudo seleccionado se colapsa en una categoría "Other".

<div id="time-ranges-and-comparisons">
  ### Rangos de tiempo y comparaciones
</div>

Cada consulta necesita un rango de tiempo, establecido con `SINCE`. Usa un ajuste predefinido o una ventana personalizada.

| Forma                 | Ejemplo                             | Significado                                      |
| --------------------- | ----------------------------------- | ------------------------------------------------ |
| Predefinido           | `SINCE last_30d`                    | Una ventana móvil que termina hoy.               |
| Ventana personalizada | `SINCE 2025-11-28 UNTIL 2025-12-01` | Un rango fijo, usando fechas ISO (`YYYY-MM-DD`). |

Ajustes predefinidos disponibles: `last_1d`, `last_7d`, `last_30d`, `last_90d`, `this_month`, `last_month` y `this_year`.

* **`GRAIN`** establece el tamaño del intervalo para las series temporales — `hour`, `day`, `week` o `month`.
* **`COMPARE`** superpone un segundo período para que puedas ver el cambio de un vistazo. Usa `previous_period` (la ventana de igual duración inmediatamente anterior) o `previous_year` (la misma ventana desplazada un año atrás).

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- BFCM 2025 vs BFCM 2024
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2025-11-28 UNTIL 2025-12-01
GRAIN day
COMPARE previous_year
```

<div id="choosing-a-chart-and-timezone">
  ### Elegir un gráfico y una zona horaria
</div>

Estas cláusulas opcionales normalmente las configuran por ti los controles visuales del Explorer, pero también puedes escribirlas directamente:

* **`CHART`** establece cómo se muestra el resultado: `scorecard`, `line_chart`, `bar_chart`, `area_chart`, `funnel_chart` o `table`.
* **`TIMEZONE`** establece 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.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
GROUP BY date
SINCE last_30d
GRAIN day
CHART line_chart
TIMEZONE "America/New_York"
```

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 → downsell → upsells adicionales). Solo se traza la primera métrica; las métricas adicionales seleccionadas se anotan 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 una caída de impresiones → conversiones). Todas las métricas deben compartir la misma unidad (por ejemplo, no puedes mezclar métricas de moneda y de porcentaje).

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT impressions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```

<div id="sorting-and-limiting">
  ### Ordenar y limitar
</div>

* **`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 del tipo "top N".

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```

<div id="more-examples">
  ### Más ejemplos
</div>

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop accept rate over the last 90 days
SELECT impressions, accept_rate, rpv
GROUP BY device
SINCE last_90d
ORDER BY rpv DESC
```

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```

Una vez que tengas una consulta que te guste, guárdala y agrégala a un informe como widget para que se siga actualizando — consulta [Gestionar widgets](/es/aftersell/reports_widgets). Para eliminar un widget que ya no necesites, cárgalo en el Explorer y haz clic en **Delete** en la barra de título. Eliminar un widget lo quita de todos los informes en los que aparece. El botón **Delete** solo se muestra para los widgets de tu propiedad; los widgets de plantilla globales son de solo lectura.

***

<div id="exporting-results">
  ## Exportar resultados
</div>

El Explorer muestra los resultados de tu consulta en pantalla como scorecard, gráfico o tabla — no descarga un archivo directamente desde la vista de consulta.

Para obtener los resultados como archivo, guarda la consulta y agrégala a un informe como [widget](/es/aftersell/reports_widgets). Cada widget tiene su propio botón **Export to CSV** que descarga los datos del widget como un archivo `.csv`. Para las exportaciones estándar de la página de Analytics (Excel y CSV), consulta [Exportar tus datos](/es/aftersell/analytics_in_aftersell#exporting-your-data).

***

<div id="timezone-support">
  ## Compatibilidad con zonas horarias
</div>

Por defecto, las consultas se ejecutan en UTC. Puedes sobrescribir la zona horaria de cualquier consulta directamente en la barra de herramientas del Explorer, para que los resultados agrupados por fecha (desgloses diarios, semanales, mensuales) reflejen tu hora local en lugar de UTC.

<Note>
  Las consultas que incluyen **Impressions**, **Accept Rate** o **Revenue Per Visit** siempre agrupan las fechas en UTC, independientemente de la zona horaria que selecciones. Estas métricas provienen de una consolidación diaria que solo se reporta en días UTC. Si una consulta mezcla una de estas métricas con otras, todo el conjunto de resultados vuelve a UTC para que los intervalos de fecha se mantengan alineados.
</Note>

<div id="setting-a-timezone-for-a-query">
  ### Establecer una zona horaria para una consulta
</div>

1. Abre el Explorer en tu panel de administración de Aftersell.
2. En la barra de herramientas, haz clic en el selector de **Timezone** (junto a **Compare**).
3. Elige una de las zonas horarias disponibles de la lista, o selecciona **Account default** para usar la zona horaria configurada en tus ajustes de analíticas.
4. Ejecuta tu consulta. Los resultados se agrupan usando la zona horaria seleccionada.

La zona horaria seleccionada se guarda con la consulta. Cuando guardas y recargas una consulta, la zona horaria se restaura automáticamente.

<div id="account-default-timezone">
  ### Zona horaria predeterminada de la cuenta
</div>

Si tienes **Lock reporting timezone** activado en tus ajustes de analíticas, seleccionar **Account default** en la barra de herramientas usa esa zona horaria bloqueada para tu consulta. La etiqueta de la barra de herramientas muestra la zona resuelta, por ejemplo **Timezone: Account default (Paris (CET))**.

Si **Lock reporting timezone** no está activado, **Account default** recurre a UTC.

<div id="specifying-a-timezone-in-aql">
  ### Especificar una zona horaria en AQL
</div>

También puedes especificar una zona horaria directamente en tu consulta AQL usando la cláusula `TIMEZONE`, que aparece entre `CHART` y `ORDER BY`:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```

Cuando está presente, la cláusula sobrescribe la selección de la barra de herramientas para esa consulta. La zona horaria se conserva cuando guardas y recargas la consulta.

<div id="available-timezones">
  ### Zonas horarias disponibles
</div>

El selector de zona horaria incluye las siguientes opciones:

| Zona horaria         | Ubicación de ejemplo        |
| -------------------- | --------------------------- |
| UTC                  | Tiempo Universal Coordinado |
| America/New\_York    | Nueva York (ET)             |
| America/Chicago      | Chicago (CT)                |
| America/Denver       | Denver (MT)                 |
| America/Los\_Angeles | Los Ángeles (PT)            |
| America/Sao\_Paulo   | São Paulo (BRT)             |
| Europe/London        | Londres (GMT/BST)           |
| Europe/Paris         | París (CET/CEST)            |
| Asia/Dubai           | Dubái (GST)                 |
| Asia/Tokyo           | Tokio (JST)                 |
| Australia/Sydney     | Sídney (AEST/AEDT)          |

<div id="how-timezone-affects-query-results">
  ### Cómo la zona horaria afecta los resultados de la consulta
</div>

Cuando se establece una zona horaria, la agrupación por fecha en tu consulta usa la hora local en lugar de UTC. Por ejemplo, un evento que ocurrió a las `2026-03-29T01:30:00Z` (UTC) cae el 28 de marzo en la hora de Nueva York (ET) pero el 29 de marzo en la hora de París (CET). Establecer la zona horaria correcta garantiza que tus desgloses diarios, semanales y mensuales coincidan con tus expectativas de informes de negocio.

Las consultas que no incluyen una zona horaria — incluidas las consultas guardadas previamente — siguen ejecutándose en UTC, por lo que los resultados existentes no se ven afectados.

***

<div id="need-help">
  ## ¿Necesitas ayuda?
</div>

Si tienes preguntas sobre el Explorer o quieres habilitar el acceso, contacta al equipo de soporte de Aftersell a través del chat dentro de la app.