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

ClaimsJumpr, uma marca fictícia de seguros, inicia um Canvas baseado em ação quando uma apólice está a 28 dias da renovação. Ao longo desses 28 dias, a ClaimsJumpr envia vários lembretes. O segurado pode alterar a renovação automática dessa apólice após entrar, então mensagens que usam apenas as propriedades de entrada do Canvas podem descrever o status incorreto.

Cada perfil de usuário armazena apólices como um atributo personalizado de array de objetos (policies). Cada objeto inclui um policy_id exclusivo 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 posteriores, para que o Liquid leia o objeto atual de policies, fazendo a correspondência pelo policy_id do contexto do Canvas (o evento de entrada).

Este padrão:

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) com o tipo String.
4. Direciona o conteúdo com jornadas do público ou filtros de variáveis de contexto de divisão de decisão — sem Liquid de interrupção duplicado neste artigo.

Considerações

• Teste o Canvas em um espaço de trabalho de não produção, incluindo perfis em que auto_renewal está ausente em um objeto.
• Os valores de policy_id em policies devem ser exclusivos para que o where retorne apenas um 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 para etapas posteriores, depois que a atualização do perfil tiver tido tempo de ser aplicada.
• Os nomes das variáveis de contexto usam apenas letras, números e underscores (até 100 caracteres). Você pode definir até 10 variáveis por etapa de Contexto.
• O Liquid neste artigo é um exemplo. Visualize as jornadas de usuário e faça envios de teste para os nomes e valores dos seus atributos.

Configuração

Este exemplo assume:

Etapa 1: Posicione uma etapa de Contexto antes das mensagens posteriores

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 o Nome da variável de contexto como auto_renewal.
2. Defina o tipo de dados como String.
3. Insira o Liquid que seleciona a apólice correspondente e, em seguida, retorna auto_renewal. Não envolva a origem do assign em 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: Ramifique com base na variável de contexto

Após a etapa de Contexto, divida os usuários com um filtro de jornadas do público ou 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 configuração de filtros e 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 ramificar, 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: Visualize e teste

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

• auto_renewal como opted_in e opted_out no objeto correspondente
• Um policy_id que não existe em policies (valor de contexto vazio ou em branco)
• Um objeto que não contém 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 do público
• Divisão de decisão
• Etapa de mensagem
• Interromper mensagens
• Array de objetos
• Atualização de Usuário