Referencia de esquema de Query Studio

Referencia completa de todas las tablas consultables disponibles en Zenovay Query Studio. Utilice esta guía para explorar el esquema de la base de datos, comprender los tipos de columna y escribir consultas SQL precisas.

Análisis principal

visitors

Registros de visitantes individuales con geolocalización, información del dispositivo, parámetros de seguimiento UTM y puntuaciones de participación de comportamiento. Esta es la tabla principal para análisis granular a nivel de visitante.

analytics_daily

Estadísticas diarias preagreadas para consultas rápidas de panel. Utilice esta tabla en lugar de visitors cuando necesite resúmenes diarios — es significativamente más rápida para informes de rango de fechas.

page_views

Eventos de visualización de página individual con métricas de rendimiento y participación. Cada fila representa una carga de página única por parte de un visitante dentro de una sesión.

live_visitors

Visitantes actualmente activos en su sitio web. Esta tabla se actualiza en tiempo real y refleja a los visitantes que han estado activos en los últimos minutos.

Ingresos y pagos

payments

Transacciones de pago sincronizadas de proveedores de pago conectados (Stripe, LemonSqueezy, Polar). Cada fila representa una única transacción.

revenue_attribution

Ingresos atribuidos a canales de marketing durante períodos definidos. Utilice esta tabla para análisis de ROI del canal e informes de desempeño de marketing.

identified_users

Usuarios conocidos que han sido identificados a través de la API de identificación de visitantes. Incluye estado de suscripción y datos de ingresos de por vida.

Objetivos y embudos

custom_goals

Definiciones de objetivos configuradas en el panel. Cada objetivo rastrea una acción de usuario específica, como visitar una URL o desencadenar un evento personalizado.

goal_completions

Eventos de conversión de objetivo individual. Cada fila representa una única instancia de un visitante completando un objetivo definido.

funnels

Definiciones de embudos para rastreo de conversión de múltiples pasos.

funnel_steps

Pasos individuales dentro de un embudo, ordenados secuencialmente. Únase con funnels en funnel_id para obtener la configuración completa del embudo.

Errores y rendimiento

error_groups

Tipos de error agrupados con recuentos de ocurrencias y gravedad. Los errores se desduplican automáticamente y se agrupan por tipo y mensaje.

error_occurrences

Eventos de error individual con contexto completo, incluidos seguimientos de pila y detalles del entorno.

performance_metrics

Medidas de Core Web Vitals (LCP, CLS, INP) recopiladas de la monitorización de usuarios reales. Cada fila es una única medición de una carga de página.

Monitoreo de disponibilidad

uptime_checks

Resultados de verificación de disponibilidad individuales del sistema de monitoreo. Cada fila representa un único ping de verificación de estado a su sitio web.

uptime_daily

Agregados de disponibilidad diarios. Utilice esto para informes de SLA y análisis de tendencias en lugar de consultar verificaciones individuales.

Comportamiento del usuario

heatmap_data

Datos de mapa de calor de clic y desplazamiento agregados en una superposición de cuadrícula. Cada fila representa una celda de cuadrícula con recuentos de interacción acumulados.

heatmap_sessions

Resúmenes a nivel de sesión de datos de interacción de mapas de calor por página.

replay_sessions

Metadatos de grabación de reproducción de sesión. Cada fila representa una sesión de navegación grabada que se puede reproducir en el panel.

frustration_events

Señales de frustración del usuario detectadas, incluidos clics de cólera, clics muertos y clics de error.

scroll_depth_stats

Estadísticas de profundidad de desplazamiento agregadas por página, que muestran qué tan lejos se desplazan los visitantes en cada página.

session_history

Resúmenes de sesión completados con métricas de participación y conversión.

B2B y empresas

b2b_companies

Empresas identificadas que visitan su sitio web, enriquecidas con datos firmográficos de la resolución IP a empresa.

b2b_company_visits

Agregados de visita a nivel de empresa. Únase con b2b_companies en company_id = id para obtener detalles completos de la empresa.

Marketing y campañas

campaign_performance

Métricas de rendimiento de campaña UTM agregadas por fecha. Utilice esto para análisis de ROI de marketing y comparación de campañas.

gsc_keyword_data

Datos de rendimiento de palabras clave de Google Search Console sincronizados a través de la integración de GSC. Muestra cómo funcionan sus páginas en los resultados de búsqueda de Google.

Eventos personalizados

custom_events

Eventos de seguimiento definidos por el usuario enviados a través de la API de eventos personalizados. Cada fila representa una única ocurrencia de evento con propiedades opcionales y datos de ingresos.

events

Eventos a nivel del sistema rastreados automáticamente por el rastreador Zenovay. Incluye vistas de página, clics, envíos de formularios y otros tipos de eventos integrados.

Otro

chart_notes

Anotaciones de panel adjuntas a fechas específicas. Estos aparecen como marcadores en gráficos de series de tiempo para proporcionar contexto para las tendencias de datos.

alerts

Reglas de alerta configuradas que desencadenan notificaciones cuando se cumplen las condiciones especificadas.

websites

Registros de configuración de sitio web. Cada sitio web rastreado tiene una entrada aquí con su configuración y código de seguimiento.

Consultas de ejemplo

Análisis 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;

Ingresos y pagos

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 y embudos

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;

Errores y rendimiento

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;

Monitoreo de disponibilidad

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;

Comportamiento del usuario

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 y 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 y campañas

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;

Otro

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;