Réponse courte : les vues en temps réel se mettent à jour en moins de 5 secondes. Les rapports pré-agrégés (le tableau de bord principal, la répartition géographique, les tableaux des pages les plus consultées) se rafraîchissent sur un cycle de 1 à 2 minutes.
La répartition complète des délais
| Surface | Délai typique | Pourquoi |
|---|---|---|
| Onglet Live | < 5 secondes | Interroge l'endpoint des visiteurs actifs environ toutes les 5 secondes |
| Globe 3D | < 5 secondes | Streamé via Supabase Realtime sur WebSocket |
| Compteur de visiteurs (en-tête) | < 10 secondes | Cloudflare KV avec TTL court |
| Graphiques du tableau de bord principal | 1 à 2 minutes | Pré-agrégés pour la rapidité des requêtes |
| Top pages / sources / pays | 1 à 2 minutes | Pré-agrégés |
| Totaux journaliers (analytics_daily) | jusqu'à 5 minutes | Roulés dans une tâche à fenêtre courte |
| Graphiques de rétention / cohorte | 5 à 15 minutes | Plus coûteux ; calculés sur un cycle plus lent |
| Export CSV / JSON | jusqu'à 15 minutes | Tire du dernier rollup |
Ce que « temps réel » signifie en pratique
Lorsque le tracker déclenche track dans le navigateur d'un visiteur, la requête arrive aux Cloudflare Workers en 50 à 100 ms (POP edge le plus proche), est validée et transférée vers la base de données primaire UE, et s'affiche dans vos surfaces en direct quelques secondes après.
C'est pourquoi l'onglet Live et le globe 3D semblent instantanés. Le globe s'abonne directement au flux de la base de données via Supabase Realtime, tandis que l'onglet Live actualise sa liste de visiteurs actifs toutes les quelques secondes.
Pourquoi les graphiques principaux ont un délai de 1 à 2 minutes
Les graphiques comme « Pages vues sur les dernières 24h » n'effectuent pas un balayage complet de la table à chaque chargement du tableau de bord. À la place, une petite tâche en arrière-plan agrège les événements dans des seaux de temps pré-calculés toutes les 1 à 2 minutes. Cela rend le tableau de bord rapide même pour des sites avec des millions d'événements mensuels — au prix d'un petit décalage.
Si vous voulez vérifier qu'un événement tout neuf est arrivé, regardez l'onglet Live, pas les graphiques principaux.
Quand vous devez vous attendre à plus de 2 minutes
Quelques raisons légitimes de délais plus longs :
- Combinaisons de filtres lourdes — l'application de 5+ filtres peut basculer vers une requête directe, qui est plus lente que pré-agrégée.
- Plages de dates personnalisées qui incluent « maintenant » — certains sélecteurs de dates ré-agrègent à la volée.
- Rapports de rétention et de cohorte — ils sont calculés sur une cadence de 5 à 15 minutes par conception.
- Visiteurs récemment identifiés — le lien entre une session anonyme et un utilisateur connecté est traité de manière asynchrone et peut prendre jusqu'à une minute.
Dépannage
Si votre événement n'a toujours pas apparu après 5 minutes dans l'onglet Live, le problème est très probablement côté installation (script qui ne charge pas, bloqueur de pub, mauvais code de suivi) — voir Le premier événement n'apparaît pas et Vérifier votre installation.