Der 3D-Globus zeigt Ihre Besucher in Echtzeit an. Erfahren Sie, wie die Live-Aktualisierungen funktionieren und wie der Globus mit unterschiedlichen Verkehrsaufkommen umgeht.
Wie Echtzeit funktioniert
Supabase-Echtzeit-Abonnement
Der Globus verwendet Supabase-Echtzeit-Abonnements, um sofortige Besucher-Updates zu erhalten:
- Abonniert die
visitors-Tabelle, gefiltert nach Ihrer Website-ID - Lauscht auf
INSERT-Ereignisse (neue Besucher-Seitenaufrufe) - Aktualisierungen werden sofort ohne Seitenaktualisierung übertragen
- Die Verbindung wird automatisch verwaltet
Aktualisierungsablauf
Wenn jemand Ihre Website besucht:
- Tracking-Skript wird ausgelöst – Besucherdaten werden an die Zenovay API gesendet
- Daten werden gespeichert – Der Besucherdatensatz wird in die Datenbank eingefügt
- Echtzeit-Übertragung – Supabase überträgt den neuen Datensatz an den Globus
- Markierung erscheint – Eine DiceBear-Avatar-Markierung erscheint am Standort des Besuchers
Dieser Vorgang dauert in der Regel 1–2 Sekunden vom Seitenaufruf bis zur Markierungsanzeige.
Fallback-Polling
Zusätzlich zu den Echtzeit-Abonnements verfügt der Globus über ein Polling alle paar Sekunden als Sicherheitsnetz:
- Fragt den
/api/globe/visitors-Endpunkt ungefähr alle 5 Sekunden ab - Wird nur ausgeführt, wenn der Browser-Tab sichtbar ist (prüft
document.hidden) - Fängt alle Aktualisierungen ab, die möglicherweise vom Echtzeit-Abonnement verpasst wurden, einschließlich Besucher, die das Live-Fenster verlassen
- Stellt sicher, dass die Daten aktuell bleiben, auch wenn das Abonnement vorübergehend unterbrochen wird
Lebenszyklus der Besucherdaten
2-Minuten-Zeitfenster
Der Globus zeigt Besucher der letzten 2 Minuten:
| Ereignis | Zeitpunkt |
|---|---|
| Besucher lädt eine Seite | Markierung erscheint sofort |
| 2 Minuten vergangen | Markierung wird entfernt |
| Gleiche Sitzung, neue Seite | Alte Markierung wird durch neue ersetzt |
Markierungslimit
Bis zu 50 Besucher-Markierungen werden gleichzeitig angezeigt:
- Die neuesten Besucher werden priorisiert
- Wenn ein neuer Besucher eintrifft und das Limit erreicht ist, wird die älteste Markierung entfernt
- Die Statistik-Überlagerung zeigt immer die genaue Anzahl an, unabhängig vom Markierungslimit
Deduplizierung
Wenn ein Besucher mit einer bestehenden Sitzung eine weitere Seite lädt:
- Die vorherige Markierung für diese Sitzung wird ersetzt
- Nur der aktuellste Seitenaufruf jeder Sitzung wird angezeigt
- Dies verhindert doppelte Markierungen für denselben Besucher
Umgang mit Verbindungsabbrüchen
Warum Verbindungsabbrüche auftreten
Häufige Ursachen:
- Netzwerkunterbrechung
- Browser-Tab für längere Zeit im Hintergrund
- VPN- oder Firewall-Probleme
- Browser-Schlafmodus
Was bei einer Verbindungsunterbrechung passiert
Während einer Unterbrechung:
- Der Globus zeigt die zuletzt bekannten Besucherdaten
- Markierungen aus dem 2-Minuten-Zeitfenster können ablaufen und verschwinden
- Das Fallback-Polling wird gestoppt, wenn der Tab ausgeblendet ist
Wiederverbindung
Wenn die Verbindung wiederhergestellt wird oder der Tab in den Vordergrund kommt:
- Das Supabase-Echtzeit-Abonnement verbindet sich automatisch wieder
- Das Fallback-Polling wird fortgesetzt und ruft aktuelle Daten ab
- Markierungen werden aktualisiert, um den aktuellen Stand widerzuspiegeln
Manuelle Aktualisierung
Wenn die Daten veraltet erscheinen:
- Klicken Sie auf die Reload-Schaltfläche in der Globus-Steuerleiste
- Dies löst einen sofortigen Datenabruf aus
- Aktuelle Besucherdaten ersetzen die vorhandenen Markierungen
Tab-Verhalten
Aktiver Tab
Wenn der Globus-Tab im Vordergrund ist:
- Das Echtzeit-Abonnement liefert sofortige Aktualisierungen
- Das Fallback-Polling läuft alle paar Sekunden als Sicherheitsnetz
- Volles Rendering und Animationen aktiv
Tab im Hintergrund
Wenn der Globus-Tab nicht der aktive Tab ist:
- Der Browser kann die Verbindung drosseln
- Das Fallback-Polling wird pausiert (erkennt
document.hidden) - Das Rendering wird pausiert, um Ressourcen zu schonen
Rückkehr zum Tab
Wenn Sie zum Globus-Tab zurückwechseln:
- Das Fallback-Polling wird sofort fortgesetzt
- Ein neuer Datenabruf wird ausgelöst
- Markierungen werden aktualisiert, um aktuelle Besucher widerzuspiegeln
- Das Echtzeit-Abonnement holt alle aufgestauten Ereignisse nach
Umgang mit hohem Datenverkehr
Markierungsobergrenze
Der Globus begrenzt sichtbare Markierungen auf 50, unabhängig vom Verkehrsaufkommen:
- Dies gewährleistet eine gleichbleibende Leistung auch bei Verkehrsspitzen
- Neue Besucher werden immer angezeigt (älteste Markierungen werden zuerst entfernt)
- Die Top-Statistiken zeigen genaue aggregierte Zahlen an
Besucher-Ablauf
Besucher, die älter als 2 Minuten sind, laufen automatisch ab:
- Dies hält den Globus auf die aktuelle Aktivität fokussiert
- Verhindert Markierungsansammlungen bei anhaltendem hohem Datenverkehr
- Abgelaufene Besucher werden sowohl bei Echtzeit- als auch bei Polling-Aktualisierungen herausgefiltert
Leistungstipps
Für Echtzeit-Zuverlässigkeit
| Tipp | Grund |
|---|---|
| Tab im Vordergrund halten | Verhindert Browser-Drosselung |
| Stabile Internetverbindung nutzen | Reduziert Verbindungsabbrüche |
| Unnötige Tabs schließen | Gibt Browser-Ressourcen frei |
| Hardwarebeschleunigung aktivieren | Verbessert die Rendering-Leistung |
Für Büro-Displays
Wenn Sie den Globus als Live-Anzeige verwenden:
- Halten Sie den Browser-Tab aktiv und im Vordergrund
- Nutzen Sie den Vollbildmodus für eine beeindruckende Darstellung
- Aktivieren Sie den Musikplayer für Hintergrundmusik
- Das Fallback-Polling stellt sicher, dass die Daten aktuell bleiben, auch wenn das Echtzeit-Abonnement kurzzeitig ausfällt
Für Präsentationen
- Testen Sie die Globus-Verbindung vor der Präsentation
- Stellen Sie eine stabile Netzwerkverbindung sicher
- Verwenden Sie den Vollbildmodus
- Klicken Sie auf Reload, wenn Markierungen nicht wie erwartet erscheinen
Fehlerbehebung
Keine Echtzeit-Aktualisierungen
Wenn der Globus sich nicht aktualisiert:
- Klicken Sie auf die Reload-Schaltfläche, um eine manuelle Aktualisierung auszulösen
- Überprüfen Sie Ihre Internetverbindung
- Stellen Sie sicher, dass das Tracking-Skript auf Ihrer Website installiert ist und funktioniert
- Öffnen Sie die Browser-Entwicklerkonsole (F12) und suchen Sie nach Fehlern
- Versuchen Sie, die Seite neu zu laden
Verzögerte Aktualisierungen
Wenn Aktualisierungen langsam erscheinen:
- Überprüfen Sie Ihre Netzwerklatenz
- Deaktivieren Sie VPN, falls aktiv (kann Latenz hinzufügen)
- Schließen Sie bandbreitenintensive Anwendungen
- Stellen Sie sicher, dass der Tab im Vordergrund ist
Markierungen erscheinen nicht
Wenn Besucher nicht angezeigt werden:
- Überprüfen Sie, ob das Tracking-Skript auf Ihrer Website installiert ist
- Bestätigen Sie, dass Besucher in Ihrem Analytics-Dashboard vorhanden sind
- Stellen Sie sicher, dass die richtige Website ausgewählt ist
- Prüfen Sie, ob aktiver Datenverkehr vorhanden ist (Markierungen laufen nach 2 Minuten ab)