Déploiement Progressif
Déployez une fonctionnalité à un pourcentage de vos utilisateurs — par exemple, activez pour 10 % du trafic, puis 25 %, puis 100 %. La distribution est cohérente : un même utilisateur reçoit toujours la même expérience.
Ce que vous verrez
L'onglet Déploiement de la page de détail d'un flag affiche :
- Un curseur de pourcentage de 0 % à 100 %
- La valeur actuelle du déploiement (ex.
25 %) - Un message explicatif indiquant combien d'utilisateurs sont exposés approximativement
- Un bouton Enregistrer pour valider le changement
La modification du pourcentage prend effet immédiatement — aucune redéployage de code n'est nécessaire.
Comment l'utiliser
Étape 1 — Ouvrir l'onglet Déploiement
Sur la page de détail du flag, cliquez sur l'onglet Déploiement (ou Rollout selon la langue de l'interface).
Étape 2 — Définir le pourcentage initial
Pour un déploiement progressif typique, commencez avec une valeur faible :
- 5 % — test interne ou validation technique initiale
- 10 % — early adopters et surveillance des métriques
- 25 % — déploiement partiel avec données suffisantes pour prendre une décision
- 50 % — moitié de vos utilisateurs, utile pour les tests A/B
- 100 % — déploiement complet
Déplacez le curseur sur la valeur souhaitée, puis cliquez sur Enregistrer.
Étape 3 — Surveiller les métriques
Après chaque augmentation du pourcentage, surveillez :
- Les erreurs JavaScript et les erreurs HTTP dans l'onglet Erreurs de votre site
- Les métriques de performance (temps de chargement) dans l'onglet Surveillance
- Les événements de conversion dans vos entonnoirs Analytics
Si les métriques se dégradent, abaissez immédiatement le pourcentage à 0 % pour retirer la fonctionnalité de production sans modifier le code.
Étape 4 — Augmenter progressivement
Suivez un calendrier de déploiement progressif :
| Jour | Pourcentage | Action si tout va bien |
|---|---|---|
| J+0 | 5 % | Validation technique, pas d'alerte |
| J+1 | 20 % | Vérification des métriques utilisateur |
| J+3 | 50 % | Test à grande échelle |
| J+7 | 100 % | Déploiement complet |
Comportement déterministe de l'assignation
L'assignation d'un utilisateur au groupe exposé est déterministe — elle repose sur un hachage de l'identifiant utilisateur et de la clé du flag. Cela garantit que :
- Un utilisateur dans le groupe exposé à 10 % le restera lorsque vous passerez à 20 % (les 10 % initiaux sont inclus dans les 20 %).
- Il n'y a pas de "re-randomisation" à chaque page vue — l'expérience est stable entre les sessions.
// L'utilisateur alice@example.com verra toujours le même résultat
// pour un pourcentage de déploiement donné
const isEnabled = await QMTracker.getFlag('nouvelle-page-accueil');
Combiner déploiement progressif et ciblage
Le déploiement progressif s'applique aux utilisateurs qui ne correspondent à aucune règle de ciblage spécifique. Les utilisateurs ciblés explicitement (via l'onglet Ciblage) sont toujours inclus à 100 %, quelle que soit la valeur du curseur.
Exemple : si vous ciblez tous les utilisateurs avec plan = "pro" (100 % pour eux) et configurez un déploiement à 10 % pour le reste, les utilisateurs Pro voient toujours la fonctionnalité, et 10 % des autres utilisateurs la voient aussi.
Condition de validation
Vous obtenez cet achievement lorsque : le pourcentage de déploiement d'un flag est modifié (différent de 0 % et de 100 %) et enregistré dans le tableau de bord pour ce site.
Problèmes courants
Tous mes utilisateurs de test voient la fonctionnalité même à 5 %.
Si vous utilisez toujours le même compte utilisateur pour tester, vérifiez que QMTracker.identify() est appelé avec cet identifiant. L'assignation est déterministe — si cet utilisateur tombe dans les 5 % exposés, il verra toujours la fonctionnalité. Testez avec plusieurs comptes différents pour observer la distribution.
getFlag() retourne false pour tous les utilisateurs même à 100 %.
Vérifiez que le flag est activé (bascule verte dans la liste). Un flag désactivé retourne toujours false quel que soit le pourcentage de déploiement.
Je veux retirer la fonctionnalité immédiatement.
Passez le pourcentage à 0 % et enregistrez. La fonctionnalité est immédiatement retirée pour tous les utilisateurs, sans déploiement de code. Pour une désactivation totale, vous pouvez aussi désactiver le flag via la bascule dans la liste.