Fiabilité & limites

Le SDK enregistre chaque événement localement avant de l’envoyer. Une coupure réseau, un onglet fermé trop tôt ou une API momentanément indisponible ne font pas perdre d’événements.

Cycle de vie d’un événement

File locale

Stockée dans IndexedDB (analytics_sdk_queue), ou dans le localStorage (analytics_event_queue) si IndexedDB n’est pas disponible.
1 000 événements au maximum.
track(), identify() et page() se résolvent dès l’écriture dans la file : l’interface n’attend jamais le réseau.

Envoi par lots

Un lot part dès que l’une de ces conditions est remplie :

Condition	Réglage
Délai écoulé depuis le dernier envoi	`flushIntervalMs`, 5 000 ms par défaut
Nombre d’événements en file	`flushBatchSize`, 10 par défaut
Onglet masqué ou page quittée	Automatique
Appel à `flush()`	Manuel

Les requêtes utilisent fetch avec keepalive: true, pour qu’un lot envoyé à la fermeture de la page puisse aboutir.

Nouvelles tentatives

Réponse	Comportement du SDK
`202`	Retire de la file les `eventIds` confirmés
Erreur réseau, `408`, `429`, `5xx`	Nouvelle tentative après un délai qui double à chaque échec (1 s, 2 s, 4 s… jusqu’à 60 s), en respectant `Retry-After`. Au plus `maxRetries` tentatives
`401`, `403`	Arrête d’envoyer et conserve la file. Corrigez la clé : les événements partiront au prochain chargement
Autre `4xx`	Divise le lot pour isoler les événements invalides, puis les écarte

Dédoublonnage

Chaque événement a un eventId fixé à sa création et jamais régénéré. Si un lot est renvoyé après une erreur réseau alors que le serveur l’avait déjà reçu, l’API reconnaît les eventId et n’enregistre pas de doublon.

Limites

Limite	Valeur	Au-delà
Événements par lot (API)	100	Lot refusé (`422`). Le SDK envoie des lots de `flushBatchSize` événements : gardez cette option sous 100
Taille de `properties`	32 Ko	Le SDK retire le contexte non essentiel, en gardant `sdk`, `session`, `page` et `custom`, puis `page` si nécessaire
Texte d’un élément cliqué	100 caractères	Coupé avec `…`
Chaîne dans vos propriétés	400 caractères	Coupée avec `…`
Profondeur d’imbrication	6 niveaux	Valeurs plus profondes supprimées
Débit par clé	120 requêtes/min	`429`, nouvelle tentative automatique
Débit par IP	180 requêtes/min	`429`, nouvelle tentative automatique
Quota mensuel	Selon le plan	Événements acceptés (`202`) mais non enregistrés
Horodatage	7 jours dans le passé, 10 min dans le futur	Remplacé par l’heure de réception

Tester le mode hors ligne

Couper le réseau

Outils de développement → Network → Offline.

Naviguer

Changez de page, cliquez. Les événements s’accumulent dans IndexedDB (onglet Application → IndexedDB → analytics_sdk_queue).

Rétablir le réseau

Repassez en No throttling. Les événements partent au prochain envoi.

​Cycle de vie d’un événement

​File locale

​Envoi par lots

​Nouvelles tentatives

​Dédoublonnage

​Limites

​Tester le mode hors ligne