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

# Añadir una nueva regla de despliegue

> Añada y configure reglas de despliegue en el Rollout Planner para controlar la entrega de features con estrategias dirigidas, progresivas o basadas en experimentos.

## ¿Qué son las reglas de despliegue?

El Rollout Planner le ofrece un control granular sobre sus lanzamientos y pruebas. Puede activar o desactivar cualquier feature flag en cualquier momento para usuarios específicos.

Las reglas de despliegue son como sentencias condicionales para sus lanzamientos y experimentos. Puede configurar una secuencia de acciones que se activa bajo ciertas condiciones. Estas reglas se pueden programar, aplicar de forma inmediata, dirigir a grupos concretos, reordenar y personalizar para alinearlas con sus objetivos.

## Añadir una nueva regla

Haga clic en **Add a rule** para abrir el menú de configuración de reglas.

Aquí puede elegir entre reglas de entrega o de prueba, y dar nombre a su regla.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/0.png)
</Frame>

Puede combinar reglas de cualquier tipo para implementar la estrategia de despliegue de su feature. Kameleoon le permite añadir reglas para [Targeted Delivery](./define-targeted-delivery-rules), [Progressive Delivery](./define-progressive-delivery-rules) y [Feature Experiments](../optimizations-and-scheduling/create-feature-experiments).

## ¿Cómo funciona la cola de reglas?

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/1.png)
</Frame>

Una vez añadidas sus reglas de despliegue, es importante comprender cómo evalúa Kameleoon la cola:

* Kameleoon comprobará si su flag está activado o desactivado. Si está desactivado, los visitantes verán la variación predeterminada (que puede elegir en la lista desplegable «*Then, for everyone else in production, serve*»).
* Si el flag está activado, Kameleoon evalúa los experimentos y las reglas de la cola de arriba hacia abajo. Tenga esto en cuenta al planificar su estrategia de despliegue para evitar solapamientos de targeting imprevistos.
* Las nuevas reglas se añaden al final de la cola de forma predeterminada. No obstante, puede reordenar manualmente las reglas haciendo clic y arrastrando su tarjeta a una nueva posición. Reordenar las reglas en la cola también cambiará el orden en que Kameleoon lee y evalúa la regla. Tenga cuidado al desplegar reglas que compartan la misma audiencia.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/2.png)
</Frame>

* Las reglas en pausa simplemente se ignoran en tiempo de ejecución.

### Targeting y bucketing de usuarios

Cuando un usuario se expone a una variación, sigue un proceso de dos pasos: **targeting** y **bucketing**. Targeting significa que el usuario cumple las condiciones especificadas en una regla. Bucketing significa que el usuario ha sido asignado a la variación o variaciones asociadas a esa regla.

Kameleoon gestiona el targeting y el bucketing de forma diferente para las reglas de entrega y de experimento.

Considere estos dos escenarios:

#### Escenario 1: Regla de entrega en la parte superior

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/3.png)
</Frame>

Si un visitante es objetivo en primer lugar de una regla Targeted/Progressive Delivery:

* Recibe la variación seleccionada si se le asigna al bucket.
* Si es objetivo, pero no se le asigna al bucket, el visitante recibirá la variación «Everyone else» y no se evaluará para ninguna otra regla.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/Delivery.jpg)
</Frame>

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/Capture-decran-2023-12-13-a-12.53.57.png)
</Frame>

#### Escenario 2: Regla de experimento en la parte superior

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/4.png)
</Frame>

* Si un visitante es objetivo de una regla de experimento:
  * Recibe la variación seleccionada si se le asigna al bucket.
  * Si es objetivo pero *no* se le asigna al bucket, se comprueba la siguiente regla hasta el final de la cola. Todos los usuarios que no son asignados a un bucket por las reglas de experimento descienden por la cola. Por ello, siempre es una buena práctica mantener los experimentos en la parte superior de su cola.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/Experiment.jpg)
</Frame>

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/Capture-decran-2023-12-13-a-12.53.34.png)
</Frame>

