Mensagem
As etapas de Mensagem permitem adicionar uma mensagem independente onde você quiser no seu Canvas.

Criar uma mensagem
Para criar um componente de mensagem, primeiro adicione uma etapa ao seu Canvas. Arraste e solte o componente da barra lateral ou selecione o botão de adição na parte inferior de uma etapa e selecione Mensagem.
Etapa 1: Selecione seu canal de envio de mensagens
Você pode selecionar entre os seguintes canais de envio de mensagens:
- Banners
- Content Cards
- LINE
- Notificações por push
- SMS/MMS/RCS
- In-App Messages
- Webhook

Etapa 2: Editar configurações de entrega
Em seguida, você pode editar as configurações de Intelligent Delivery, substituições de horário de silêncio e validação de entrega.
Intelligent Timing
Você pode ativar o Intelligent Timing com uma opção de fallback quando o perfil de um usuário não tem dados suficientes para calcular um horário ideal. Recomendamos ativar o Intelligent Timing e o limite de frequência como uma verificação adicional para quaisquer atrasos entre os usuários entrarem na etapa de mensagem e o envio real da mensagem.
Selecione Usar Intelligent Timing na guia Configurações de entrega. Aqui, você pode selecionar o horário mais popular ou um horário de fallback específico. Se o horário de silêncio estiver ativado, a etapa de mensagem também permite substituir essa configuração.

Validações de entrega
As validações de entrega fornecem uma verificação adicional no envio da mensagem para confirmar que seu público ainda atende aos seus critérios. Recomendamos usá-las quando o horário de silêncio, o Intelligent Timing ou o limite de frequência estiverem ativados. Selecione Validar público no envio da mensagem e adicione um Segment ou filtros adicionais. Se um usuário não atender às validações, escolha se ele sai do Canvas ou avança para a próxima etapa.
As validações de entrega avaliam os critérios do perfil de usuário no momento do envio. Filtros relacionados a apps verificam se um usuário usou recentemente ou já usou um app específico, mas não restringem quais tokens de app do usuário recebem a mensagem.
Se seu espaço de trabalho tiver vários apps e uma etapa de mensagem precisar direcionar um app específico, use uma das seguintes abordagens:
- Adicione um Segment que tenha Apps e websites direcionados configurado como Usuários de apps específicos às suas validações de entrega. Diferentemente dos filtros relacionados a apps, isso restringe a entrega aos tokens por push pertencentes aos apps selecionados.
- Ao compor a mensagem, especifique suas plataformas de entrega, como Apps móveis ou Navegadores web.
- Use Liquid para verificar o dispositivo ou app direcionado no momento do envio:
{{targeted_device.${platform}}}avalia a plataforma da sessão atual do usuário. Para saber mais, consulte Informações do dispositivo direcionado.{{app.${api_id}}}avalia qual app está solicitando a mensagem. Combine essa tag comabort_message()para evitar envios para o app errado. Para saber mais, consulte Informações do app direcionado.

Como os usuários avançam
Todos os usuários que entram na etapa de Mensagem avançam para a próxima etapa quando qualquer uma das seguintes condições é atendida:
- Qualquer mensagem é enviada
- Uma mensagem tem limite de frequência e não é enviada
- Uma mensagem sofre interrupção
- Um usuário não é alcançável pelo canal, então a mensagem não é enviada
- Um usuário não atende aos critérios em Validações de entrega
Se um Canvas baseado em ação for disparado por uma mensagem SMS de entrada, você pode referenciar as propriedades de SMS na primeira etapa (etapa de Mensagem) ou em uma etapa de Mensagem aninhada em uma etapa de jornadas de ação. Por exemplo, na etapa de Mensagem, você pode usar {{sms.${inbound_message_body}}} ou {{sms.${inbound_media_urls}}}.
Propriedades de contexto de referência

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 entrada são configuradas na etapa Programação de Entrada ao criar um Canvas e indicam o gatilho que faz um usuário entrar em um Canvas. Essas propriedades também podem acessar as propriedades das cargas úteis de entrada em Canvas disparados por API. Observe que o objeto context tem um limite máximo de tamanho de 50 KB.
As propriedades de entrada podem ser usadas em Liquid em qualquer etapa de Mensagem. Use o seguinte Liquid ao referenciar essas propriedades de entrada: {context.${property_name}}. Os eventos devem ser eventos personalizados ou eventos de compra para serem usados dessa forma.

