Actualizar datos del perfil en Canvas antes del envío

Cuando un recorrido dura días o semanas, los datos del perfil pueden cambiar después de que el usuario ingresó al Canvas. Utiliza un paso de contexto para buscar el objeto correspondiente en el perfil y, a continuación, ramifica la mensajería con rutas de audiencia o división de decisiones.

Acerca de este ejemplo

ClaimsJumpr, una marca de seguros ficticia, inicia un Canvas basado en acciones cuando faltan 28 días para la renovación de una póliza. Durante esos 28 días, ClaimsJumpr envía varios recordatorios. El titular de una póliza puede cambiar la renovación automática de esa póliza después de entrar, por lo que los mensajes que solo usan las propiedades de entrada en Canvas pueden describir un estado incorrecto.

Cada perfil de usuario almacena las pólizas en un atributo personalizado de matriz de objetos (policies). Cada objeto incluye un policy_id único en el evento desencadenante y un valor auto_renewal (opted_in u opted_out). Este ejemplo añade un paso de contexto antes de los pasos de mensaje posteriores para que Liquid lea el objeto actual de policies, haciendo coincidir el policy_id del contexto del Canvas (el evento de entrada).

Este escenario:

1. Mantiene el policy_id de entrada en el contexto del Canvas.
2. Usa un paso de contexto y el filtro where de Liquid para seleccionar el objeto coincidente de policies.
3. Almacena auto_renewal como variable de contexto (auto_renewal) con el tipo Cadena.
4. Dirige el texto con filtros de variables de contexto de rutas de audiencia o de división de decisiones, no con Liquid de cancelación duplicado en este artículo.

Consideraciones

• Prueba el Canvas en un espacio de trabajo que no sea de producción, incluidos perfiles en los que falte auto_renewal en un objeto.
• Los valores de policy_id en policies deben ser únicos para que where devuelva un solo objeto.
• Si otro Canvas usa un paso de Actualización de usuario para escribir policies a partir del mismo evento desencadenante, es posible que el perfil no se actualice antes del primer mensaje. Para el primer paso Mensaje después de la entrada, usa las propiedades del contexto de entrada. Usa este paso Contexto en los pasos posteriores, cuando la actualización del perfil haya tenido tiempo de aplicarse.
• Los nombres de las variables de contexto solo pueden contener letras, números y guiones bajos (hasta 100 caracteres). Puedes definir hasta 10 variables por paso Contexto.
• El código Liquid de este artículo es un ejemplo. Previsualiza las rutas de usuario y haz envíos de prueba con los nombres y valores de tus atributos.

Configuración

Este ejemplo supone lo siguiente:

Paso 1: Coloca un paso de Contexto antes de los mensajes posteriores

En el Canvas, añade un paso de Contexto justo antes de los pasos de Mensaje que deben reflejar el estado actual de renovación automática. No dependas solo de las propiedades de entrada para esos envíos posteriores.

Paso 2: Define la variable de contexto

En el paso de Contexto:

1. Establece Nombre de la variable de contexto en auto_renewal.
2. Establece el tipo de datos en Cadena.
3. Introduce Liquid que seleccione la póliza correspondiente y luego genere auto_renewal. No envuelvas el origen de assign en etiquetas {{ }} adicionales.

1
2

{% assign matched_policies = custom_attribute.${policies} | where: "policy_id", context.${policy_id} %}
{{ matched_policies[0].auto_renewal }}

context.${policy_id} es la propiedad del evento de entrada, disponible como variable de contexto. where conserva los objetos cuyo policy_id coincide con ese valor. El paso de Contexto almacena el campo auto_renewal de la primera coincidencia.

4. Selecciona Vista previa y confirma el valor para un usuario de prueba que tenga ese policy_id en policies.

Para conocer los límites de nombre, tipo y Liquid, consulta Contexto y Variables de contexto.

Paso 3: Crea ramas según la variable de contexto

Después del paso de Contexto, divide a los usuarios con un filtro de Rutas de audiencia o División de decisiones en auto_renewal (por ejemplo, igual a opted_in frente a opted_out). Coloca el recordatorio correspondiente en cada ruta.

Consejo

Para configurar el filtro y hacer coincidir el tipo de datos, consulta Filtros de variables de contexto. Para saber cómo se evalúan los grupos, consulta Rutas de audiencia y División de decisiones.

Si cancelas un envío en un paso de Mensaje en lugar de crear ramas, el usuario igualmente avanza al siguiente paso en Canvas. Para más detalles, consulta Cancelar mensajes y Cómo avanzan los usuarios.

Paso 4: Vista previa y prueba

Usa la vista previa de rutas de usuario y envíos de prueba para:

• auto_renewal con opted_in y opted_out en el objeto correspondiente
• Un policy_id que no esté en policies (valor de contexto vacío o en blanco)
• Un objeto que omita auto_renewal

Confirma que los recordatorios posteriores coincidan con el perfil, no solo con el estado de la entrada en el Canvas.

Artículos relacionados

• Contexto
• Variables de contexto
• Propiedades de entrada en Canvas
• Rutas de audiencia
• División de decisiones
• Paso de mensaje
• Cancelar mensajes
• Matriz de objetos
• Actualización de usuario