Feature flags

Activar funcionalidad por segmento sin desplegar.

Un feature flag entrega un valor a tu código en lugar de modificar el DOM. Sirve para activar funcionalidad por segmento sin desplegar, y para medir su efecto igual que un experimento A/B.

Crear uno

En Experimentos → Nuevo, elige tipo feature_flag. Cada variante define un featureValue: cadena, número, booleano o null.

Leerlo

const cart = GrowthLab.feature('new-cart');

if (cart === true) {
  renderNewCart();
} else {
  renderLegacyCart();
}

feature devuelve null cuando:

• El flag no existe o no está publicado.
• El visitante no cumple la audiencia.
• El visitante quedó fuera por asignación de tráfico.

Trata null como "usa el comportamiento por defecto". No asumas que null significa false si tus variantes usan cadenas.

Esperar a que el SDK esté listo

feature lee la configuración ya descargada, así que devuelve null si lo llamas antes de que el SDK termine de cargar. Para código que corre temprano:

function whenReady(fn) {
  if (window.__GL_STATE__ && window.__GL_STATE__.ready) return fn();
  setTimeout(function () {
    whenReady(fn);
  }, 50);
}

whenReady(function () {
  if (GrowthLab.feature('new-cart') === true) renderNewCart();
});

Si tu funcionalidad es visible por encima del pliegue, considera un experimento visual en su lugar: el SDK aplica esos cambios con anti-parpadeo antes de que el visitante vea la página, cosa que tu propio código no puede coordinar.

La exposición se registra al leer

Llamar a feature no registra exposición por sí solo. La exposición se registra cuando el SDK resuelve el experimento para el visitante, igual que en un A/B.

Esto significa que un flag publicado cuenta exposiciones incluso si tu código no lo consulta en esa página. Si quieres medir solo dónde realmente se usa, envía un evento propio:

const value = GrowthLab.feature('new-cart');
if (value !== null) GrowthLab.track('new_cart_rendered', { value: String(value) });

Combinar con audiencias

Un flag con audiencia country in [MX] y 10% de tráfico es un despliegue progresivo geográfico. Sube la asignación cuando estés cómodo: los visitantes que ya estaban dentro conservan su valor, porque inclusión y variante usan espacios de hash distintos.

Apagarlo

• Pausar el experimento: feature devuelve null en ≤60 s.
• Kill switch del sitio: apaga todos los experimentos y flags de golpe.

Ninguna de las dos acciones requiere desplegar tu código.