> ## 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

> Crie consultas de análise e relatórios personalizados usando o Explorer no Aftersell.

O Explorer permite criar consultas de análise personalizadas usando um construtor de consultas flexível (AftersellQL). Você pode selecionar métricas, agrupar resultados por dimensões, aplicar filtros e visualizar dados em gráficos ou tabelas. As consultas salvas podem ser adicionadas a relatórios como widgets para monitoramento contínuo.

<Tip>
  Você constrói consultas visualmente com menus — sem necessidade de sintaxe. Se preferir digitar consultas diretamente, o Explorer também expõe o texto AftersellQL subjacente. Veja [Escrevendo consultas AQL](#writing-aql-queries) abaixo para a referência de sintaxe.
</Tip>

***

<div id="available-metrics">
  ## Métricas disponíveis
</div>

Estas são as métricas que você pode escolher no Explorer, agrupadas da mesma forma que o seletor de métricas as agrupa.

<div id="revenue-profit">
  ### Receita e lucro
</div>

| Métrica                      | Descrição                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Revenue**                  | Receita de upsell na moeda nativa da sua loja.                                                                                                                                                                                                                                                                                                                    |
| **Revenue (USD)**            | Receita de upsell normalizada em USD para comparações entre moedas.                                                                                                                                                                                                                                                                                               |
| **Revenue Per Visit**        | Receita de upsell por sessão de impressão. Não pode ser detalhada por produto, posicionamento, funil ou dispositivo.                                                                                                                                                                                                                                              |
| **Avg. Conversion Value**    | Receita por oferta aceita. Também chamada de Average Upsell Value (valor médio de upsell).                                                                                                                                                                                                                                                                        |
| **Upsell Revenue Per Order** | Receita de upsell (USD) dividida pelo total de pedidos. Apenas em nível de loja.                                                                                                                                                                                                                                                                                  |
| **Product Profit**           | Receita menos o custo dos produtos vendidos (COGS) dos produtos vendidos via upsell. Depende do COGS configurado pelo lojista, então trate como uma estimativa: produtos sem custo registrado reportam a receita como lucro, e a cobertura de custos varia por loja. Apenas em nível de produto; não pode ser detalhada por funil, posicionamento ou dispositivo. |

<div id="conversions">
  ### Conversões
</div>

| Métrica          | Descrição                                                                                                                                                                                                      |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conversions**  | O número de eventos de oferta aceita. Uma oferta aceita é uma conversão, então uma sessão que aceita duas ofertas conta duas vezes.                                                                            |
| **Accept Rate**  | Baseada em sessões: a fração de sessões que viram uma oferta e aceitaram pelo menos uma. É calculada independentemente de Conversions, a partir de um rollup diferente, então não é Conversions ÷ Impressions. |
| **Units Sold**   | Total de unidades vendidas por meio de ofertas de upsell.                                                                                                                                                      |
| **Decline Rate** | Percentual de ofertas pós-compra recusadas explicitamente. Apenas pós-compra.                                                                                                                                  |

<div id="engagement">
  ### Engajamento
</div>

| Métrica         | Descrição                                               |
| --------------- | ------------------------------------------------------- |
| **Impressions** | Sessões únicas que viram uma oferta.                    |
| **Show Rate**   | Percentual de decisões que resultaram em uma impressão. |

<div id="store-performance">
  ### Desempenho da loja
</div>

| Métrica                       | Descrição                                                                                                                                         |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Total Store Revenue**       | Receita total de pedidos pagos no Shopify. Apenas em nível de loja — não pode ser detalhada por superfície, funil, posicionamento ou dispositivo. |
| **Orders**                    | Total de pedidos pagos no Shopify. Apenas em nível de loja.                                                                                       |
| **Average Total Order Value** | Receita da loja dividida pelos pedidos. Valor médio de pedido em nível de loja.                                                                   |

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

| Métrica                        | Descrição                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| **Rokt Revenue**               | Receita da rede Rokt atribuída à sua loja.                                                                         |
| **Rokt Transactions**          | Contagem de transações da rede Rokt para a sua loja.                                                               |
| **Rokt Revenue / Transaction** | Receita Rokt dividida pelas transações por intervalo de tempo.                                                     |
| **Rokt Impressions**           | Total de impressões da rede Rokt em todos os posicionamentos da sua loja. Diferente das **Impressions** de upsell. |
| **Rokt Referrals**             | Indicações da rede Rokt — engajamentos positivos que enviaram o comprador a um parceiro Rokt.                      |

***

<div id="dimensions">
  ## Dimensões
</div>

As dimensões permitem detalhar métricas por um atributo específico. Nem todas as dimensões são compatíveis com todas as métricas.

<Note>
  Algumas combinações de dimensão e métrica são incompatíveis. Por exemplo, **Decline rate** e **Show rate** não podem ser detalhadas por **Currency**. O Explorer evita automaticamente combinações incompatíveis.
</Note>

<div id="available-dimensions">
  ### Dimensões disponíveis
</div>

| Dimensão      | Descrição                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date**      | Agrupa os resultados por dia, semana ou mês.                                                                                                                        |
| **Surface**   | A superfície do upsell. Uma entre PPU (pós-compra), Checkout, Thank You Page ou Cart.                                                                               |
| **Funnel**    | O funil específico ao qual a oferta pertence.                                                                                                                       |
| **Product**   | O produto oferecido no upsell.                                                                                                                                      |
| **Placement** | O posicionamento dentro de um funil.                                                                                                                                |
| **Device**    | O tipo de dispositivo: Mobile, Desktop ou Unknown. Não há valor separado para tablet.                                                                               |
| **Currency**  | O código ISO da moeda (por exemplo, USD, EUR, GBP). Útil para lojas com várias moedas. Compatível com métricas de nível de loja e a maioria das métricas de upsell. |

<div id="unavailable-dimensions">
  ### Dimensões indisponíveis
</div>

As dimensões a seguir estão em desenvolvimento. Elas aparecem no seletor, mas ainda não estão disponíveis como detalhamento. Em vez disso, aparecem como 'Not compatible' para todas as métricas. **Este documento será atualizado quando essas dimensões estiverem totalmente implementadas.**

| Dimensão          | Descrição                                                        |
| ----------------- | ---------------------------------------------------------------- |
| **Flow type**     | O tipo de fluxo de upsell.                                       |
| **Experiment**    | A variante do teste A/B ou experimento.                          |
| **Outcome**       | O resultado da decisão (por exemplo, elegível, fora de estoque). |
| **Reason code**   | O motivo do resultado de uma decisão.                            |
| **Scope**         | O escopo da decisão (Flow, Experience, Placement ou ItemSlot).   |
| **Response type** | A resposta à oferta (Accepted, Declined ou Timeout).             |

***

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

Toda consulta que você constrói no Explorer é uma instrução **AftersellQL (AQL)**. Na maior parte do tempo, você constrói consultas visualmente — escolhendo métricas, dimensões, filtros e um intervalo de datas nos menus — e nunca precisa escrever AQL manualmente.

Para usuários avançados, o Explorer também expõe a consulta subjacente como texto editável. Esta seção é a referência para essa forma de texto: o que as cláusulas significam, quais valores aceitam e alguns exemplos prontos para usar.

<div id="how-an-aql-statement-reads">
  ### Como se lê uma instrução AQL
</div>

Uma instrução AQL é uma única pergunta composta de cláusulas. Apenas `SELECT` e um intervalo de tempo (`SINCE`) são obrigatórios; todo o resto é opcional. Quando você inclui cláusulas opcionais, elas devem aparecer na ordem mostrada abaixo.

```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
```

Um exemplo mínimo — receita diária de upsell e taxa de aceitação dos últimos 30 dias:

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

<Note>
  As palavras-chave não diferenciam maiúsculas de minúsculas (`SELECT` e `select` funcionam) e as instruções não terminam com ponto e vírgula. Valores de string são envolvidos em aspas duplas; números e listas, não.
</Note>

<div id="picking-what-to-measure-and-how-to-slice-it">
  ### Escolhendo o que medir e como segmentar
</div>

* **`SELECT`** lista as métricas a medir, separadas por vírgulas — por exemplo, `SELECT revenue, impressions, accept_rate`.
* **`GROUP BY`** detalha essas métricas por uma ou mais dimensões, como `date`, `device`, `surface` ou `funnel`. Sem `GROUP BY`, você obtém um único total para todo o período.

Para a lista completa de métricas e dimensões disponíveis — e quais combinações são permitidas — veja [Métricas disponíveis](#available-metrics) e [Dimensões disponíveis](#available-dimensions) acima. O Explorer evita automaticamente combinações incompatíveis de métrica e dimensão.

<div id="filtering-with-where">
  #### Filtrando com `WHERE`
</div>

`WHERE` restringe os dados antes de serem medidos. Combine condições com `AND`.

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

<Warning>
  `impressions`, `accept_rate` e `rpv` **não podem** ser filtradas ou agrupadas por dispositivo, funil, posicionamento ou produto — o rollup de origem delas não tem essa coluna. Adicionar `WHERE device = "mobile"` a uma consulta que selecione qualquer uma delas é rejeitado com `metric "impressions" cannot be filtered by "device"`.
</Warning>

As comparações suportadas são `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` e `<=`. Use uma lista com `IN` para corresponder a vários valores:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```

`experiment` **não** é um campo filtrável — ele não tem fonte de rollup, então `WHERE experiment IN [...]` é rejeitado com `filters on "experiment" are not supported.` (Ele está listado em **Dimensões indisponíveis** abaixo pelo mesmo motivo.)

<div id="filtering-by-multiple-funnels">
  #### Filtrando por vários funis
</div>

O filtro **funnel** suporta operadores de seleção múltipla para você limitar uma consulta a um subconjunto dos seus funis:

* **is one of** — inclui apenas os funis selecionados (`IN`).
* **is not one of** — exclui os funis selecionados (`NOT IN`).

Quando você escolhe **is one of** ou **is not one of**, o campo de valor muda para uma lista rolável de caixas de seleção com todos os nomes dos seus funis. Selecione quantos funis precisar.

Quando você agrupa os resultados por **Funnel** e aplica um filtro **is one of**, o gráfico de linhas mostra uma linha por funil selecionado — mesmo que você selecione mais do que o número padrão de séries. Nenhum funil selecionado é agrupado em uma categoria "Other".

<div id="time-ranges-and-comparisons">
  ### Intervalos de tempo e comparações
</div>

Toda consulta precisa de um intervalo de tempo, definido com `SINCE`. Use um predefinido ou uma janela personalizada.

| Forma                | Exemplo                             | Significado                                                                                                                                                                      |
| -------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Predefinido          | `SINCE last_30d`                    | Uma janela móvel terminando **ontem** (UTC). O dia atual em andamento é deliberadamente excluído, então `last_1d` significa apenas ontem, e `this_month` vai do dia 1 até ontem. |
| Janela personalizada | `SINCE 2026-07-02 UNTIL 2026-07-05` | Um intervalo fixo, usando datas ISO (`YYYY-MM-DD`).                                                                                                                              |

Predefinidos disponíveis: `last_1d`, `last_7d`, `last_30d`, `last_90d`, `this_month`, `last_month` e `this_year`.

* **`GRAIN`** define o tamanho do intervalo para séries temporais — `day`, `week` ou `month`. (`hour` é interpretado, mas nenhum rollup fornece dados por hora, então essa consulta é rejeitada com `group_by / time_grain combination is not supported.`)
* **`COMPARE`** sobrepõe um segundo período para você ver a variação rapidamente. Use `previous_period` — a janela de mesma duração imediatamente anterior. `previous_year` é deliberadamente oculto do seletor Compare porque o warehouse não tem dados anteriores a fevereiro de 2026; ele continua digitável apenas em AQL para que consultas salvas anteriormente continuem sendo interpretadas.

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- A four-day sale vs the four days immediately before it
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2026-07-02 UNTIL 2026-07-05
GRAIN day
COMPARE previous_period
```

<Note>
  Os dados de relatório começam em **fevereiro de 2026**, então uma janela anterior a isso retorna vazio para ambos os períodos. É também por isso que comparações ano a ano ainda não são oferecidas.
</Note>

<div id="choosing-a-chart-and-timezone">
  ### Escolhendo um gráfico e fuso horário
</div>

Essas cláusulas opcionais geralmente são definidas pelos controles visuais do Explorer, mas você também pode escrevê-las diretamente:

* **`CHART`** define como o resultado é exibido: `scorecard`, `line_chart`, `bar_chart`, `area_chart`, `funnel_chart` ou `table`.
* **`TIMEZONE`** define o fuso horário usado para agrupar datas, como um nome IANA entre aspas — por exemplo, `TIMEZONE "America/New_York"`. O padrão é 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"
```

O tipo `funnel_chart` tem requisitos específicos:

* **Modo de posicionamento** — Agrupe por `placement` e selecione uma métrica. As etapas são ordenadas pela sequência canônica de posicionamentos (upsell padrão → downsell → upsells adicionais). Apenas a primeira métrica é plotada; métricas adicionais selecionadas são indicadas em uma nota de rodapé.
* **Modo de métrica** — Selecione duas ou mais métricas sem `GROUP BY`. Cada métrica se torna uma etapa do funil na ordem da consulta (por exemplo, `SELECT impressions, conversions` mostra a queda de impressions → conversions). Todas as métricas devem compartilhar a mesma unidade (por exemplo, você não pode misturar métricas de moeda e de porcentagem).

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

<Warning>
  O modo de posicionamento precisa de uma métrica que realmente possa ser detalhada por posicionamento. `impressions`, `accept_rate` e `rpv` não podem — o gráfico de funil mostra "These metrics can't be grouped by placement" para elas.
</Warning>

```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">
  ### Ordenando e limitando
</div>

* **`ORDER BY`** ordena os resultados por uma métrica ou dimensão, com `ASC` ou `DESC`.
* **`LIMIT`** limita o número de linhas retornadas — útil para perguntas do 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">
  ### Mais exemplos
</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 revenue over the last 90 days
SELECT revenue
GROUP BY device
SINCE last_90d
ORDER BY revenue DESC
```

<Note>
  `impressions`, `accept_rate` e `rpv` não podem ser detalhadas por dispositivo — o rollup delas é loja × superfície × dia, sem coluna de dispositivo. Use `revenue` (ou outra métrica derivada de conversões) para comparações por dispositivo.
</Note>

```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
```

Quando tiver uma consulta de que goste, salve-a e adicione-a a um relatório como widget para que continue sendo atualizada — veja [Gerenciar widgets](/pt/aftersell/reports_widgets). Para remover um widget de que você não precisa mais, carregue-o no Explorer e clique em **Delete** na barra de título. Excluir um widget o remove de todos os relatórios em que aparece. O botão **Delete** só é exibido para widgets que pertencem a você; widgets de modelo globais são somente leitura.

***

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

O Explorer mostra os resultados da sua consulta na tela como scorecard, gráfico ou tabela — ele não baixa um arquivo diretamente da visualização de consulta.

Para obter os resultados como arquivo, salve a consulta e adicione-a a um relatório como um [widget](/pt/aftersell/reports_widgets). Cada widget tem seu próprio botão **Export to CSV**, que baixa os dados do widget como um arquivo `.csv`. Para as exportações padrão da página Analytics (Excel e CSV), veja [Exportando seus dados](/pt/aftersell/analytics_in_aftersell#exporting-your-data).

***

<div id="timezone-support">
  ## Suporte a fusos horários
</div>

Por padrão, as consultas são executadas em UTC. Você pode substituir o fuso horário de qualquer consulta diretamente na barra de ferramentas do Explorer, para que os resultados agrupados por data (detalhamentos diários, semanais, mensais) reflitam seu horário local em vez de UTC.

<Note>
  Consultas que incluem **Impressions**, **Accept Rate** ou **Revenue Per Visit** sempre agrupam datas em UTC, independentemente do fuso horário selecionado. Essas métricas vêm de um rollup diário reportado apenas em dias UTC. Se uma consulta mistura uma dessas métricas com outras, todo o conjunto de resultados volta para UTC para que os intervalos de data permaneçam alinhados.
</Note>

<div id="setting-a-timezone-for-a-query">
  ### Definindo um fuso horário para uma consulta
</div>

1. Abra o Explorer no seu admin do Aftersell.
2. Na barra de ferramentas, clique no seletor **Timezone** (ao lado de **Compare**).
3. Escolha um dos fusos horários disponíveis na lista, ou selecione **Account default** para usar o fuso configurado nas suas configurações de análise.
4. Execute sua consulta. Os resultados são agrupados usando o fuso horário selecionado.

O fuso horário selecionado é salvo com a consulta. Quando você salva e recarrega uma consulta, o fuso horário é restaurado automaticamente.

<div id="account-default-timezone">
  ### Fuso horário padrão da conta
</div>

Se você tiver **Lock reporting timezone** ativado nas suas configurações de análise, selecionar **Account default** na barra de ferramentas usa esse fuso bloqueado para a sua consulta. O rótulo da barra de ferramentas mostra o fuso resolvido, por exemplo **Timezone: Account default (Paris (CET))**.

A página de configurações de análise aceita a lista IANA completa de fusos horários, mas Reports respeita apenas os dez fusos acima. Se o seu fuso bloqueado não for um deles, **Account default** resolve silenciosamente para UTC — então escolha um fuso bloqueado desta lista se quiser que Reports o siga.

Se **Lock reporting timezone** não estiver ativado, **Account default** volta para UTC.

<div id="specifying-a-timezone-in-aql">
  ### Especificando um fuso horário em AQL
</div>

Você também pode especificar um fuso horário diretamente na sua consulta AQL usando a cláusula `TIMEZONE`, que aparece entre `CHART` e `ORDER BY`:

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

Quando presente, a cláusula substitui a seleção da barra de ferramentas para essa consulta. O fuso horário é preservado quando você salva e recarrega a consulta.

<div id="available-timezones">
  ### Fusos horários disponíveis
</div>

O seletor de fuso horário inclui as seguintes opções:

| Fuso horário         | Local de exemplo           |
| -------------------- | -------------------------- |
| UTC                  | Tempo Universal Coordenado |
| America/New\_York    | Nova York (ET)             |
| America/Chicago      | Chicago (CT)               |
| America/Denver       | Denver (MT)                |
| America/Los\_Angeles | Los Angeles (PT)           |
| Europe/London        | Londres (GMT/BST)          |
| Europe/Paris         | Paris (CET/CEST)           |
| Asia/Tokyo           | Tóquio (JST)               |
| Asia/Singapore       | Singapura (SGT)            |
| Australia/Sydney     | Sydney (AEST/AEDT)         |

Este é um conjunto fechado de dez fusos. Qualquer outro fuso IANA em uma cláusula `TIMEZONE` é rejeitado como não suportado.

<div id="how-timezone-affects-query-results">
  ### Como o fuso horário afeta os resultados da consulta
</div>

Quando um fuso horário é definido, o agrupamento por data na sua consulta usa o horário local em vez de UTC. Por exemplo, um evento que ocorreu em `2026-03-29T01:30:00Z` (UTC) cai em 28 de março no horário de Nova York (ET), mas em 29 de março no horário de Paris (CET). Definir o fuso correto garante que seus detalhamentos diários, semanais e mensais correspondam às expectativas de relatório do seu negócio.

Consultas que não incluem um fuso horário — inclusive consultas salvas anteriormente — continuam sendo executadas em UTC, então os resultados existentes não são afetados.

***

<div id="need-help">
  ## Precisa de ajuda?
</div>

Se você tiver dúvidas sobre o Explorer ou quiser habilitar o acesso, entre em contato com a equipe de suporte do Aftersell pelo chat no app.