Créer un Feature Flag
Créez un feature flag dans le tableau de bord QuickMonitoring — donnez-lui une clé, une description et un état par défaut (activé/désactivé). Le flag est immédiatement disponible pour être évalué dans votre code.
Ce que vous verrez
La page Feature Flags affiche la liste de tous vos flags existants avec, pour chacun :
- Clé (
slug) du flag — identifiant unique utilisé dans le code - Nom — libellé lisible affiché dans le tableau de bord
- Type —
Booléen(activé/désactivé) ouMultivariant(plusieurs valeurs) - État — pastille verte (activé) ou grise (désactivé)
- Déploiement — pourcentage d'utilisateurs exposés (ex.
100 %,25 %) - Dernière modification — date et auteur du dernier changement
En haut à droite se trouve le bouton Nouveau Flag, qui ouvre un formulaire de création.
Comment l'utiliser
Étape 1 — Ouvrir le formulaire de création
Depuis la barre latérale de votre site, cliquez sur Feature Flags, puis sur le bouton Nouveau Flag en haut à droite de la page.
Étape 2 — Remplir les informations du flag
Le formulaire comporte les champs suivants :
| Champ | Description |
|---|---|
| Clé | Identifiant technique du flag (kebab-case, ex. nouvelle-interface-paiement). Ce champ ne peut pas être modifié après la création. |
| Nom | Libellé affiché dans le tableau de bord (ex. Nouvelle interface de paiement). |
| Description | Contexte optionnel — pourquoi ce flag existe, quelle équipe l'utilise. |
| Type | Booléen pour un flag activé/désactivé simple. Multivariant pour plusieurs valeurs possibles (à configurer ensuite dans l'onglet Variantes). |
| État par défaut | Activé ou désactivé au moment de la création. |
Étape 3 — Enregistrer le flag
Cliquez sur Créer le flag. Le flag apparaît immédiatement dans la liste et peut être évalué dans votre code via le SDK.
Étape 4 — Utiliser le flag dans votre code
Une fois le flag créé, intégrez-le dans votre application avec le SDK :
// Flag booléen
const isEnabled = await QMTracker.getFlag('nouvelle-interface-paiement');
if (isEnabled) {
// Afficher la nouvelle interface
} else {
// Afficher l'ancienne interface
}
La clé passée à getFlag() doit correspondre exactement à la Clé saisie dans le formulaire.
Étape 5 — Activer ou désactiver le flag
Dans la liste des flags, utilisez le bouton bascule à droite de chaque flag pour l'activer ou le désactiver à tout moment, sans modifier le code.
Condition de validation
Vous obtenez cet achievement lorsque : au moins un feature flag a été créé dans le tableau de bord pour ce site, avec une clé valide et un type sélectionné.
Problèmes courants
La clé du flag est rejetée.
Les clés doivent contenir uniquement des lettres minuscules, des chiffres et des tirets (kebab-case). Les espaces, les underscores et les caractères spéciaux ne sont pas acceptés. Exemple valide : mode-sombre-beta.
getFlag() retourne toujours false alors que le flag est activé.
Vérifiez que la clé passée dans le code correspond exactement à la clé créée dans le tableau de bord (sensible à la casse). Vérifiez également que le SDK est correctement initialisé avec le bon siteId avant l'appel à getFlag().
Je ne vois pas le bouton "Nouveau Flag". Vous devez avoir le rôle Admin ou Développeur sur le projet pour créer des flags. Contactez le propriétaire de l'organisation pour obtenir les permissions nécessaires.