Propriedades de contexto e evento
Este artigo de referência aborda informações sobre
contexteevent_properties, incluindo quando usar cada propriedade e as diferenças de comportamento.
Para informações gerais sobre propriedades de eventos personalizados, confira Propriedades de eventos personalizados.
As propriedades de entrada do Canvas fazem parte das variáveis de contexto do Canvas. Isso significa que canvas_entry_properties é referenciado como context. Cada variável context inclui um nome, tipo de dado e um valor que pode incluir Liquid. Atualmente, canvas_entry_properties são compatíveis com versões anteriores. Para mais detalhes, consulte Contexto e objeto de contexto do Canvas.
As propriedades de contexto e as propriedades de evento funcionam de maneira diferente nos seus fluxos de trabalho do Canvas. As propriedades de eventos ou chamadas de API que disparam a entrada de um usuário em um Canvas são conhecidas como context. As propriedades de eventos que ocorrem enquanto um usuário avança em uma jornada do Canvas são conhecidas como event_properties. A diferença principal é que context vai além dos eventos, acessando também as propriedades das cargas úteis de entrada em Canvas disparados por API.
Consulte a tabela a seguir para um resumo das diferenças entre propriedades de contexto e de evento.
| Propriedades de contexto | Propriedades de evento | |
|---|---|---|
| Liquid | context |
event_properties |
| Persistência | Podem ser referenciadas por todas as etapas de Mensagem durante toda a duração de um Canvas criado usando o Canvas. | - Só podem ser referenciadas uma vez. - Não podem ser referenciadas por etapas de Mensagem subsequentes. |
| Comportamento no Canvas | Podem referenciar context em qualquer etapa de um Canvas. Para o comportamento pós-lançamento, consulte Editando Canvas após o lançamento. |
- Podem referenciar event_properties na primeira etapa de Mensagem após uma etapa de jornadas de ação em que a ação realizada é um evento personalizado ou evento de compra. - Não podem estar após a jornada Restante do público da etapa de jornadas de ação. - Podem ter outros componentes que não sejam de Mensagem entre as etapas de jornadas de ação e Mensagem. Se um desses componentes que não são de Mensagem for uma etapa de jornadas de ação, o usuário pode passar pela jornada Restante do público dessa etapa. |
Detalhes do editor original do Canvas
Não é mais possível criar ou duplicar Canvas usando o editor original. Observe que o contexto do Canvas não é compatível com o editor original do Canvas, então esta seção está disponível como referência ao usar propriedades de entrada do Canvas e propriedades de evento no fluxo de trabalho anterior do Canvas.
Propriedades de entrada do Canvas:
- É necessário ter as propriedades de entrada persistentes ativadas.
- Só podem referenciar
canvas_entry_propertiesna primeira etapa completa de um Canvas. O Canvas deve ser baseado em ação ou disparado por API.
Propriedades de entrada:
- Podem referenciar
event_propertiesem qualquer etapa completa que use entrega baseada em ação em um Canvas. - Não podem ser usadas em etapas completas agendadas, exceto na primeira etapa completa de um Canvas baseado em ação. No entanto, se um usuário estiver usando um componente do Canvas, o comportamento segue as regras atuais do fluxo de trabalho do Canvas para
event_properties.
Propriedades de evento:
- Não é possível usar
event_propertiesna etapa de Mensagem inicial. Em vez disso, você deve usarcanvas_entry_propertiesou adicionar uma etapa de jornadas de ação com o evento correspondente antes da etapa de Mensagem que incluievent_properties.
O que saber
- O contexto está disponível apenas para referência em Liquid. Para filtrar pelas propriedades dentro do Canvas, use a segmentação por propriedade de evento.
- Para canais de mensagem no app, você pode referenciar
contexteevent_propertiesem um Canvas.event_propertiespode ser acessado quando incluído na primeira etapa do Canvas porque é baseado em disparo. - Você não pode usar
event_propertiesna etapa de mensagem principal. Em vez disso, você pode usarcontextou adicionar uma etapa de jornadas de ação com o evento correspondente antes da etapa de mensagem que incluievent_properties. - Quando uma etapa de jornadas de ação contém um disparo “Sent an SMS Inbound Message” ou “Sent a WhatsApp Inbound Message”, as etapas subsequentes do Canvas podem incluir uma propriedade Liquid de SMS ou WhatsApp. Isso reflete como as propriedades de evento funcionam em Canvas. Dessa forma, você pode alavancar suas mensagens para salvar e referenciar dados primários em perfis de usuário e envio de mensagens conversacionais.
A elegibilidade do público é avaliada uma vez na entrada do Canvas. Se um usuário for mesclado durante a entrada, o usuário identificado continua pelo Canvas e não é reavaliado em relação aos critérios de Segment do Canvas.
Você não precisa de uma etapa de Contexto para referenciar propriedades do evento disparador nas etapas Jornadas do público ou Divisão de decisão. Você pode referenciar as propriedades diretamente nos grupos de filtro com o filtro Variável de contexto. Certifique-se de selecionar o tipo de dado correto.
Timestamps
Todos os timestamps no Canvas são normalizados para UTC. Dado esse comportamento, a Braze recomenda fortemente que você use um filtro de fuso horário Liquid, como no exemplo a seguir, para que suas mensagens sejam enviadas no seu fuso horário preferido.
{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}
Caso de uso
Para entender melhor as diferenças entre context e event_properties, vamos considerar este cenário em que os usuários entram em um Canvas baseado em ação ao realizar o evento personalizado “adicionar item à lista de desejos”.
O contexto é configurado na etapa Cronograma de entrada da criação de um Canvas e corresponde ao momento em que um usuário entra em um Canvas. O contexto também pode ser referenciado em qualquer etapa de mensagem.
Neste Canvas, temos uma jornada de usuário que começa com uma etapa de jornadas de ação para determinar se um usuário adicionou um item à sua lista de desejos. A partir daí, se o usuário adicionou um item, ele passa por uma postergação antes de receber a mensagem “Novo item na sua lista de desejos!” da etapa de mensagem.
A primeira etapa de mensagem em uma jornada de usuário tem acesso às event_properties personalizadas da sua etapa de jornadas de ação. Neste caso, podemos incluir {{event_properties.${property_name}}} nessa etapa de mensagem como parte do conteúdo da nossa mensagem. Se um usuário não adicionar um item à lista de desejos, ele segue pela jornada Todos os outros, o que significa que as event_properties não podem ser referenciadas e refletem um erro de configuração inválida.
Observe que você só terá acesso às event_properties se a sua etapa de mensagem puder ser rastreada até uma jornada que não seja Todos os outros em uma etapa de jornadas de ação. Se a etapa de mensagem estiver conectada a uma jornada Todos os outros, mas puder ser rastreada até uma etapa de jornadas de ação na jornada do usuário, você ainda terá acesso às event_properties. Para saber mais sobre esses comportamentos, consulte Etapa de mensagem.