Experimentos y atribución
Compara variantes de un mensaje o campaña, mantén la variante de cada cliente y consulta los resultados y los ingresos.
En esta página
Un experimento te ayuda a comparar opciones, por ejemplo dos textos en una ventana emergente o dos recorridos de una campaña. Indicas qué parte de la audiencia verá cada variante y eliges un objetivo, como una compra. El informe muestra el resultado de cada opción.
La variante queda asociada a la persona o a una ejecución concreta de la campaña. Si se repite el mismo evento, la persona no cambia de variante. Esta asignación estable se llama distribución determinista.
Configurar una versión
Crea entre dos y cinco variantes y reparte el 100 % de la audiencia entre ellas. En la API, las proporciones se expresan en puntos básicos: 100 puntos equivalen al 1 % y la suma debe ser 10 000. Puedes incluir un grupo de control al que, por ejemplo, no se muestre ningún mensaje. Elige cómo conservar la variante:
- Por usuario: una persona permanece en la misma variante.
- Por recorrido: cada ejecución de una campaña conserva su rama, pero otra ejecución para la misma persona puede recibir otra variante.
La asignación se guarda junto a la versión y el ID del experimento. Por eso, repetir el evento de un botón (callback) no cambia la variante del participante.
Antes de iniciar, define la audiencia, el objetivo principal y, si quieres, objetivos adicionales. Elige de dónde saldrá el importe para el informe y la ventana de atribución, el tiempo después de una interacción durante el cual se cuenta un resultado. Según la configuración, el importe puede ser fijo o venir de un evento, un pago o una venta en el CRM. La versión del experimento puede enlazarse con contenido compatible.
Versiones y estados
Un experimento puede estar en borrador, en marcha, pausado, terminado, cancelado o archivado. Al iniciarlo se usa una versión de ajustes que ya no se modifica; pausarlo no cambia las variantes asignadas. Un experimento terminado o cancelado puede archivarse.
Después de que alguien vea una variante, hecho llamado exposure, cambiar el texto o la distribución crea una versión nueva. La anterior sigue en el informe. Elige el número de versión correcto al comparar resultados. Puedes marcar un ganador manualmente una vez y esa elección sigue visible después de archivar. Marcarlo no demuestra por sí solo que la diferencia entre variantes sea estadísticamente fiable.
Eventos y atribución
El informe muestra asignaciones, visualizaciones (exposure), entregas, aperturas, clics, respuestas, objetivos alcanzados (conversiones), bajas y quejas. Si el mismo evento se entrega otra vez, no se suma dos veces: cada hecho conserva el ID del evento original.
Los ingresos se guardan por moneda en su unidad menor. Por ejemplo, 1250 con EUR significa 12,50 €. Para integraciones, el importe es un entero con signo de 64 bits y la moneda usa un código ISO 4217. Los ingresos de EUR, RSD y USD se muestran por separado, sin sumarse. Para comparar monedas distintas hace falta convertirlas con una tasa correspondiente a una fecha concreta.
Elige un modelo de atribución para el informe:
- Primer contacto: atribuye la conversión válida al primer contacto.
- Último contacto: la atribuye al último contacto válido.
- Asignación del experimento: la atribuye a la variante asignada.
La interfaz y la respuesta indican el modelo y la ventana de atribución de la versión elegida. No se mezclan modelos en una misma cifra total.
Advertencias y grupos de participantes
Las advertencias señalan posibles problemas con los datos: el experimento aún sigue, una variante tiene menos de 30 visualizaciones, alguien recibió una variante pero no se registró que la viera, la distribución real difiere mucho de la prevista o hay más clics o conversiones que visualizaciones. Comprueba la entrega y el registro de eventos antes de elegir un ganador. Estas advertencias no miden si una diferencia es estadísticamente significativa.
Una cohorte es el grupo de personas que recibió una variante. Puedes recorrerla por páginas; la API usa un cursor para pedir la siguiente. Si filtras el informe por segmento, se usa la composición actual publicada de ese segmento, no la que tenía en la fecha del experimento.
Compatibilidad con ventanas emergentes y campañas
Al trasladar experimentos de ventanas emergentes desde el sistema anterior, primero se migran los eventos antiguos. Quien vuelve a visitar el sitio conserva la variante que ya vio, para que la oferta no cambie a mitad de su recorrido. Las estadísticas de la ventana mantienen el formato anterior y usan los contadores antiguos mientras no se confirme que los nuevos coinciden.
Para repartir una campaña en ramas (split), se guarda el momento del cambio al nuevo sistema (cutover). Los recorridos iniciados antes mantienen la distribución anterior. El informe conjunto estará disponible cuando terminen; no se pueden reconstruir con seguridad las asignaciones antiguas que faltan.
Ejemplos de API y MCP
Para consultar el informe REST necesitas un token personal (PAT) con experiments:read y permiso de Analítica sobre el bot. Usa fechas RFC3339 en UTC y un periodo limitado. Este ejemplo contiene marcadores de posición, no un token ni datos reales de clientes.
curl -X POST "$BASE_URL/api/bots/$BOT_ID/experiments/$EXPERIMENT_ID/report" \
-H "Authorization: Bearer $PAT" \
-H "Content-Type: application/json" \
-d '{
"version": 2,
"attribution_model": "assignment",
"from": "2026-07-01T00:00:00Z",
"to": "2026-08-01T00:00:00Z",
"segment_id": "00000000-0000-4000-8000-000000000000"
}'
400 indica una solicitud incorrecta. 404 indica que el experimento o la versión solicitada no están disponibles en este bot. 409 corresponde a un conflicto al guardar cambios o elegir un ganador, no a una versión ausente del informe. Para leer la cohorte, indica version, opcionalmente variant, limit y el cursor de la página anterior.
MCP solo ofrece herramientas de lectura con el mismo permiso experiments:read:
{"name":"get_experiment_report","arguments":{"bot_id":"<bot-id>","experiment_id":"<experiment-id>","version":2}}
También están disponibles list_experiments y get_experiment. MCP no inicia, pausa ni modifica experimentos; tampoco elige ganador ni registra asignaciones o eventos.