Atualizar dados do perfil no Canvas antes do envio

Quando uma jornada dura dias ou semanas, os dados do perfil podem mudar depois que o usuário entrou no Canvas. Use uma etapa de Contexto para buscar o objeto correspondente no perfil e, em seguida, direcione as mensagens com jornadas do público ou divisão de decisão.

Sobre este exemplo

A ClaimsJumpr, uma marca fictícia de seguros, inicia um Canvas baseado em ação quando faltam 28 dias para a renovação de uma apólice. Durante esses 28 dias, a ClaimsJumpr envia vários lembretes. O titular da apólice pode alterar a renovação automática dessa apólice depois de entrar no Canvas. Por isso, mensagens que usam apenas as propriedades de entrada do Canvas podem descrever o status errado.

Cada perfil de usuário armazena as apólices como um atributo personalizado de array de objetos (policies). Cada objeto inclui um policy_id único no evento-gatilho e um valor auto_renewal (opted_in ou opted_out). Este exemplo adiciona uma etapa de Contexto antes das etapas de Mensagem seguintes. Assim, o Liquid lê o objeto atual de policies, fazendo a correspondência com o policy_id do contexto do Canvas (o evento de entrada).

Este cenário:

1. Mantém o policy_id de entrada no contexto do Canvas.
2. Usa uma etapa de Contexto e o filtro where do Liquid para selecionar o objeto correspondente em policies.
3. Armazena auto_renewal como uma variável de contexto (auto_renewal) do tipo String.
4. Direciona o conteúdo com filtros de variáveis de contexto em Jornadas do público ou Divisão de decisão, e não com Liquid de interrupção duplicado neste artigo.

Considerações

• Teste o Canvas em um espaço de trabalho que não seja de produção, incluindo perfis em que auto_renewal esteja ausente em um objeto.
• Os valores de policy_id em policies devem ser únicos para que where retorne um único objeto.
• Se outro Canvas usar uma etapa de Atualização de Usuário para gravar policies a partir do mesmo evento-gatilho, o perfil pode não estar atualizado antes da primeira mensagem. Para a primeira etapa de mensagem após a entrada, use as propriedades de contexto de entrada. Use esta etapa de contexto nas etapas posteriores, depois que a atualização do perfil tiver tempo de ser aplicada.
• Os nomes das variáveis de contexto usam apenas letras, números e sublinhados (até 100 caracteres). Você pode definir até 10 variáveis por etapa de contexto.
• O Liquid deste artigo é um exemplo. Faça a prévia das jornadas do usuário e envios de teste com os nomes e valores dos seus atributos.

Configuração

Este exemplo pressupõe:

Etapa 1: Coloque uma etapa de Contexto antes das próximas mensagens

No Canvas, adicione uma etapa de Contexto imediatamente antes das etapas de Mensagem que precisam refletir o status atual de renovação automática. Não dependa apenas das propriedades de entrada para esses envios posteriores.

Etapa 2: Defina a variável de contexto

Na etapa de Contexto:

1. Defina Nome da variável de contexto como auto_renewal.
2. Defina o tipo de dado como String.
3. Insira o Liquid que seleciona a apólice correspondente e, em seguida, gera auto_renewal. Não coloque a origem do assign dentro de tags {{ }} extras.

1
2

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

context.${policy_id} é a propriedade do evento de entrada, disponível como variável de contexto. O where mantém os objetos cujo policy_id corresponde a esse valor. A etapa de Contexto armazena o campo auto_renewal da primeira correspondência.

4. Selecione Prévia e confirme o valor para um usuário teste que tenha esse policy_id em policies.

Para limites de nome, tipo e Liquid, consulte Contexto e Variáveis de contexto.

Etapa 3: Crie ramificações com base na variável de contexto

Depois da etapa de Contexto, divida os usuários com um filtro de jornadas do público ou de divisão de decisão em auto_renewal (por exemplo, igual a opted_in versus opted_out). Coloque o lembrete correspondente em cada jornada.

Dica

Para configurar filtros e fazer a correspondência de tipos de dados, consulte Filtros de variáveis de contexto. Para saber como os grupos são avaliados, consulte Jornadas do público e Divisão de decisão.

Se você interromper um envio em uma etapa de Mensagem em vez de criar ramificações, o usuário ainda avança para a próxima etapa do Canvas. Para mais detalhes, consulte Interromper mensagens e Como os usuários avançam.

Etapa 4: Faça a prévia e teste

Use a prévia das jornadas do usuário e envios de teste para:

• auto_renewal com opted_in e opted_out no objeto correspondente
• Um policy_id que não está em policies (valor de contexto vazio ou em branco)
• Um objeto que não tem auto_renewal

Confirme que os lembretes posteriores correspondem ao perfil, e não apenas ao status da entrada no Canvas.

Artigos relacionados

• Contexto
• Variáveis de contexto
• Propriedades de entrada do Canvas
• Jornadas de público
• Divisão de decisão
• Etapa de mensagem
• Interrupção de mensagens
• Array de objetos
• Atualização de usuário