Propriedades de entrada da tela e propriedades de evento
Este artigo de referência aborda informações sobre
canvas_entry_propertieseevent_properties, incluindo quando usar cada propriedade e as diferenças de comportamento.
Para saber mais sobre propriedades de eventos personalizados em geral, consulte Propriedades de eventos personalizados.
Se você está participando do acesso antecipado do componente Context, as propriedades de entrada do Canvas fazem parte das variáveis de contexto do Canvas. Isso significa que canvas_entry_properties agora é referenciado como context. Cada variável context inclui um nome, tipo de dado e um valor que pode incluir Liquid.
As propriedades de entrada do Canva e as propriedades de evento funcionam de forma diferente em seus fluxos de trabalho do Canva. As propriedades de eventos ou chamadas de API que disparam a entrada de um usuário em um Canva são conhecidas como canvas_entry_properties. As propriedades dos eventos que ocorrem à medida que um usuário percorre uma jornada do Canva são conhecidas como event_properties. A principal diferença é que canvas_entry_properties foca em mais do que apenas eventos, acessando também as propriedades das cargas úteis de entrada em Canvases acionados por API.
Consulte a tabela a seguir para um resumo das diferenças entre as propriedades de entrada do Canvas e as propriedades de evento.
| Propriedades de entrada do canva | Propriedades do evento | |
|---|---|---|
| Liquid | canvas_entry_properties |
event_properties |
| Persistência | Pode ser referenciado por todas as etapas de mensagens durante a duração de um Canvas criado usando o Canvas Flow. | - Só pode ser referenciado uma vez. - Não pode ser referenciado por nenhuma etapa de Mensagem subsequente. |
| Comportamento da tela original | - As propriedades de entrada persistente devem estar ativadas. - Só pode fazer referência a canvas_entry_properties na primeira etapa completa de um Canva. O Canva deve ser baseado em ação ou disparado por API. |
- Pode fazer referência a event_properties em qualquer etapa completa que use a entrega baseada em ação em um Canva. - Não pode ser usado em etapas completas programadas que não sejam a primeira etapa completa de um Canva baseado em ação. No entanto, se um usuário estiver usando um componente de canvas, o comportamento seguirá as regras do Canvas Flow para event_properties. |
| Comportamento do Canvas Flow | Pode fazer referência a canvas_entry_properties em qualquer etapa de um Canva. Para o comportamento pós-lançamento, consulte Editando Canvas após o lançamento. |
- Pode fazer referência a 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 um evento de compra. - Não pode estar após a jornada Restante do público da etapa Jornadas de ação. - Pode ter outros componentes do canva que não sejam de mensagem entre as jornadas de ação e as etapas de mensagem. Se um desses componentes que não são de mensagens for uma etapa de jornadas de ação, o usuário poderá passar pela jornada Everyone Else desse caminho de ação. |
Detalhes do editor de Canvas original
Desde 28 de fevereiro de 2023, não é mais possível criar ou duplicar canvas usando o editor original. Este artigo está disponível para referência ao usar canvas_entry_properties e event_properties para o fluxo de trabalho original do canva.
No editor de canvas original e no Canvas Flow, não é possível usar event_properties na etapa do canva. Em vez disso, você deve usar canvas_entry_properties ou adicionar uma etapa de jornadas de ação com o evento correspondente antes da etapa de Mensagem que inclui event_properties.
Coisas para saber
- As propriedades de entrada do Canvas estão disponíveis apenas para referência em Liquid. Para filtrar as propriedades dentro do canva, use a segmentação de propriedades de eventos.
- Para canais de mensagem no app,
canvas_entry_propertiessó pode ser referenciado em um Canvas.event_propertiesnão pode ser usado para canais de mensagem no app. - Não é possível usar
event_propertiesna etapa de envio de mensagens. 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. - Quando uma etapa do caminho da ação contém um disparador “Enviou uma mensagem de entrada SMS” ou “Enviou uma mensagem de entrada WhatsApp”, as etapas subsequentes do Canva podem incluir uma propriedade Liquid do SMS ou do WhatsApp. Isso reflete como as propriedades de evento funcionam em Canvases. Dessa forma, você pode aproveitar suas mensagens para salvar e fazer referência a dados primários sobre perfis de usuários e envio de mensagens de conversação.
Carimbos de data/hora para propriedades de evento
Se você estiver usando event_properties em um Canvas, os carimbos de data/hora são normalizados para UTC, com algumas exceções detalhadas abaixo. Dado esse comportamento, a Braze recomenda fortemente que você use um filtro de fuso horário Liquid como o exemplo a seguir para garantir que suas mensagens sejam enviadas com seu fuso horário preferido.
1
{{canvas_entry_properties.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }
Exceções
- Os carimbos de data/hora não são normalizados para UTC no primeiro passo de um Canvas se esse passo for um passo de Mensagem.
- Os carimbos de data/hora não são normalizados para UTC em qualquer passo de Mensagem usando o canal de mensagem no app, independentemente da sua ordem no Canvas.
Caso de uso
Para entender melhor as diferenças entre canvas_entry_properties e event_properties, vamos considerar este cenário em que os usuários entrarão em um Canva baseado em ação se executarem o evento personalizado “adicionar item à lista de desejos”.
O canvas_entry_properties é configurado na etapa Entry Schedule (Programação de entrada) da criação de um Canva e corresponderá a quando um usuário entrar no Canvas. Esses canvas_entry_properties também podem ser referenciados em qualquer etapa de mensagens no Canvas Flow, pois o Canvas Flow oferece suporte a propriedades de entrada persistentes.
Nesta tela, temos uma jornada de usuário que começa com uma etapa das jornadas de ação para determinar se um usuário adicionou um item à sua lista de desejos. A partir daqui, se o usuário tiver adicionado um item, ele sofrerá uma postergação antes de receber a mensagem “New item in your wishlist!” (Novo item na sua lista de desejos!) da etapa Message (Mensagem).
A primeira etapa da mensagem em uma jornada do usuário terá acesso ao event_properties personalizado da etapa Jornadas de ação. Nesse caso, podemos incluir {{event_properties.${property_name}}} nessa etapa de Mensagem como parte do conteúdo da mensagem. Se um usuário não adicionar um item à sua lista de desejos, ele acessará a jornada Restante do público, o que significa que o event_properties não pode ser referenciado e refletirá um erro de configurações inválidas.
Observe que você só terá acesso a event_properties se a etapa de mensagem puder ser rastreada até uma jornada que não seja “Restante do público” em uma etapa de jornada de ação. Se a etapa da mensagem estiver conectada a uma jornada Restante do público, mas puder ser rastreada até uma etapa das jornadas de ação na jornada do usuário, você também terá acesso a event_properties. Para saber mais sobre esses comportamentos, consulte Etapa da mensagem.
Editar esta página no GitHub