Contexto

Use as etapas do Context para criar ou atualizar um conjunto de variáveis que representam o contexto de um usuário (ou insights sobre o comportamento desse usuário) à medida que ele se move pelo Canvas. Cada variável de contexto inclui um nome, um tipo de dados e um valor que pode incluir Liquid. Ao definir o contexto como parte da jornada do usuário, é possível fazer coisas como a postergação de mensagens ou filtrar usuários com base em variáveis de contexto.

Como funciona?

Cada etapa do canva é criada com um nome de variável e um tipo de dados associado, ou variáveis de contexto (anteriormente chamadas de propriedades de entrada do canvas). Essas variáveis seguirão o usuário em um Canva e podem ser acessadas usando o Liquid context.

Há duas maneiras de definir variáveis de contexto:

• Na entrada do canva: As variáveis de eventos ou chamadas de API que disparam a entrada de um usuário em um Canva são armazenadas como variáveis de contexto.
• Usando uma etapa de contexto: Você pode criar ou atualizar variáveis de contexto no editor de etapas.

Note que as variáveis incluídas na variável de contexto não são armazenadas automaticamente no perfil do usuário.

Criando uma etapa de contexto

Para criar uma etapa do Context, adicione uma etapa ao seu Canvas. Em seguida, arraste e solte o componente da barra lateral ou selecione o botão de adição na parte inferior de uma etapa e selecione Contexto.

Definição de variáveis de contexto

1. Dê um nome à sua variável Context.
2. Selecione um tipo de dados.
3. Digite uma expressão Liquid ou selecione o botão Adicionar personalização. Isso gera um snippet Liquid para ser usado em sua expressão Liquid.
4. Selecione Prévia para visualizar a variável de contexto.
5. Selecione Concluído para salvar a etapa.

Você pode usar as variáveis de contexto em qualquer lugar onde possa usar o Liquid, como nas etapas de Mensagem e Atualização do usuário, com o botão Adicionar personalização.

Tipos de variáveis de contexto

Podem ser atribuídos tipos às variáveis de contexto do canva que são criadas ou atualizadas na etapa do canva. Observe que, se a expressão Liquid em tempo de execução retornar um valor que não corresponda ao tipo, a variável de contexto não será atualizada.

Por exemplo, se o tipo de dados da variável de contexto for definido como Date, mas o valor não for uma data, a variável não será atualizada. Isso significa que ocorrerá o seguinte:

• O usuário avançará para a próxima etapa ou sairá do Canvas se essa for a última etapa do Canva.
• Em sua análise de dados da etapa do canva, isso será contado como Não atualizado.

O Braze encerrará um usuário na etapa se:

• A variável de contexto não retorna nenhum valor.
• Uma chamada para um Connected Content incorporado falha.
• Os tipos de variáveis de contexto não correspondem.

Tipos JSON e respostas do Connected Content

O Braze avalia as variáveis de contexto que se espera que sejam do tipo JSON (ou Objeto) das respostas do Connected Content em strings. Para evitar que as variáveis de contexto sejam avaliadas como strings, insira esses resultados neste filtro Liquid: as_json_string. Um exemplo é:

1
2
{% connected_content http://example.com :save product %}
{{ product | as_json_string }}

Uso de variáveis de contexto com etapas de postergação

É possível adicionar opções de postergação personalizadas com as informações da etapa Contexto, o que significa que você pode selecionar a variável que posterga os usuários.