Detalles de entidades

Obtén información sobre las entidades de Experiment Center: indicadores de funciones, variaciones, segmentos, experimentos y asignaciones.

Con la Management API de Auth0, puedes definir los detalles de la entidad de Experiment Center, incluidas las propiedades, los estados del ciclo de vida y las reglas de validación.

Durante la beta, Experiment Center está disponible solo en inquilinos de desarrollo. Los inquilinos de producción no se admiten.

​

Experimento

​

Ciclo de vida del experimento

Los experimentos tienen cinco estados:

Estado	Significado
draft	Creado, pero sin ejecutarse. Se puede probar de forma segura mediante sobrescrituras con parámetros de consulta.
active	En ejecución. La asignación de variantes y la inyección de contexto están activas para todas las transacciones de autenticación.
paused	Suspendido temporalmente. No se realizan nuevas asignaciones. Las sesiones en curso conservan la variación asignada.
completed	Finalizado. No se realizan nuevas asignaciones. La configuración se conserva como referencia durante la promoción manual.
archived	Eliminado de forma lógica. Oculto en las vistas de lista predeterminadas. Se conservan los datos analíticos.

Para cambiar de estado en el ciclo de vida, use el endpoint de la Management API /api/v2/experimentation/experiments/{id}/status.

No se permite la transición de completed → active. Si necesita volver a ejecutar la misma prueba, cree un experimento nuevo.

​

La puerta is_valid

Antes de que un experimento pueda activarse, debe pasar una comprobación para verificar que esté listo.

Experiment Center almacena un valor booleano is_valid en cada experimento y lo recalcula con cada escritura. Esto le proporciona comentarios inmediatos durante la configuración.

También puede determinar explícitamente si está listo mediante el endpoint de Management API /api/v2/experimentation/experiments/{id}/validate.

Esto devuelve is_valid: true/false y una matriz errors con cada bloqueo listado. La misma comprobación se ejecuta automáticamente cuando intenta activar el experimento mediante el endpoint de estado.

Reglas de validación que se comprueban durante la activación:

• El indicador de funcionalidad referenciado está en estado active
• Existe al menos una asignación
• Todos los valores variation_id de las asignaciones pertenecen al indicador de funcionalidad del experimento
• Exactamente una asignación tiene is_control: true
• Las ponderaciones de las asignaciones suman 100 (estrategia de porcentaje)
• Exactamente una asignación tiene is_fallback: true (estrategia de segmento)
• No hay ningún otro experimento activo actualmente para el inquilino (solo Beta)

​

Asignación

Sobrescrituras de parámetros de consulta

Puede forzar una asignación específica en cualquier solicitud a /authorize pasando parámetros de consulta:

Parámetro	Descripción
experiment_id	Inscribirse en un experimento específico
variation_id	Forzar una variación específica (requiere experiment_id)
segment_id	Forzar un segmento específico (requiere experiment_id)

Esto funciona con experimentos en cualquier estado, incluido draft. Úselo durante el desarrollo para verificar que ambas variaciones se rendericen correctamente antes de activarlo.

​

Indicador de funcionalidad

​

Ciclo de vida del indicador de funcionalidad

Los indicadores de funcionalidad tienen un ciclo de vida almacenado con tres estados:

Estado	Significado
draft	Se creó, pero aún no está activo. No puede ser utilizado por un experimento activo.
active	Listo para usarse. Es obligatorio antes de que pueda activarse cualquier experimento que utilice este indicador.
archived	Final. Ningún experimento nuevo puede utilizar este indicador. Cree uno nuevo si es necesario.

Para pasar de un estado a otro, use el endpoint de Auth0 Management API /api/v2/experimentation/feature-flags/{id}/status.

Condición de activación: Un indicador de funcionalidad no puede pasar a active hasta que tenga al menos dos variaciones. Esto garantiza que todo indicador activo tenga, como mínimo, un control y un tratamiento antes de entrar en producción.

draft → active   (requires ≥2 variations)
draft → archived
active → archived (terminal; no way back)

No está permitida la transición de archived → active. Si archiva un indicador de funcionalidad y necesita realizar otra prueba, cree un nuevo indicador de funcionalidad.

​

Variación

Parámetros y sobrescrituras

Los parámetros del indicador de funcionalidad definen el alcance de configuración de tu experimento. Cada parámetro tiene:

• Un nombre (por ejemplo, show_passkey_prompt)
• Un tipo: string, boolean, number, array u object
• Un valor predeterminado (la base de referencia)

El campo overrides de una variación especifica solo los parámetros que cambian. En tiempo de ejecución, Experiment Center combina la base del indicador con las sobrescrituras de la variación y entrega el objeto config completo resultante a ACUL, Actions y las plantillas de página. Todos los parámetros siempre tienen un valor en config; no necesitas implementar lógica alternativa.

Los parámetros usan solo el modo estructurado. Cada parámetro tiene una clave con nombre y un valor tipado.

​

Segmento

​

Reglas del segmento

rules de un segmento es un array de objetos de regla. Una solicitud coincide con el segmento si alguna regla del array coincide.

• match: todas las condiciones deben cumplirse (lógica AND)
• not_match: todas las condiciones deben cumplirse (lógica NOT)

Cada condición compara un atributo con un valor mediante un operador: contains, starts_with, ends_with, exists.

​

Atributos de condición disponibles

Los segmentos solo pueden usar los atributos disponibles al inicio de la transacción de /authorize:

Categoría	Atributos
Cliente	client_id
Conexión	connection, connection_type
Organización	organization_id
Dominio	domain
Dispositivo y navegador	device_type, browser, platform, user_agent
Ubicación geográfica (derivada de la IP)	country, region

​

Más información

Quickstart de Experiment Center

Siga paso a paso la creación de un indicador de funcionalidad, sus variaciones y un experimento de principio a fin.

Integración de ACUL

Lea el contexto del experimento en las pantallas de Auth0 Custom Universal Login (ACUL).