Skip to main content
Les variantes de test reçoivent des plages stables de pourcentage du trafic et tous les autres sont placés dans le groupe témoin, de sorte qu’augmenter une allocation ne déplace jamais un utilisateur existant vers un autre bras. Utilisez l’API Experiments pour créer un brouillon, configurer ses pondérations, son ciblage et ses liaisons de ressources, puis l’activer, le mettre en pause ou y mettre fin, et pour déterminer quel bras obtient un utilisateur, un compte ou un visiteur anonyme. La gestion des expériences nécessite experiment:read ou experiment:manage ; l’évaluation fonctionne sans authentification.

Endpoints

Attributs

string
requis
Identifiant unique de l’expérience, préfixé par expt_.
string
requis
ID du compte propriétaire.
string
requis
L’attribution hache la seed UTF-8 + l’ID du sujet avec CRC32 modulo 100 et sélectionne la plage enregistrée (borne de fin exclue).
string | null
Unité de randomisation — user répartit chaque utilisateur indépendamment, account répartit des comptes entiers (tous les utilisateurs d’un compte obtiennent le même bras). null pour les feature flags.Options disponibles : user, account, anonymous
integer
requis
Révision de la configuration de diffusion. S’incrémente à chaque modification de configuration, de sorte qu’une définition en cache avec une révision inférieure est obsolète. Ne modifie pas la seed d’attribution.
object
requis

Propriétés

Propriétés

string
requis
Tag de la ressource référencée, appartenant au propriétaire de l’expérience.
string
requis
Options disponibles : app, app_build, product, plan
string | null
Date de création de l’expérience, sous forme d’horodatage ISO 8601.
string | null
ID de l’utilisateur qui a créé l’expérience, préfixé par user_. null pour les expériences créées avant l’enregistrement des créateurs.
string | null
Date à laquelle l’expérience a cessé de collecter des données, sous forme d’horodatage ISO 8601. null tant qu’elle est en cours.
string | null
Ce qui a été appris et la raison de ce résultat, enregistrés à la fin de l’expérience. null jusque-là.
string
requis
Identifiant choisi par le développeur et référencé dans le code. Partout où l’API accepte un identifiant d’expérience, l’id expt_ et le flag_key sont interchangeables.
string | null
Hypothèse de cette expérience. null lorsqu’aucune n’est définie, et toujours null pour les feature flags.
object
Paires clé-valeur associées lors de la création de l’expérience. Vide lorsqu’aucune n’a été définie.
string
requis
Nom d’affichage lisible.
Ressource appartenant au compte à laquelle cette expérience est liée, comme une app ou un produit. null lorsqu’elle n’est pas liée. Figée dès la première activation de l’expérience.

Propriétés

string
requis
Tag de la ressource référencée, appartenant au propriétaire de l’expérience.
string
requis
Options disponibles : app, app_build, product, plan
string | null
Date à laquelle l’expérience a commencé à collecter des données, sous forme d’horodatage ISO 8601. null pour les brouillons.
string
requis
État du cycle de vie. draft — pas encore en ligne ; active — en cours ; paused — trafic en pause ; ended — terminée.Options disponibles : draft, active, paused, ended
string | null
requis
object[]
requis
Bras de test. Les utilisateurs situés en dehors de l’allocation de tous les bras forment le groupe control implicite. Les pondérations ne font qu’augmenter et les bras ne sont jamais supprimés, de sorte qu’un utilisateur passe du groupe témoin à une variante au plus une fois.

Propriétés

string
requis
Identifiant de la variante. control est réservé — il correspond au reste implicite.
integer[][]
Plages de buckets attribuées (unités de 1 %, borne de fin exclue) qui enregistrent l’historique d’allocation de ce bras. Gérées par le serveur ; les plages sont uniquement ajoutées, ce qui garantit la permanence des attributions.

Propriétés

string
requis
Tag de la ressource référencée, appartenant au propriétaire de l’expérience.
string
requis
Options disponibles : app, app_build, product, plan
integer
requis
Pourcentage de l’ensemble des utilisateurs attribués à cette variante, de 1 à 100. La somme de toutes les pondérations est au maximum de 100 ; le reste constitue le groupe témoin.
string | null
La variante gagnante, définie à la fin de l’expérience. Une fois définie, chaque évaluation renvoie ce bras à chaque appelant, quels que soient le ciblage ou l’allocation, et aucune exposition supplémentaire n’est enregistrée. null signifie que le groupe témoin a gagné — une expérience terminée sans bras gagnant renvoie control pour tout le monde. Toujours null pour les feature flags, qui sont simplement évalués comme désactivés une fois terminés.
Experiment