Skip to main content
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.
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 abaixo para a referência de sintaxe.

Métricas disponíveis

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

Receita e lucro

Conversões

Engajamento

Desempenho da loja

Rede Rokt


Dimensões

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

Dimensões disponíveis

Dimensões indisponíveis

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.

Escrevendo consultas AQL

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.

Como se lê uma instrução AQL

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.
Um exemplo mínimo — receita diária de upsell e taxa de aceitação dos últimos 30 dias:
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.

Escolhendo o que medir e como segmentar

  • 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 e Dimensões disponíveis acima. O Explorer evita automaticamente combinações incompatíveis de métrica e dimensão.

Filtrando com WHERE

WHERE restringe os dados antes de serem medidos. Combine condições com AND.
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".
As comparações suportadas são =, !=, IN, NOT IN, >, <, >= e <=. Use uma lista com IN para corresponder a vários valores:
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.)

Filtrando por vários funis

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

Intervalos de tempo e comparações

Toda consulta precisa de um intervalo de tempo, definido com SINCE. Use um predefinido ou uma janela personalizada. 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.
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.

Escolhendo um gráfico e fuso horário

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

Ordenando e limitando

  • 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”.

Mais exemplos

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

Exportando resultados

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

Suporte a fusos horários

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

Definindo um fuso horário para uma consulta

  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.

Fuso horário padrão da conta

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.

Especificando um fuso horário em AQL

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

Fusos horários disponíveis

O seletor de fuso horário inclui as seguintes opções: Este é um conjunto fechado de dez fusos. Qualquer outro fuso IANA em uma cláusula TIMEZONE é rejeitado como não suportado.

Como o fuso horário afeta os resultados da consulta

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.

Precisa de ajuda?

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.