Skip to main content
Toda consulta que você cria no Explorer é uma instrução AftersellQL (AQL). Na maior parte do tempo, você cria consultas visualmente e nunca escreve AQL à mão; esta página é a referência para as métricas e dimensões que você pode escolher, a forma textual do AQL e as regras de fuso horário.

Métricas disponíveis

Estas são as métricas que você pode escolher, 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 dividem uma métrica por um atributo. Nem todas as dimensões são compatíveis com todas as métricas; o Explorer impede automaticamente combinações incompatíveis (por exemplo, Decline rate e Show rate não podem ser divididas por Currency).

Dimensões disponíveis

Dimensões indisponíveis

As dimensões a seguir estão em desenvolvimento. Elas aparecem no seletor, mas são exibidas como ‘Not compatible’ para todas as métricas até serem implementadas.

Sintaxe das instruções AQL

Uma instrução AQL é uma única pergunta composta por cláusulas. Apenas SELECT e um intervalo de tempo (SINCE) são obrigatórios; todo o resto é opcional. Ao incluir cláusulas opcionais, elas devem aparecer nesta ordem:
Um exemplo mínimo, receita de upsell diária 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 texto ficam entre aspas duplas; números e listas não.

SELECT e GROUP BY

  • SELECT lista as métricas a medir, separadas por vírgulas, por exemplo SELECT revenue, impressions, accept_rate.
  • GROUP BY divide 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.

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. O filtro de funnel suporta seleção múltipla: is one of (IN) inclui apenas os funis selecionados, e is not one of (NOT IN) os exclui. Quando você agrupa por Funnel e aplica um filtro is one of, o gráfico mostra uma linha por funil selecionado, sem agrupamento em “Other”.

Intervalos de tempo e comparações

Toda consulta precisa de um intervalo de tempo, definido com SINCE: Predefinições 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. Use previous_period, a janela de mesma duração imediatamente anterior. previous_year fica oculto no seletor Compare porque o data warehouse não contém dados anteriores a fevereiro de 2026; ele continua aceito no AQL apenas para que consultas salvas anteriormente continuem sendo interpretadas.
Os dados de relatórios começam em fevereiro de 2026, então uma janela anterior a isso retorna vazio para ambos os períodos.

Escolhendo um gráfico

  • 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 (veja Fusos horários).
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, depois downsell, depois upsells adicionais). Apenas a primeira métrica é plotada; métricas adicionais são mencionadas em uma nota de rodapé.
  • Modo de métricas. 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 impressões para conversões). Todas as métricas devem ter a mesma unidade.
O modo de posicionamento precisa de uma métrica que possa ser dividida por posicionamento. impressions, accept_rate e rpv não podem; para elas, o gráfico de funil mostra “These metrics can’t be grouped by placement”.

Ordenação e limite

  • 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 divididas por dispositivo; o rollup delas é loja × superfície × dia, sem coluna de dispositivo. Use revenue (ou outra métrica originada de conversões) para comparações por dispositivo.

Fusos horários

Por padrão, as consultas são executadas em UTC. Você pode substituir o fuso horário para que os resultados agrupados por data reflitam o horário local (veja Definindo um fuso horário para os passos na barra de ferramentas).
Consultas que incluem Impressions, Accept Rate ou Revenue Per Visit sempre agrupam datas em UTC, independentemente do fuso horário selecionado, porque elas vêm de um rollup diário reportado em dias UTC. Se uma consulta misturar uma delas com outras métricas, todo o conjunto de resultados volta para UTC para que os intervalos de data permaneçam alinhados.

A cláusula TIMEZONE

Especifique um fuso horário diretamente no AQL com 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 aquela consulta e é preservada quando você salva e recarrega.

Fusos horários disponíveis

O seletor (e a cláusula TIMEZONE) aceita um conjunto fechado de dez fusos. Qualquer outro fuso horário IANA é rejeitado como não suportado.

Padrão da conta e como o fuso horário afeta os resultados

Se Lock reporting timezone estiver ativado nas suas configurações de análises, selecionar Account default usa esse fuso horário bloqueado (a barra de ferramentas mostra o fuso resolvido, por exemplo Timezone: Account default (Paris (CET))). A página de configurações de análises aceita a lista IANA completa, mas o Reports respeita apenas os dez fusos acima; se o seu fuso bloqueado não for um deles, Account default é resolvido silenciosamente para UTC. Se Lock reporting timezone não estiver ativado, Account default volta para UTC. Quando um fuso horário é definido, o agrupamento por data usa o horário local em vez de UTC. Por exemplo, um evento em 2026-03-29T01:30:00Z cai em 28 de março em Nova York (ET), mas em 29 de março em Paris (CET). Consultas sem fuso horário, incluindo as salvas anteriormente, continuam sendo executadas em UTC.