> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Detalles de entidades

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

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Acceso anticipado"
  };
  const stageText = stageTextMap[stage] || "una etapa de lanzamiento del producto";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>Esta funcionalidad está disponible en los {linkify(`planes ${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Para participar, ponte en contacto con " + contact + ". "}
            {terms && <>Al usar esta funcionalidad, aceptas los términos aplicables de la prueba gratuita incluidos en el {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} de Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La funcionalidad {feature} está en {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Experiment Center" stage="beta" terms="true" contact="Auth0 Support" />

Con la [Management API](/es/docs/api/management/v2) 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.

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

<div id="experiment">
  ## Experimento
</div>

<div id="experiment-lifecycle">
  ### Ciclo de vida del experimento
</div>

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`](/es/docs/api/management/v2/experimentation/update-experiment-status).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  No se permite la transición de `completed → active`. Si necesita volver a ejecutar la misma prueba, cree un experimento nuevo.
</Callout>

<div id="the-is_valid-gate">
  ### La puerta `is_valid`
</div>

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`](/es/docs/api/management/v2/experimentation/validate-experiment).

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)

<div id="assignment">
  ### Asignación
</div>

**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.

<div id="feature-flag">
  ## Indicador de funcionalidad
</div>

<div id="feature-flag-lifecycle">
  ### Ciclo de vida del indicador de funcionalidad
</div>

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`](/es/docs/api/management/v2/experimentation/update-feature-flag-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.

```text wrap lines theme={null}
draft → active   (requires ≥2 variations)
draft → archived
active → archived (terminal; no way back)
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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.
</Callout>

<div id="variation">
  ### Variación
</div>

**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.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Los parámetros usan **solo el modo estructurado**. Cada parámetro tiene una clave con nombre y un valor tipado.
</Callout>

<div id="segment">
  ## Segmento
</div>

<div id="segment-rules">
  ### Reglas del segmento
</div>

`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`.

<div id="available-condition-attributes">
  ### Atributos de condición disponibles
</div>

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`                                |

<div id="learn-more">
  ## Más información
</div>

<CardGroup cols={2}>
  <Card title="Quickstart de Experiment Center" icon="gear" href="/es/docs/customize/experiment-center/quickstart">
    Siga paso a paso la creación de un indicador de funcionalidad, sus variaciones y un experimento de principio a fin.
  </Card>

  <Card title="Integración de ACUL" icon="puzzle-piece" href="/es/docs/customize/experiment-center/integrations/acul-integration-guide">
    Lea el contexto del experimento en las pantallas de Auth0 Custom Universal Login (ACUL).
  </Card>
</CardGroup>