Le globe 3D affiche vos visiteurs en temps réel. Comprenez comment les mises à jour en direct fonctionnent et comment le globe gère différents niveaux de trafic.
Comment fonctionne le temps réel
Abonnement en temps réel Supabase
Le globe utilise les abonnements en temps réel Supabase pour recevoir les mises à jour instantanées des visiteurs :
- S'abonne au tableau
visitorsfiltré par votre ID de site Web - Écoute les événements
INSERT(nouveaux chargements de pages de visiteur) - Les mises à jour sont poussées instantanément sans rafraîchissement de page
- La connexion est gérée automatiquement
Flux de mise à jour
Quand quelqu'un visite votre site :
- Le script de suivi s'exécute - Les données du visiteur sont envoyées à l'API Zenovay
- Les données sont stockées - Un enregistrement de visiteur est inséré dans la base de données
- Diffusion en temps réel - Supabase envoie le nouvel enregistrement au globe
- Le marqueur apparaît - Un marqueur d'avatar DiceBear apparaît à la localisation du visiteur
Ce processus prend généralement 1-2 secondes du chargement de la page à l'apparition du marqueur.
Interrogation de secours
En plus des abonnements en temps réel, le globe dispose d'une interrogation toutes les quelques secondes en tant que filet de sécurité :
- Interroge le point de terminaison
/api/globe/visitorsenviron toutes les 5 secondes - S'exécute uniquement quand l'onglet du navigateur est visible (vérifie
document.hidden) - Capture toutes les mises à jour qui ont pu être manquées par l'abonnement en temps réel, y compris les visiteurs qui quittent la fenêtre de diffusion en direct
- Assure que les données restent fraîches même si l'abonnement se déconnecte temporairement
Cycle de vie des données de visiteur
Fenêtre de roulement de 2 minutes
Le globe affiche les visiteurs des 2 dernières minutes :
| Événement | Timing |
|---|---|
| Le visiteur charge une page | Le marqueur apparaît immédiatement |
| 2 minutes s'écoulent | Le marqueur est supprimé |
| Même session, nouvelle page | L'ancien marqueur est remplacé par le nouveau |
Limite des marqueurs
Jusqu'à 50 marqueurs de visiteurs sont affichés simultanément :
- Les visiteurs les plus récents sont prioritaires
- Quand un nouveau visiteur arrive et la limite est atteinte, le marqueur le plus ancien est supprimé
- La superposition de statistiques affiche toujours le nombre exact quel que soit la limite des marqueurs
Déduplication
Si un visiteur avec une session existante charge une autre page :
- Le marqueur précédent pour cette session est remplacé
- Seule la vue de page la plus récente pour chaque session est affichée
- Cela empêche les marqueurs en double pour le même visiteur
Gestion des déconnexions
Pourquoi les déconnexions se produisent
Causes courantes :
- Interruption réseau
- Onglet du navigateur en arrière-plan pendant de longues périodes
- Problèmes VPN ou pare-feu
- Mode veille du navigateur
Ce qui se passe lors de la déconnexion
Pendant la déconnexion :
- Le globe affiche les dernières données de visiteur connues
- Les marqueurs de la fenêtre de 2 minutes peuvent expirer et disparaître
- L'interrogation de secours s'arrêtera si l'onglet est masqué
Reconnexion
Quand la connexion est restaurée ou l'onglet est mis au premier plan :
- L'abonnement en temps réel Supabase se reconnecte automatiquement
- L'interrogation de secours reprend et récupère les données fraîches
- Les marqueurs se mettent à jour pour refléter l'état actuel
Actualisation manuelle
Si les données semblent obsolètes :
- Cliquez sur le bouton Recharger dans la barre de contrôle du globe
- Ceci déclenche une récupération de données immédiate
- Les données fraîches des visiteurs remplacent les marqueurs actuels
Comportement des onglets
Onglet actif
Quand l'onglet du globe est au premier plan :
- L'abonnement en temps réel fournit les mises à jour instantanément
- L'interrogation de secours toutes les quelques secondes s'exécute en tant que filet de sécurité
- Rendu et animations complets actifs
Onglet en arrière-plan
Quand l'onglet du globe n'est pas l'onglet actif :
- Le navigateur peut limiter la connexion
- L'interrogation de secours s'interrompt (détecte
document.hidden) - Le rendu s'interrompt pour économiser les ressources
Retour à l'onglet
Quand vous revenez à l'onglet du globe :
- L'interrogation de secours reprend immédiatement
- Une récupération de données fraîches est déclenchée
- Les marqueurs se mettent à jour pour refléter les visiteurs actuels
- L'abonnement en temps réel rattrape les événements en attente
Gestion du trafic élevé
Limite des marqueurs
Le globe limite les marqueurs visibles à 50, quel que soit le volume de trafic :
- Cela assure des performances cohérentes même lors des pics de trafic
- Les nouveaux visiteurs sont toujours affichés (les marqueurs les plus anciens sont supprimés en premier)
- La superposition de statistiques principales affiche les nombres agrégés exacts
Expiration des visiteurs
Les visiteurs plus anciens que 2 minutes sont automatiquement expirés :
- Cela maintient le globe concentré sur l'activité actuelle
- Empêche l'accumulation de marqueurs lors d'un trafic élevé soutenu
- Les visiteurs expirés sont filtrés lors des mises à jour en temps réel et d'interrogation
Conseils de performance
Pour la fiabilité en temps réel
| Conseil | Raison |
|---|---|
| Gardez l'onglet au premier plan | Empêche la limitation du navigateur |
| Utilisez une connexion Internet stable | Réduit les déconnexions |
| Fermez les onglets inutiles | Libère les ressources du navigateur |
| Activez l'accélération matérielle | Améliore les performances de rendu |
Pour les affichages au bureau
Si vous utilisez le globe comme affichage en direct :
- Gardez l'onglet du navigateur actif et au premier plan
- Utilisez le mode plein écran pour l'impact visuel
- Activez le lecteur de musique pour l'audio ambiant
- L'interrogation de secours assure que les données restent fraîches même si l'abonnement en temps réel s'interrompt brièvement
Pour les présentations
- Testez la connexion du globe avant de présenter
- Avoir une connexion réseau stable
- Utilisez le mode plein écran
- Cliquez sur Recharger si les marqueurs n'apparaissent pas comme prévu
Dépannage
Pas de mises à jour en temps réel
Si le globe ne se met pas à jour :
- Cliquez sur le bouton Recharger pour déclencher une actualisation manuelle
- Vérifiez votre connexion Internet
- Vérifiez que le script de suivi est installé et fonctionne sur votre site Web
- Ouvrez la console du développeur du navigateur (F12) et recherchez les erreurs
- Essayez d'actualiser la page
Mises à jour retardées
Si les mises à jour semblent lentes :
- Vérifiez votre latence réseau
- Désactivez le VPN s'il est actif (peut ajouter de la latence)
- Fermez les applications consommatrices de bande passante
- Assurez-vous que l'onglet est au premier plan
Les marqueurs n'apparaissent pas
Si les visiteurs ne s'affichent pas :
- Vérifiez que le script de suivi est installé sur votre site Web
- Confirmez que les visiteurs existent dans votre tableau de bord d'analyse
- Assurez-vous que le bon site Web est sélectionné
- Vérifiez que vous avez un trafic actif (les marqueurs expirent après 2 minutes)