Skip to main content
Treatments krijgen stabiele percentagebereiken van het verkeer en alle anderen krijgen control, zodat het vergroten van een allocatie nooit een bestaande gebruiker naar een andere arm verplaatst. Gebruik de Experiments API om een concept aan te maken, de gewichten, targeting en resourcekoppelingen te configureren, het daarna te activeren, pauzeren of beëindigen, en om te evalueren welke arm een gebruiker, account of anonieme bezoeker krijgt. Voor het beheren van experimenten is experiment:read of experiment:manage vereist; evaluatie werkt zonder authenticatie.

Endpoints

Attributen

string
vereist
Unieke identificatie van het experiment, met prefix expt_.
string
vereist
ID van het eigenaarsaccount.
string
vereist
Toewijzing hasht de UTF-8-seed + subject-ID met CRC32 modulo 100 en selecteert het opgeslagen bereik (eindwaarde exclusief).
string | null
Randomisatie-eenheid — user verdeelt elke gebruiker afzonderlijk in buckets, account verdeelt hele accounts in buckets (elke gebruiker van een account krijgt dezelfde arm). null voor feature flags.Beschikbare opties: user, account, anonymous
integer
vereist
Revisie van de actieve configuratie. Wordt bij elke configuratiewijziging verhoogd, dus een gecachte definitie met een lagere revisie is verouderd. Wijzigt de assignment seed niet.
object
vereist

Eigenschappen

Eigenschappen

string
vereist
Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het experiment.
string
vereist
Beschikbare opties: app, app_build, product, plan
string | null
Wanneer het experiment is aangemaakt, als ISO 8601-tijdstempel.
string | null
ID van de gebruiker die het experiment heeft aangemaakt, met prefix user_. null voor experimenten die zijn aangemaakt voordat makers werden vastgelegd.
string | null
Wanneer het experiment is gestopt met het verzamelen van gegevens, als ISO 8601-tijdstempel. null zolang het nog loopt.
string | null
Wat er is geleerd en waarom deze uitkomst, vastgelegd toen het experiment werd beëindigd. Tot dan null.
string
vereist
Door de ontwikkelaar gekozen handle waarnaar vanuit code wordt verwezen. Overal waar de API een experiment-identificatie accepteert, zijn het expt_-id en de flag_key uitwisselbaar.
string | null
Hypothese voor dit experiment. null wanneer er geen is ingesteld, en altijd null voor feature flags.
object
Key-value-paren die bij het aanmaken van het experiment zijn toegevoegd. Leeg wanneer er geen zijn ingesteld.
string
vereist
Leesbare weergavenaam.
Resource van het account waaraan dit experiment is gekoppeld, zoals een app of product. null wanneer niet gekoppeld. Ligt vast zodra het experiment voor het eerst wordt geactiveerd.

Eigenschappen

string
vereist
Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het experiment.
string
vereist
Beschikbare opties: app, app_build, product, plan
string | null
Wanneer het experiment is begonnen met het verzamelen van gegevens, als ISO 8601-tijdstempel. null voor concepten.
string
vereist
Levenscyclusstatus. draft — nog niet live; active — loopt momenteel; paused — verkeer gepauzeerd; ended — afgerond.Beschikbare opties: draft, active, paused, ended
string | null
vereist
object[]
vereist
Treatment-armen. Gebruikers buiten de allocatie van elke arm vormen de impliciete control-groep. Gewichten worden alleen ooit groter en armen worden nooit verwijderd, dus een gebruiker verhuist hooguit één keer van control naar een treatment.

Eigenschappen

string
vereist
Treatment-identificatie. control is gereserveerd — dat is de impliciete rest.
integer[][]
Toegekende bucketbereiken (eenheden van 1%, eindwaarde exclusief) die de allocatiegeschiedenis van deze arm vastleggen. Beheerd door de server; bereiken worden alleen toegevoegd, wat toewijzingen permanent houdt.

Eigenschappen

string
vereist
Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het experiment.
string
vereist
Beschikbare opties: app, app_build, product, plan
integer
vereist
Percentage van alle gebruikers dat aan deze treatment wordt toegewezen, 1–100. Alle gewichten samen tellen op tot maximaal 100; de rest is control.
string | null
De treatment die heeft gewonnen, ingesteld toen het experiment werd beëindigd. Eenmaal ingesteld retourneert elke evaluatie deze arm aan elke aanroeper, ongeacht targeting of allocatie, en worden er geen verdere exposures vastgelegd. null betekent dat control heeft gewonnen — een beëindigd experiment zonder winnende arm evalueert voor iedereen naar control. Altijd null voor feature flags, die na beëindiging simpelweg als uitgeschakeld evalueren.
Experiment