Skip to main content
Los tratamientos toman rangos porcentuales estables del tráfico y todos los demás reciben el control, por lo que aumentar una asignación nunca mueve a un usuario existente a otro grupo. Usa la API de Experiments para crear un borrador, configurar sus pesos, segmentación y vinculaciones de recursos, y luego activarlo, pausarlo o finalizarlo, así como para evaluar qué grupo recibe un usuario, una cuenta o un visitante anónimo. Gestionar experimentos requiere experiment:read o experiment:manage; la evaluación funciona sin autenticación.

Endpoints

Atributos

string
requerido
Identificador único del experimento, con el prefijo expt_.
string
requerido
ID de la cuenta propietaria.
string
requerido
La asignación aplica un hash a la semilla UTF-8 + el ID del sujeto con CRC32 módulo 100 y selecciona el rango almacenado con extremo final exclusivo.
string | null
Unidad de aleatorización: user asigna cada usuario de forma independiente, account asigna cuentas completas (todos los usuarios de una cuenta reciben el mismo grupo). null para feature flags.Opciones disponibles: user, account, anonymous
integer
requerido
Revisión de la configuración de servicio. Se incrementa con cada cambio de configuración, por lo que una definición en caché con una revisión inferior está obsoleta. No cambia la semilla de asignación.
object
requerido

Propiedades

Propiedades

string
requerido
Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
string
requerido
Opciones disponibles: app, app_build, product, plan
string | null
Cuándo se creó el experimento, como marca de tiempo ISO 8601.
string | null
ID del usuario que creó el experimento, con el prefijo user_. null para experimentos creados antes de que se registraran los creadores.
string | null
Cuándo dejó el experimento de recopilar datos, como marca de tiempo ISO 8601. null mientras sigue en ejecución.
string | null
Qué se aprendió y por qué este resultado, registrado cuando se finalizó el experimento. null hasta entonces.
string
requerido
Identificador elegido por el desarrollador y referenciado desde el código. En cualquier lugar donde la API acepta un identificador de experimento, el ID expt_ y el flag_key son intercambiables.
string | null
Hipótesis de este experimento. null cuando no se ha establecido ninguna, y siempre null para feature flags.
object
Pares clave-valor adjuntados cuando se creó el experimento. Vacío cuando no se estableció ninguno.
string
requerido
Nombre para mostrar legible.
Recurso propiedad de la cuenta al que está vinculado este experimento, como una app o un producto. null cuando no está vinculado. Queda fijado una vez que el experimento se activa por primera vez.

Propiedades

string
requerido
Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
string
requerido
Opciones disponibles: app, app_build, product, plan
string | null
Cuándo comenzó el experimento a recopilar datos, como marca de tiempo ISO 8601. null para borradores.
string
requerido
Estado del ciclo de vida. draft: aún no está activo; active: en ejecución; paused: tráfico en pausa; ended: concluido.Opciones disponibles: draft, active, paused, ended
string | null
requerido
object[]
requerido
Grupos de tratamiento. Los usuarios fuera de la asignación de todos los grupos forman el grupo control implícito. Los pesos solo crecen y los grupos nunca se eliminan, por lo que un usuario pasa del control a un tratamiento como máximo una vez.

Propiedades

string
requerido
Identificador del tratamiento. control está reservado: es el resto implícito.
integer[][]
Rangos de buckets concedidos (unidades del 1 %, con extremo final exclusivo) que registran el historial de asignación de este grupo. Gestionados por el servidor; los rangos solo se añaden, lo que mantiene las asignaciones permanentes.

Propiedades

string
requerido
Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
string
requerido
Opciones disponibles: app, app_build, product, plan
integer
requerido
Porcentaje de todos los usuarios asignados a este tratamiento, de 1 a 100. Todos los pesos juntos suman como máximo 100; el resto es el control.
string | null
El tratamiento ganador, establecido cuando se finalizó el experimento. Una vez establecido, toda evaluación devuelve este grupo a cualquier llamador, independientemente de la segmentación o la asignación, y no se registran más exposiciones. null significa que ganó el control: un experimento finalizado sin grupo ganador se evalúa como control para todos. Siempre null para feature flags, que simplemente se evalúan como deshabilitados una vez finalizados.
Experiment