Referência de esquema do Query Studio

Referência completa de todas as tabelas consultáveis disponíveis no Zenovay Query Studio. Use este guia para explorar o esquema do banco de dados, entender tipos de coluna e escrever consultas SQL precisas.

Análise principal

visitors

Registros de visitantes individuais com geolocalização, informações do dispositivo, parâmetros de rastreamento UTM e pontuações de engajamento comportamental. Esta é a tabela principal para análise granular em nível de visitante.

analytics_daily

Estatísticas diárias pré-agregadas para consultas rápidas de dashboard. Use esta tabela em vez de visitors quando precisar de resumos diários — é significativamente mais rápida para relatórios de intervalo de datas.

page_views

Eventos de visualização de página individual com métricas de desempenho e engajamento. Cada linha representa um carregamento único de página por um visitante em uma sessão.

live_visitors

Visitantes atualmente ativos em seu site. Esta tabela é atualizada em tempo real e reflete os visitantes que estiveram ativos nos últimos minutos.

Receita e pagamentos

payments

Transações de pagamento sincronizadas de provedores de pagamento conectados (Stripe, LemonSqueezy, Polar). Cada linha representa uma transação única.

revenue_attribution

Receita atribuída a canais de marketing em períodos definidos. Use esta tabela para análise de ROI do canal e relatórios de desempenho de marketing.

identified_users

Usuários conhecidos que foram identificados através da API de identificação de visitantes. Inclui status de assinatura e dados de receita vitalícia.

Objetivos e funis

custom_goals

Definições de objetivo configuradas no painel. Cada objetivo rastreia uma ação do usuário específica, como visitar uma URL ou disparar um evento personalizado.

goal_completions

Eventos de conversão de objetivo individual. Cada linha representa uma única instância de um visitante completando um objetivo definido.

funnels

Definições de funil para rastreamento de conversão em múltiplas etapas.

funnel_steps

Etapas individuais em um funil, ordenadas sequencialmente. Faça join com funnels em funnel_id para obter a configuração completa do funil.

Erros e desempenho

error_groups

Tipos de erro agrupados com contagens de ocorrência e gravidade. Os erros são automaticamente desduplicados e agrupados por tipo e mensagem.

error_occurrences

Eventos de erro individual com contexto completo, incluindo rastreamentos de pilha e detalhes do ambiente.

performance_metrics

Medidas de Core Web Vitals (LCP, CLS, INP) coletadas do monitoramento de usuários reais. Cada linha é uma única medição de um carregamento de página.

Monitoramento de tempo de atividade

uptime_checks

Resultados de verificação de tempo de atividade individual do sistema de monitoramento. Cada linha representa um único ping de verificação de integridade para seu site.

uptime_daily

Agregados de tempo de atividade diário. Use-o para relatórios de SLA e análise de tendências em vez de consultar verificações individuais.

Comportamento do usuário

heatmap_data

Dados de mapa de calor de clique e rolagem agregados em uma sobreposição de grade. Cada linha representa uma célula de grade com contagens de interação acumuladas.

heatmap_sessions

Resumos em nível de sessão de dados de interação de mapa de calor por página.

replay_sessions

Metadados de gravação de sessão de reprodução. Cada linha representa uma sessão de navegação gravada que pode ser reproduzida no painel.

frustration_events

Sinais de frustração do usuário detectados, incluindo cliques de raiva, cliques mortos e cliques de erro.

scroll_depth_stats

Estatísticas de profundidade de rolagem agregadas por página, mostrando até onde os visitantes rolam em cada página.

session_history

Resumos de sessão concluída com métricas de engajamento e conversão.

B2B e empresas

b2b_companies

Empresas identificadas visitando seu site, enriquecidas com dados firmográficos da resolução de IP para empresa.

b2b_company_visits

Agregados de visita em nível de empresa. Faça join com b2b_companies em company_id = id para obter detalhes completos da empresa.

Marketing e campanhas

campaign_performance

Métricas de desempenho de campanha UTM agregadas por data. Use-a para análise de ROI de marketing e comparação de campanhas.

gsc_keyword_data

Dados de desempenho de palavras-chave do Google Search Console sincronizados através da integração do GSC. Mostra o desempenho de suas páginas nos resultados de pesquisa do Google.

Eventos personalizados

custom_events

Eventos de rastreamento definidos pelo usuário enviados via API de eventos personalizados. Cada linha representa uma única ocorrência de evento com propriedades opcionais e dados de receita.

events

Eventos em nível do sistema rastreados automaticamente pelo rastreador Zenovay. Inclui visualizações de página, cliques, envios de formulário e outros tipos de eventos integrados.

Outro

chart_notes

