Query Studio Schema Referenz

Komplettes Referenzmaterial für alle abfragbaren Tabellen in Zenovay Query Studio. Verwenden Sie diese Anleitung, um das Datenbankschema zu erkunden, Spaltentypen zu verstehen und genaue SQL-Abfragen zu schreiben.

Kern-Analytics

visitors

Einzelne Besucherdatensätze mit Geolokalisierung, Geräteinformationen, UTM-Tracking-Parametern und Verhaltensengagement-Scores. Dies ist die primäre Tabelle für granulare Besucheranalysen auf Datensatzebene.

analytics_daily

Vorberechnete tägliche Statistiken für schnelle Dashboard-Abfragen. Verwenden Sie diese Tabelle statt visitors, wenn Sie tägliche Zusammenfassungen benötigen — sie ist deutlich schneller für Datumsbereichsberichte.

page_views

Einzelne Seitenaufrufereignisse mit Leistungs- und Engagement-Metriken. Jede Zeile stellt einen einzelnen Seitenladevorgang durch einen Besucher innerhalb einer Sitzung dar.

live_visitors

Derzeit aktive Besucher auf Ihrer Website. Diese Tabelle wird in Echtzeit aktualisiert und spiegelt Besucher wider, die in den letzten Minuten aktiv waren.

Umsatz & Zahlungen

payments

Zahlungstransaktionen, die mit verbundenen Zahlungsanbietern synchronisiert sind (Stripe, LemonSqueezy, Polar). Jede Zeile stellt eine einzelne Transaktion dar.

revenue_attribution

Umsatz, der Marketing-Kanälen über definierte Zeiträume zugeordnet ist. Verwenden Sie diese Tabelle für Kanal-ROI-Analysen und Marketing-Performance-Berichte.

identified_users

Bekannte Benutzer, die über die Besucher-Identifikations-API identifiziert wurden. Einschließlich Abonnementstatus und Lifetime-Revenue-Daten.

Ziele & Funnels

custom_goals

Im Dashboard konfigurierte Zieldefinitionen. Jedes Ziel verfolgt eine spezifische Benutzeraktion wie das Besuchen einer URL oder das Auslösen eines benutzerdefinierten Ereignisses.

goal_completions

Einzelne Zielkonversionsereignisse. Jede Zeile stellt eine einzelne Instanz dar, in der ein Besucher ein definiertes Ziel erfüllt.

funnels

Funnel-Definitionen für Multi-Step-Konversionsverfolgung.

funnel_steps

Einzelne Schritte innerhalb eines Funnels, sequenziell angeordnet. Verbinden Sie mit funnels über funnel_id, um die vollständige Funnel-Konfiguration zu erhalten.

Fehler & Leistung

error_groups

Gruppierte Fehlertypen mit Vorkommen-Zählungen und Schweregrad. Fehler werden automatisch dedupliziert und nach Typ und Meldung gruppiert.

error_occurrences

Einzelne Fehlerereignisse mit vollständigem Kontext einschließlich Stack-Traces und Umgebungsdetails.

performance_metrics

Core Web Vitals Messungen (LCP, CLS, INP) aus Real-User-Überwachung. Jede Zeile ist eine einzelne Messung aus einem Seitenladevorgang.

Verfügbarkeitskontrolle

uptime_checks

Einzelne Verfügbarkeitsprüf-Ergebnisse aus dem Überwachungssystem. Jede Zeile stellt einen einzelnen Health-Check-Ping zu Ihrer Website dar.

uptime_daily

Tägliche Verfügbarkeitszusammenfassungen. Verwenden Sie diese für SLA-Berichte und Trendanalysen statt einzelne Prüfungen abzufragen.

Benutzerverhalten

heatmap_data

Aggregierte Click- und Scroll-Heatmap-Daten auf einem Gitter-Overlay. Jede Zeile stellt eine Gitterzelle mit kumulativen Interaktionszählungen dar.

heatmap_sessions

Session-Level-Zusammenfassungen von Heatmap-Interaktionsdaten pro Seite.

replay_sessions

Metadaten von Session-Replay-Aufzeichnungen. Jede Zeile stellt eine aufgezeichnete Browsersitzung dar, die im Dashboard wiedergegeben werden kann.

frustration_events

Erkannte Frustrationsignale des Benutzers, einschließlich Rage Clicks, Dead Clicks und Error Clicks.

scroll_depth_stats

Aggregierte Scroll-Tiefen-Statistiken nach Seite, die zeigen, wie weit Besucher auf jeder Seite scrollen.

session_history

Abgeschlossene Sitzungszusammenfassungen mit Engagement- und Konversionsmetriken.

B2B & Unternehmen

b2b_companies

Identifizierte Unternehmen, die Ihre Website besuchen, mit Firmographiedaten aus IP-zu-Unternehmen-Auflösung angereichert.

b2b_company_visits

Unternehmen-Level-Besuchszusammenfassungen. Verbinden Sie mit b2b_companies über company_id = id für vollständige Unternehmensdetails.

Marketing & Kampagnen

campaign_performance

UTM-Kampagnen-Performance-Metriken aggregiert nach Datum. Verwenden Sie diese für Marketing-ROI-Analysen und Kampagnenvergleiche.

gsc_keyword_data

Google Search Console Stichwort-Performance-Daten, die via GSC-Integration synchronisiert sind. Zeigt die Performance Ihrer Seiten in Google-Suchergebnissen.

Benutzerdefinierte Ereignisse

custom_events

Benutzer-definierte Tracking-Ereignisse, die über die API für benutzerdefinierte Ereignisse gesendet wurden. Jede Zeile stellt ein einzelnes Ereignisvorkommen mit optionalen Eigenschaften und Umsatzdaten dar.

events

Systemebenen-Ereignisse, die automatisch vom Zenovay-Tracker verfolgt werden. Einschließlich Seitenaufrufen, Klicks, Formularübermittlungen und anderen integrierten Ereignistypen.

Sonstiges

chart_notes

Dashboard-Anmerkungen angehängt an spezifische Daten. Diese werden als Marker auf Zeitreih-Charts angezeigt, um Kontext für Datentrends zu bieten.

alerts

Konfigurierte Warnregeln, die Benachrichtigungen auslösen, wenn angegebene Bedingungen erfüllt sind.

websites

Website-Konfigurationsdatensätze. Jede verfolgte Website hat einen Eintrag hier mit ihren Einstellungen und dem Tracking-Code.

Beispiele-Abfragen

Kern-Analytics

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;

Umsatz & Zahlungen

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;

Ziele & Funnels

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;

Fehler & Leistung

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;

Verfügbarkeitskontrolle

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;

Benutzerverhalten

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 & Unternehmen

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 & Kampagnen

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;

Benutzerdefinierte Ereignisse

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;

Sonstiges

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;