Experimentos y atribución
Ejecute experimentos deterministas e inmutables y lea la atribución sin mezclar monedas ni modelos.
En esta página
Los experimentos proporcionan una forma compartida de comparar variantes de ventanas emergentes, ramas de divididas en campañas y otro contenido compatible. Una ventana emergente o una división de campaña mantienen el mismo comportamiento de asignación determinista durante la migración; su experimento compartido agrega informes duraderos y un enlace de informe permanente.
Configurar una versión
Un experimento tiene de dos a cinco variantes, exactamente 10 000 puntos básicos de asignación en total y como máximo una variante de control. Un control no puede representar ningún mensaje o ningún contenido. Elija si la asignación es por suscriptor o por viaje:
- La asignación de suscriptor mantiene a la misma persona en la misma variante.
- La asignación de recorrido mantiene un recorrido de campaña en la misma rama, mientras que permite asignar un recorrido posterior de forma independiente.
La asignación es determinista y duradera. Se basa en la versión del experimento y el ID de asignación inmutables, por lo que un reintento de devolución de llamada no mueve a un cliente a otra variante.
Elija la audiencia, el objetivo principal, los objetivos secundarios opcionales, la fuente de valor y la ventana de atribución antes de comenzar. Una versión puede hacer referencia a contenido compatible y objetivos, incluido el valor de una constante, propiedad de evento, pago o acuerdo de CRM cuando esté configurado.
Versiones y ciclo de vida
Un experimento pasa por los estados borrador, en ejecución, pausado, completado, cancelado y archivado. Al iniciar se ejecuta la versión actual e inmutable de . La pausa detiene el ciclo de vida activo sin cambiar su definición de asignación ; Los experimentos completados o cancelados se pueden archivar.
Una vez que una versión está expuesta, cambiar su contenido o asignación crea una nueva versión en lugar de editar la expuesta. Mantenga el selector de versiones en la informe en mente al comparar resultados históricos. La selección del ganador es un manual, acción única y permanece visible después del archivo; no es automatico decisión de importancia.
Hechos y atribución
La escalera del informe contiene asignaciones, exposición, entrega, apertura, clic,
respuesta, conversión, baja y reclamación. Estos hechos utilizan un duradero
ID del evento de origen, por lo que las devoluciones de llamada repetidas son idempotentes. La atribución de ingresos es
registrado por separado de los hechos y utiliza unidades menores de 64 bits firmadas con un
Moneda ISO 4217, por ejemplo 1250 + EUR por 12,50€.
Los ingresos se agrupan por moneda. El producto nunca añade silenciosamente EUR, RSD y USD juntos. Proporcione un proceso de conversión independiente con marca de tiempo antes de realizar cualquier comparación entre divisas.
Elija un modelo de atribución para un informe:
- El primer toque atribuye una conversión apta al primer toque.
- Último toque lo atribuye al último toque elegible.
- Asignación lo atribuye a la tarea del experimento.
El modelo seleccionado y la ventana de atribución de la versión inmutable se muestran en la respuesta y la interfaz de usuario. El informe no combina modelos en un total.
Advertencias y cohortes
Las advertencias son comprobaciones deterministas de la calidad de los datos, no afirmaciones de significación estadística . Cubren un experimento incompleto, una variante con menos de 30 exposiciones , asignaciones sin exposiciones, asignación materialmente desequilibrada después de un volumen de asignación suficiente y de clics o conversiones que excedan exposiciones. Investigue la instrumentación o la entrega antes de elegir un ganador.
Utilice el cajón de cohortes para revisar las tareas por variante. La lista utiliza un cursor e identidad canónica del cliente. El filtrado de segmentos en un informe utiliza el membresía publicada actualmente para el segmento seleccionado.
Compatibilidad con popups y campañas
Las ventanas emergentes multivariantes obtienen un experimento compartido solo después de que se hayan revelado los datos heredados. rellenado. Una variante de ventana emergente mostrada anteriormente gana para el visitante que regresa, por lo que la migración no cambia el contenido a mitad del viaje. Se conservan las estadísticas de la ventana emergente su forma de respuesta existente y recurrir a contadores heredados cuando la paridad es no probado.
Los enlaces divididos de campaña registran un tiempo de transición. Viajes que comenzaron antes de eso. el tiempo permanece en la división determinista original. Un informe compartido está listo solo después de que finalizan esos viajes heredados, por lo que el sistema no inventa asignaciones de sucursales históricas .
Ejemplos de API y MCP
El informe REST necesita un PAT con experiments:read y el bot de análisis
correcto. El rango está limitado por RFC3339 UTC y el JSON no contiene un token
real ni una carga útil del cliente.
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 significa una solicitud de informe no válida. 404 significa que el experimento o la versión solicitada explícitamente por
no está disponible en este bot. 409 se aplica a un conflicto de actualización de
optimista o a un conflicto de selección de ganador, no a una versión de
de informe faltante. Lea una cohorte de asignación con version, variant, limit,
opcionales y el cursor devuelto como parámetros de consulta.
MCP expone herramientas experimentales compartidas de solo lectura con el mismo alcance experiments:read
:
{"name":"get_experiment_report","arguments":{"bot_id":"<bot-id>","experiment_id":"<experiment-id>","version":2}}
list_experiments y get_experiment también están disponibles. MCP no se inicia,
pausa, edita, elige un ganador, crea tareas o escribe datos.