Calcule un grupo porcentual estable para desplegar funciones

Esta calculadora transforma un identificador estable de usuario, cuenta, dispositivo o inquilino en uno de 10,000 grupos deterministas y lo compara con el porcentaje indicado. Devuelve el hash sin signo, el grupo porcentual legible y la decisión final de inclusión. Ningún valor aleatorio, reloj, solicitud de red ni asignación almacenada interviene en el resultado, por lo que entradas idénticas siempre producen la misma salida.

Elija un identificador que represente al sujeto del despliegue

Comience con un identificador estable, único en el nivel al que deba asignarse la función y disponible dondequiera que se tome la decisión. Un ID de usuario es apropiado para un experimento de interfaz personal, mientras que un ID de cuenta o inquilino suele ser mejor cuando todos los miembros de una organización deben ver el mismo comportamiento. Los identificadores de dispositivo pueden servir en experiencias anónimas, pero borrar el almacenamiento local podría cambiar la asignación. La calculadora trata el identificador como texto exacto: las mayúsculas, los espacios, la puntuación y los caracteres Unicode intervienen en el hash. Por ello, normalice los identificadores antes de llamar a la capacidad si distintos sistemas pudieran representarlos de manera diferente. Decida, por ejemplo, si los identificadores parecidos a correos se escriben en minúsculas, si los ID numéricos llevan ceros iniciales y si el valor debe incluir un espacio de nombres como producción o pruebas. No use datos de perfil mutables, como el nombre visible. Una vez elegida la convención, consérvela, pues cambiar el identificador también modifica el grupo.

Comprenda el cálculo determinista del grupo

La capacidad codifica el identificador como UTF-8 y aplica el algoritmo hash FNV-1a de 32 bits. El hash sin signo se reduce a uno de 10,000 grupos de puntos básicos, mostrado como un número entre 0 y 99.99. Un sujeto queda incluido cuando su grupo es estrictamente menor que el porcentaje solicitado multiplicado por 100. Esta regla de frontera garantiza extremos útiles: cero por ciento no incluye a nadie y cien por ciento incluye a todos. También admite cambios de 0.01 puntos porcentuales. Como el proceso no emplea semilla aleatoria, tiempo, almacenamiento ni acceso a la red, el mismo identificador y porcentaje siempre devuelven la misma respuesta. Aumentar el porcentaje conserva a todos los sujetos ya incluidos y añade identificadores del siguiente intervalo; reducirlo elimina sujetos del extremo superior. El hash sirve para asignaciones operativas de despliegue, no para seguridad criptográfica. No considere secreto el valor devuelto, no lo use para ocultar identificadores ni dependa de él para decisiones de autorización.

Use el resultado de forma segura en un proceso de lanzamiento

Use el booleano de inclusión como una entrada de la entrega de funciones, junto con reglas explícitas de elegibilidad, comprobaciones del entorno y anulaciones de emergencia. Un servicio típico excluye primero planes o regiones incompatibles y después calcula la asignación porcentual para el público restante. Guarde la configuración del despliegue, no una asignación aleatoria separada para cada usuario, porque el cálculo determinista puede recrear la decisión cuando haga falta. Antes de ampliar la exposición, compare métricas operativas y comerciales entre cohortes aptas y prepare una vía rápida de desactivación global. Si varias funciones independientes usan solo el mismo identificador, el orden de sus grupos estará correlacionado; añada al identificador una clave estable de función, por ejemplo el nombre de la función, un separador y el ID de usuario, cuando cada despliegue necesite un público independiente. Mantenga esa clave durante toda la vida del despliegue. El endpoint rechaza porcentajes menores que cero o mayores que cien en vez de recortarlos silenciosamente, de modo que los errores de configuración sean visibles. Cada llamada cuesta $0.002; la versión del navegador emplea el mismo cálculo puro.