Anotações de painel anexadas a datas específicas. Estas aparecem como marcadores em gráficos de série temporal para fornecer contexto para tendências de dados.

alerts

Regras de alerta configuradas que acionam notificações quando as condições especificadas são atendidas.

websites

Registros de configuração do site. Cada site rastreado tem uma entrada aqui com suas configurações e código de rastreamento.

Consultas de exemplo

Análise principal

SELECT page_url, COUNT(*) as visits, AVG(time_on_page) as avg_time
FROM visitors
WHERE website_id = 'YOUR_WEBSITE_ID'
AND visited_at >= date_trunc('month', now())
GROUP BY page_url
ORDER BY visits DESC
LIMIT 10;

SELECT date, visitors, page_views, bounce_rate
FROM analytics_daily
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
ORDER BY date ASC;

Receita e pagamentos

SELECT marketing_channel, SUM(amount) as total_revenue, COUNT(*) as transactions
FROM payments
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'succeeded'
AND created_at >= date_trunc('month', now())
GROUP BY marketing_channel
ORDER BY total_revenue DESC;

SELECT email, name, total_revenue, subscription_status, subscription_plan
FROM identified_users
WHERE website_id = 'YOUR_WEBSITE_ID'
ORDER BY total_revenue DESC
LIMIT 20;

Objetivos e funis

SELECT utm_source, COUNT(*) as completions, SUM(completion_value) as total_value
FROM goal_completions
WHERE website_id = 'YOUR_WEBSITE_ID'
AND completed_at >= date_trunc('week', now())
GROUP BY utm_source
ORDER BY completions DESC;

Erros e desempenho

SELECT error_type, error_message, occurrence_count, user_count, severity, last_seen
FROM error_groups
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'open'
ORDER BY occurrence_count DESC
LIMIT 10;

SELECT page_url,
ROUND(AVG(lcp_value), 0) as avg_lcp_ms,
ROUND(AVG(cls_value), 3) as avg_cls,
ROUND(AVG(inp_value), 0) as avg_inp_ms
FROM performance_metrics
WHERE website_id = 'YOUR_WEBSITE_ID'
AND recorded_at >= now() - interval '7 days'
GROUP BY page_url
ORDER BY avg_lcp_ms DESC
LIMIT 10;

Monitoramento de tempo de atividade

SELECT date, uptime_percentage, avg_response_time_ms, incidents_count
FROM uptime_daily
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
ORDER BY date ASC;

Comportamento do usuário

SELECT page_url, frustration_type, COUNT(*) as occurrences
FROM frustration_events
WHERE website_id = 'YOUR_WEBSITE_ID'
AND timestamp >= now() - interval '7 days'
GROUP BY page_url, frustration_type
ORDER BY occurrences DESC
LIMIT 10;

SELECT visitor_id, duration_ms / 1000 as duration_seconds, total_events, started_at
FROM replay_sessions
WHERE website_id = 'YOUR_WEBSITE_ID'
AND duration_ms > 120000
ORDER BY started_at DESC
LIMIT 20;

B2B e empresas

SELECT c.name, c.industry, c.employee_count, v.total_visits, v.engagement_score, v.last_visit
FROM b2b_company_visits v
JOIN b2b_companies c ON c.id = v.company_id
WHERE v.website_id = 'YOUR_WEBSITE_ID'
ORDER BY v.engagement_score DESC
LIMIT 15;

Marketing e campanhas

SELECT utm_source, utm_campaign, SUM(visitors) as total_visitors,
SUM(conversions) as total_conversions, SUM(revenue) as total_revenue,
ROUND(AVG(bounce_rate), 3) as avg_bounce_rate
FROM campaign_performance
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
GROUP BY utm_source, utm_campaign
ORDER BY total_revenue DESC;

SELECT query, SUM(clicks) as total_clicks, SUM(impressions) as total_impressions,
ROUND(AVG(ctr), 4) as avg_ctr, ROUND(AVG(position), 1) as avg_position
FROM gsc_keyword_data
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '28 days'
GROUP BY query
ORDER BY total_clicks DESC
LIMIT 20;

Eventos personalizados

SELECT event_name, event_category, COUNT(*) as occurrences, SUM(revenue) as total_revenue
FROM custom_events
WHERE website_id = 'YOUR_WEBSITE_ID'
AND properties->>'source' IS NOT NULL
GROUP BY event_name, event_category
ORDER BY occurrences DESC
LIMIT 20;

Outro

SELECT note_date, content
FROM chart_notes
WHERE website_id = 'YOUR_WEBSITE_ID'
AND note_date >= date_trunc('month', now())
AND show_on_chart = true
ORDER BY note_date ASC;

SELECT name, alert_type, status, conditions
FROM alerts
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'active'
ORDER BY name;