Historial de versiones de Canvas
Canvas utiliza un sistema de versiones al estilo Salesforce: las personas permanecen en la versión en la que empezaron, lo que garantiza una experiencia coherente durante todo su recorrido. Al publicar una nueva versión, solo la usan las nuevas personas que entran en el Canvas; las existentes continúan en su versión original.
Cómo funcionan las versiones
El ciclo de vida de una versión
Borrador (editable) → Publicada (inmutable) → Archivada (solo lectura)
- Borrador: puedes editar libremente el Canvas. Los cambios se guardan automáticamente.
- Publicada: al publicar, se crea una nueva versión. Las versiones publicadas son inmutables.
- Archivada: al publicar una versión nueva, la anterior se archiva. Las versiones archivadas siguen activas para las personas que aún están en el recorrido.
Qué ocurre al publicar
Al hacer clic en Publicar:
- Primero se guarda automáticamente el borrador actual. Los nodos añadidos y las ediciones se conservan antes de tomar la instantánea de publicación. Antes, publicar sin guardar manualmente podía capturar un estado anterior y «perder» nodos añadidos en la versión publicada. Esto ya está corregido: la publicación exige que el guardado se complete correctamente.
- Se crea una instantánea de versión que contiene:
- Todos los nodos y conexiones (la estructura del flujo).
- La configuración del desencadenante de entrada.
- La configuración del Canvas.
- Las versiones de plantilla (fijadas en el momento de publicar).
- La versión publicada anterior queda archivada.
- Las nuevas personas que entren al Canvas usarán la versión nueva.
- Las personas existentes continúan en su versión original hasta que terminan.
Fijación de versiones
Cuando una persona entra en un Canvas, queda fijada a la versión publicada actual:
| Estado de la persona | Qué ocurre al publicar una versión nueva |
|---|---|
| Acaba de entrar | Usa la versión nueva, si entra después de publicar |
| En un nodo de espera | Continúa en su versión original |
| Esperando un evento | Continúa en su versión original |
| Procesando un mensaje | Continúa en su versión original |
Así, las personas nunca encuentran cambios inesperados a mitad del recorrido.
Publicar una nueva versión
Paso 1: realiza los cambios
Edita el Canvas en modo borrador:
- Añade, elimina o modifica nodos.
- Actualiza el contenido de los mensajes.
- Cambia los tiempos de espera.
- Modifica la lógica de ramificación.
Todos los cambios se guardan automáticamente en el borrador.
Paso 2: revisa los cambios
Antes de publicar, revisa lo que ha cambiado:
- Haz clic en el icono Historial de versiones del encabezado del Canvas.
- Selecciona Comparar con la versión publicada.
- Revisa la comparación visual, que muestra:
- Nodos añadidos (verde).
- Nodos eliminados (rojo).
- Nodos modificados (amarillo).
Paso 3: publica
- Haz clic en Publicar en el encabezado del Canvas.
- Añade un Resumen de cambios que describa lo que ha cambiado; es opcional, pero recomendable.
- Confirma la publicación.
Versión 3 publicada el 2024-01-15 a las 14:30
Resumen de cambios: «Se añadió un email de seguimiento a los 3 días y se actualizó el descuento al 20 %»
Publicado por: john@company.com
Panel Historial de versiones
Accede al historial de versiones haciendo clic en el icono de reloj del encabezado del Canvas.
Lista de versiones
Consulta todas las versiones con:
- Número de versión (v1, v2, v3...).
- Fecha y hora de publicación.
- Quién la publicó.
- Resumen de cambios.
- Estado: Publicada o Archivada.
Estadísticas de la versión
Cada versión registra su propia analítica:
| Métrica | Descripción |
|---|---|
| Entradas totales | Personas que entraron en esta versión |
| Usuarios activos | Personas que se encuentran actualmente en el Canvas |
| Completados | Personas que llegaron a la salida |
| Salieron antes | Personas que salieron antes de terminar |
| Fallidos | Personas cuyo recorrido falló por errores |
| Tasa de conversión | Porcentaje que completó el objetivo principal |
| Tiempo medio de finalización | Tiempo medio desde la entrada hasta alcanzar el nodo final |
| Tiempo medio hasta convertir | Tiempo medio desde la entrada hasta el evento de conversión |
Entender las métricas de tiempo
Tiempo medio de finalización mide cuánto tardan las personas en completar todo el recorrido del Canvas, desde la entrada hasta el nodo END. Incluye todas las demoras y tiempos de espera.
Tiempo medio hasta convertir mide cuánto tardan las personas en activar un evento de conversión, por ejemplo, comprar o registrarse. Suele ser menor que el tiempo de finalización porque pueden convertir antes de terminar el recorrido.
Ejemplo:
├── La persona entra en el Canvas el día 0
├── Recibe un email de bienvenida
├── Compra el día 0,5 ← Conversión (tiempo hasta convertir: 12 horas)
├── Continúa por el Canvas
├── Recibe un email de seguimiento el día 3
└── Llega al nodo END el día 3 ← Finalización (tiempo de finalización: 3 días)
- Tiempo de finalización alto + tiempo hasta convertir bajo: las personas convierten rápido, pero el recorrido continúa; es útil para nurturing.
- Tiempos similares: las personas convierten cerca del final del recorrido.
- Sin datos de conversión: aún no se han registrado eventos de conversión.
Comparar versiones
Selecciona dos versiones para compararlas:
- Consulta la diferencia visual de la estructura del flujo.
- Compara las métricas de rendimiento lado a lado.
- Identifica cuál funciona mejor.
Revertir a una versión anterior
Si una versión nueva no funciona bien, puedes revertirla:
- Abre Historial de versiones.
- Busca la versión que quieres restaurar.
- Haz clic en Revertir a esta versión.
- Confirma la reversión.
La reversión crea una nueva versión con el contenido antiguo. No elimina la versión actual. Las personas que están en la versión actual continúan su recorrido.
Ejemplo:
- v1 → Original.
- v2 → Descuento cambiado al 25 %.
- v3 → Reversión a v1; mismo contenido que v1, nuevo número de versión.
Versionado de plantillas
Las plantillas - email, SMS, Push e in-app - también tienen versiones y se fijan al publicar un Canvas.
Cómo funciona
- Editas una plantilla de email.
- Publicas la plantilla, lo que crea una versión de plantilla.
- Al publicar el Canvas, se capturan las versiones actuales de las plantillas.
- Las personas de esa versión del Canvas siempre verán esas versiones de plantilla.
Editar plantillas
Al editar una plantilla que se usa en un Canvas activo:
| Situación | Qué ocurre |
|---|---|
| Editas la plantilla sin publicarla | Solo cambian el borrador; los usuarios activos ven la versión anterior |
| Publicas la plantilla | Se crea una nueva versión de plantilla |
| Publicas el Canvas | La versión nueva del Canvas usa la versión nueva de plantilla |
| Versión anterior del Canvas | Sigue usando la versión anterior de plantilla |
Así se evita que los cambios accidentales afecten a las personas a mitad del recorrido.
Ejecuciones huérfanas
Cuando todas las versiones salvo la actual están archivadas, algunas personas pueden estar en versiones huérfanas:
Huérfana: una persona está en una versión que ya no es la publicada y ha sido archivada.
Qué ocurre con las personas en versiones huérfanas:
- Completan su recorrido en la versión archivada.
- Todos los nodos y la lógica permanecen disponibles.
- Se sigue registrando la analítica de esa versión.
- No se pueden hacer cambios en su versión.
Puedes ver a las personas en versiones huérfanas en la pestaña Ejecuciones de Canvas, identificadas con un indicador de advertencia.
Forzar migración (solo administradores)
En casos poco frecuentes - por ejemplo, para corregir errores urgentes - los administradores pueden forzar la migración de personas a una versión nueva:
- Abre Historial de versiones.
- Haz clic en Opciones de migración.
- Selecciona las personas que quieres migrar, o migra todas las compatibles.
- Confirma la migración.
Compatibilidad de migración
No todas las personas se pueden migrar. El sistema comprueba lo siguiente:
- El nodo existe: el nodo actual de la persona existe en la versión nueva.
- Tipo de nodo sin cambios: el tipo de nodo - espera, mensaje, etc. - es el mismo.
- Ruta válida: existe una ruta válida desde la posición actual.
Resultados de la migración:
- Migrado: se movió correctamente a la versión nueva.
- Incompatible: no se puede migrar; continúa en la versión anterior.
La migración forzada solo debe usarse para correcciones críticas. Un cambio repentino de recorrido puede confundir a las personas.
Analítica por versión
Cada versión conserva su propia analítica:
Métricas específicas de la versión
Analítica de la versión 2 (publicada: 10 de enero)
├── Entradas totales: 15.234
├── Activos: 3.456
├── Completados: 8.123 (67 %)
├── Salidas: 3.655 (24 %)
├── Fallidos: 0
├── Tasa de conversión: 45,2 %
├── Tiempo medio de finalización: 12,4 días
└── Tiempo medio hasta convertir: 2,3 días
Analítica de la versión 3 (publicada: 15 de enero)
├── Entradas totales: 2.341
├── Activos: 1.892
├── Completados: 312 (13 %)
├── Salidas: 137 (6 %)
├── Fallidos: 0
├── Tasa de conversión: 28,1 %
├── Tiempo medio de finalización: 2,1 días (en curso)
└── Tiempo medio hasta convertir: 4,5 horas
Comparar el rendimiento
Usa la analítica por versión para:
- Probar cambios mediante A/B: compara tasas de conversión entre versiones.
- Identificar mejoras: comprueba si un cambio mejoró las tasas de finalización.
- Diagnosticar problemas: descubre si un cambio causó abandonos.
Registro de auditoría
Se registran todas las acciones sobre versiones:
| Acción | Qué se registra |
|---|---|
| Publicar | Quién publicó, cuándo y el resumen de cambios |
| Revertir | Quién revirtió y a qué versión |
| Archivar | Cuándo se archivó la versión |
| Migrar | Quién inició la migración y cuántas personas se vieron afectadas |
Consulta el registro de auditoría en Configuración > Registro de auditoría o en el panel de historial de versiones.
Buenas prácticas
1. Escribe resúmenes de cambios claros
Bien: «Se añadió un email de recordatorio el día 7 y se aumentó el descuento del 15 % al 20 %»
Mal: «Canvas actualizado»
2. Revisa antes de publicar
- Compara con la versión actual.
- Revisa las plantillas afectadas.
- Consulta la analítica de la versión actual.
3. Prueba los cambios importantes
Para cambios importantes:
- Crea un Canvas de prueba.
- Valida el flujo.
- Aplícalo después a producción.
4. Supervisa después de publicar
Después de publicar una versión nueva:
- Comprueba que la tasa de entrada sea normal.
- Supervisa las métricas de finalización temprana.
- Vigila si aumentan las salidas.
5. Usa la reversión con moderación
Revierte cuando:
- Se descubre un error crítico.
- Hay una caída significativa del rendimiento.
- Se publicó contenido incorrecto.
No reviertas por:
- Erratas menores; basta con publicar una corrección.
- Variaciones normales del rendimiento.
Límites de versiones
| Límite | Valor |
|---|---|
| Versiones por Canvas | Ilimitadas |
| Conservación de versiones archivadas | Hasta que finalicen todas las ejecuciones |
| Conservación del registro de auditoría | 1 año |
Opciones de filtrado de segmentos
Al crear segmentos o dirigirte a usuarios, puedes filtrar según la versión del Canvas:
Filtrar por versión de Canvas
In segment builder or canvas analytics:
Filtros de versión de Canvas:
├── En una versión concreta (por ejemplo, v2)
├── En la versión más reciente
├── En una versión archivada (usuarios huérfanos)
├── Entró antes de la versión X
└── Entró después de la versión X
Casos de uso
Dirigirse a usuarios en una versión antigua:
Segmento: «Usuarios en Canvas v1»
Filtro: canvas_version = 1 AND canvas_id = "onboarding-flow"
Uso: notificar cambios próximos u ofrecer reiniciar
Dirigirse a usuarios huérfanos:
Segmento: «Usuarios huérfanos de Canvas»
Filtro: version_status = "orphaned"
Uso: enviar una notificación sobre el estado de su recorrido