Métricas disponíveis
Receita e lucro
Conversões
Engajamento
Desempenho da loja
Rede Rokt
Dimensões
Dimensões disponí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
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:
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
SELECTlista as métricas a medir, separadas por vírgulas, por exemploSELECT revenue, impressions, accept_rate.GROUP BYdivide essas métricas por uma ou mais dimensões, comodate,device,surfaceoufunnel. SemGROUP 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.
=, !=, 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
SINCE:
Predefinições disponíveis:
last_1d, last_7d, last_30d, last_90d, this_month, last_month e this_year.
GRAINdefine o tamanho do intervalo para séries temporais:day,weekoumonth. (houré interpretado, mas nenhum rollup fornece dados por hora, então essa consulta é rejeitada comgroup_by / time_grain combination is not supported.)COMPAREsobrepõe um segundo período. Useprevious_period, a janela de mesma duração imediatamente anterior.previous_yearfica 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
CHARTdefine como o resultado é exibido:scorecard,line_chart,bar_chart,area_chart,funnel_chartoutable.TIMEZONEdefine o fuso horário usado para agrupar datas, como um nome IANA entre aspas, por exemploTIMEZONE "America/New_York". O padrão é UTC (veja Fusos horários).
funnel_chart tem requisitos específicos:
- Modo de posicionamento. Agrupe por
placemente 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, conversionsmostra a queda de impressões para conversões). Todas as métricas devem ter a mesma unidade.
Ordenação e limite
ORDER BYordena os resultados por uma métrica ou dimensão, comASCouDESC.LIMITlimita 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
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
TIMEZONE, que aparece entre CHART e ORDER BY:
Fusos horários disponíveis
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
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.