Para canais de mensagem no app especificamente, context só pode ser referenciado em Canvas.
Use o seguinte Liquid ao referenciar essas propriedades de entrada: context.${property_name}. Observe que os eventos devem ser eventos personalizados ou eventos de compra para serem usados dessa forma.
Por exemplo, considere a seguinte solicitação: "context" : {"product_name" : "shoes", "product_price" : 79.99}. Você poderia adicionar a palavra “shoes” a uma mensagem com o Liquid {{context.${product_name}}}.
Você também pode aproveitar as propriedades de entrada persistentes em qualquer etapa de Mensagem para guiar seus usuários por etapas personalizadas ao longo do fluxo de trabalho do Canvas.
Propriedades de evento
As propriedades de evento se referem às propriedades que você define para eventos personalizados e eventos de compra. Essas propriedades de evento podem ser usadas em Campaigns com entrega baseada em ação, bem como em Canvas.
No Canvas, as propriedades de eventos personalizados e eventos de compra podem ser usadas em Liquid em qualquer etapa de Mensagem que segue uma etapa de jornadas de ação. Por exemplo, ao referenciar event_properties, use este snippet Liquid: {{event_properties.${property_name}}}

event_properties não pode ser usado independentemente das etapas de jornadas de ação.
Na primeira etapa de Mensagem após uma etapa de jornadas de ação, você pode usar event_properties relacionadas ao evento referenciado nessa etapa. Você pode ter outras etapas (que não sejam outra etapa de jornadas de ação ou de Mensagem) entre essa etapa de jornadas de ação e a etapa de Mensagem. Observe que você só terá acesso a event_properties se 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.

Você não pode usar event_properties na etapa de Mensagem principal. Em vez disso, você deve usar context ou adicionar uma etapa de jornadas de ação com o evento correspondente antes da etapa de Mensagem que inclui event_properties.
Expandir para o editor de Canvas original
Não é mais possível criar ou duplicar Canvas usando o editor original. Esta seção está disponível apenas para referência.
event_propertiesnão pode ser usado em etapas completas agendadas. No entanto, você pode usarevent_propertiesna primeira etapa completa de um Canvas baseado em ação, mesmo que a etapa completa esteja agendada.contextsó pode ser referenciado na primeira etapa completa de um Canvas.- Para canais de mensagem no app especificamente,
contextpode ser referenciado no editor de Canvas original se você tiver as propriedades de entrada persistentes ativadas como parte do acesso antecipado anterior.
Análise de dados
Consulte a tabela a seguir para as definições das métricas do componente de mensagem:
| Métrica | Descrição |
|---|---|
| Entradas | O número de vezes que a etapa foi acessada. Se o seu Canvas tiver reelegibilidade e um usuário entrar em uma etapa de mensagem duas vezes, duas entradas serão registradas. |
| Prosseguiu para a próxima etapa | O número de entradas que prosseguiram para a próxima etapa no Canvas. |
| Envios | O número total de mensagens que a etapa enviou. Se o seu Canvas tiver reelegibilidade e um usuário entrar em uma etapa de mensagem duas vezes, duas entradas serão registradas. |
| Destinatários únicos | O número de usuários que receberam mensagens desta etapa. |
| Evento de conversão primária | O número de vezes que um evento definido ocorreu após interagir com ou visualizar uma mensagem recebida de uma Campaign da Braze. Você define esse evento ao criar a Campaign. |
| Receita | A receita total em dólares dos destinatários da Campaign dentro da janela de conversão primária definida. |