Référence du schéma de Query Studio

Référence complète de toutes les tables interrogeables disponibles dans Zenovay Query Studio. Utilisez ce guide pour explorer le schéma de la base de données, comprendre les types de colonnes et écrire des requêtes SQL précises.

Analytiques de base

visitors

Enregistrements de visiteurs individuels avec géolocalisation, informations sur les appareils, paramètres de suivi UTM et scores d'engagement comportemental. Ceci est la table principale pour l'analyse granulaire au niveau des visiteurs.

analytics_daily

Statistiques quotidiennes pré-agrégées pour les requêtes de tableau de bord rapides. Utilisez cette table au lieu de visitors lorsque vous avez besoin de résumés quotidiens — elle est considérablement plus rapide pour les rapports sur les plages de dates.

page_views

Événements de pages vues individuels avec des métriques de performance et d'engagement. Chaque ligne représente un chargement de page unique par un visiteur dans une session.

live_visitors

Visiteurs actuellement actifs sur votre site Web. Cette table est mise à jour en temps réel et reflète les visiteurs actifs au cours des dernières minutes.

Revenus et paiements

payments

Transactions de paiement synchronisées à partir de fournisseurs de paiement connectés (Stripe, LemonSqueezy, Polar). Chaque ligne représente une transaction unique.

revenue_attribution

Revenus attribués aux canaux marketing sur des périodes définies. Utilisez cette table pour l'analyse du ROI des canaux et les rapports de performance marketing.

identified_users

Utilisateurs connus qui ont été identifiés via l'API d'identification des visiteurs. Inclut l'état de l'abonnement et les données de revenu à vie.

Objectifs et entonnoirs

custom_goals

Définitions d'objectifs configurées dans le tableau de bord. Chaque objectif suit une action utilisateur spécifique telle que la visite d'une URL ou le déclenchement d'un événement personnalisé.

goal_completions

Événements de conversion d'objectifs individuels. Chaque ligne représente une seule instance d'un visiteur réalisant un objectif défini.

funnels

Définitions d'entonnoir pour le suivi des conversions multi-étapes.

funnel_steps

Étapes individuelles au sein d'un entonnoir, ordonnées séquentiellement. Joindre avec funnels sur funnel_id pour obtenir la configuration complète de l'entonnoir.

Erreurs et performance

error_groups

Types d'erreurs groupés avec dénombrements d'occurrences et gravité. Les erreurs sont automatiquement dédupliquées et groupées par type et message.

error_occurrences

Événements d'erreur individuels avec contexte complet, notamment les traces de pile et les détails d'environnement.

performance_metrics

Mesures de Core Web Vitals (LCP, CLS, INP) collectées à partir de la surveillance des utilisateurs réels. Chaque ligne est une mesure unique d'un chargement de page.

Surveillance du temps de fonctionnement

uptime_checks

Résultats de vérification du temps de fonctionnement individuels du système de surveillance. Chaque ligne représente un seul ping de contrôle de santé vers votre site Web.

uptime_daily

Agrégats de temps de fonctionnement quotidiens. Utilisez ceci pour les rapports SLA et l'analyse des tendances au lieu d'interroger les vérifications individuelles.

Comportement de l'utilisateur

heatmap_data

Données de carte thermique de clic et de défilement agrégées sur une superposition de grille. Chaque ligne représente une cellule de grille avec dénombrements d'interactions cumulées.

heatmap_sessions

Résumés au niveau de la session des données d'interaction de la carte thermique par page.

replay_sessions

Métadonnées d'enregistrement de relecture de session. Chaque ligne représente une session de navigation enregistrée qui peut être relue dans le tableau de bord.

frustration_events

Signaux de frustration de l'utilisateur détectés, notamment les clics de rage, les clics morts et les clics d'erreur.

scroll_depth_stats

Statistiques agrégées de profondeur de défilement par page, montrant jusqu'où les visiteurs font défiler chaque page.

session_history

Résumés de session terminés avec des métriques d'engagement et de conversion.

B2B et entreprises

b2b_companies

Entreprises identifiées visitant votre site Web, enrichies de données firmographiques provenant de la résolution IP vers entreprise.

b2b_company_visits

Agrégats de visite au niveau de l'entreprise. Joindre avec b2b_companies sur company_id = id pour les détails complets de l'entreprise.

Marketing et campagnes

campaign_performance

Métriques de performance de campagne UTM agrégées par date. Utilisez ceci pour l'analyse du ROI marketing et la comparaison de campagnes.

gsc_keyword_data

Données de performance des mots-clés Google Search Console synchronisées via l'intégration GSC. Montre les performances de vos pages dans les résultats de recherche Google.

Événements personnalisés

custom_events

Événements de suivi définis par l'utilisateur envoyés via l'API des événements personnalisés. Chaque ligne représente une seule occurrence d'événement avec des propriétés optionnelles et des données de revenu.

events

Événements au niveau du système suivis automatiquement par le suivi Zenovay. Inclut les pages vues, les clics, les soumissions de formulaires et autres types d'événements intégrés.

Autre

chart_notes

Annotations de tableau de bord attachées à des dates spécifiques. Ceux-ci apparaissent en tant que marqueurs sur les graphiques de séries chronologiques pour fournir un contexte pour les tendances des données.

alerts

Règles d'alerte configurées qui déclenchent des notifications lorsque les conditions spécifiées sont remplies.

websites

Enregistrements de configuration de site Web. Chaque site Web suivi a une entrée ici avec ses paramètres et son code de suivi.

Exemples de requêtes

Analytiques de base

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;

Revenus et paiements

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;

Objectifs et entonnoirs

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;

Erreurs et performance

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;

Surveillance du temps de fonctionnement

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;

Comportement de l'utilisateur

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 et entreprises

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 et campagnes

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;

Événements personnalisés

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;

Autre

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;