<Note>
  Cambiar la división del tráfico de un experimento no cambia el tamaño total de su bucket de experimento. Por ejemplo, supongamos que lanza un experimento dirigido al **20 %** de un segmento de usuarios con una división de variación 50/50 para sus dos variaciones. Si actualiza la división a 60/40 o 90/10, pero no cambia el porcentaje de tráfico que se incluirá en la muestra del experimento (**20 %**), el total de usuarios asignados a buckets no aumentará ni disminuirá. En su lugar, algunos usuarios asignados quedarán expuestos a una variación distinta.
</Note>

Cuando no quedan más reglas en la cola, todos los usuarios restantes recibirán la variación «Everyone else».

### Estados de las reglas

Todas las reglas de la cola mostrarán uno de estos estados:

* **Active** (actualmente activa)
* **Paused**
* **Planned** (programada para iniciarse o detenerse en una fecha/hora determinadas). Una regla planificada cambia a *active* en el horario definido o a *outdated* al finalizar el mismo.
* **Unsaved changes** (esto también incluye las nuevas reglas que están en estado de borrador)
* **Outdated** (una regla planificada que se desactivó automáticamente en la fecha de finalización programada). Las reglas obsoletas no se muestran en la vista predeterminada, pero puede utilizar los filtros para verlas.

## Pausar o reanudar una regla

Para pausar una regla, haga clic en el menú de tres puntos de la tarjeta de un experimento y haga clic en **Pause**.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/Capture-decran-2023-04-13-a-15.05.37.png)
</Frame>

Las reglas en pausa se ignoran en tiempo de ejecución. Puede reanudar la regla más tarde en el mismo menú.

## Copiar reglas de otro entorno

También puede añadir reglas que haya creado en otro entorno. Copiar reglas le permite replicar la configuración de despliegue/experimento desde, por ejemplo, su entorno de **staging** a su entorno de **production**.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/image-34.png)
</Frame>

Seleccione **Copy** al añadir reglas en su entorno de destino y seleccione el entorno de origen en el paso siguiente.

Tendrá la opción de añadir las reglas copiadas al final de su cola de reglas, o de sustituir todas las reglas existentes por las reglas copiadas.

## Resumen del despliegue

Esta sección ofrece una visión general de las **variaciones** y los **segmentos**.

Cambiar el orden de las tarjetas, eliminar una regla o cambiar el estado de una regla afectará al orden y a los valores de las tarjetas de resumen.

Aunque la sección de resumen tiene en cuenta a los usuarios no segmentados (restantes) que pueden pasar a la siguiente regla, los solapamientos parciales o completos entre distintos segmentos de usuarios en diferentes reglas no se tendrán en cuenta ni se identificarán.

### Resumen de variaciones

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/5.png)
</Frame>

Esta sección proporciona una visión general de qué variaciones se han utilizado en sus reglas de entrega y experimento.

Las variaciones que se dirigen a varios segmentos tienen varias barras que muestran el porcentaje de audiencia al que ha apuntado.

### Resumen de segmentos

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/experimentation/feature-experimentation/using-the-rollout-planner/add-a-new-rollout-rule/6.png)
</Frame>

Esta sección resume los distintos segmentos de usuarios a los que se dirigen sus reglas de despliegue.

Las variaciones asignadas a un segmento se combinarán para alcanzar un máximo del 100 %. Si se supera este límite, las variaciones restantes se ignorarán.

## Usar el Rollout Planner con SDK obsoletos

Si la versión de su SDK no admite [Feature Variations](../../../../../developer-docs/feature-experimentation/get-started/overview#plataformas-compatibles), deberá tener en cuenta algunos aspectos al añadir nuevas reglas para un feature flag:

* Kameleoon solo comprobará las reglas definidas en el entorno de Production. Las reglas creadas en los entornos de staging o development se ignorarán.
* Kameleoon solo evaluará la primera regla de la cola. Si hay reglas por debajo, se ignorarán. Si no hay ninguna regla, se servirá la variación predeterminada definida en su despliegue.
* Solo se admiten las variaciones predeterminadas **On** y **Off**.
* No se admite la programación de inicio/parada de reglas.

Visite el [Github](https://github.com/Kameleoon) de Kameleoon y suscríbase a las notificaciones para mantenerse al día con todas las versiones del SDK.
