Skip to content

Criar um Canvas

Este artigo de referência aborda as etapas necessárias para criar, manter e testar um Canvas. Siga este guia ou confira nosso curso do Braze Learning sobre Canvas. Você também pode começar a partir de um modelo de Canvas da Braze para agilizar sua configuração. Para saber mais, consulte Modelos de Canvas. Para rascunhar um Canvas a partir de uma descrição em linguagem natural, pergunte ao Operator.

Expandir para ver detalhes do editor original do Canvas

Não é mais possível criar ou duplicar Canvas usando a experiência original do Canvas. A Braze recomenda clonar seus Canvas para o editor mais recente.

Etapa 1: Configurar um novo Canvas

Primeiro, acesse Messaging > Canvas e selecione Create Canvas.

O construtor de Canvas vai guiar você passo a passo pela configuração do seu Canvas — desde dar um nome até definir eventos de conversão e trazer os usuários pretendidos para a jornada do cliente. Selecione cada uma das guias a seguir para ver quais configurações você pode ajustar em cada etapa do construtor.

Aqui, você vai configurar o básico do seu Canvas:

  • Dar um nome ao Canvas
  • Adicionar equipes
  • Adicionar tags
  • Atribuir eventos de conversão e escolher seus tipos de evento e prazos

Saiba mais sobre a etapa Básico.

Aqui, você vai decidir como e quando seus usuários entrarão no Canvas:

  • Agendado: Esta é uma entrada no Canvas baseada em tempo
  • Baseado em ação: Seu usuário entrará no Canvas após realizar uma ação definida
  • Disparado por API: Use uma solicitação de API para inserir usuários no Canvas

Saiba mais sobre a etapa Cronograma de entrada.

Aqui, você vai selecionar seu público-alvo:

  • Criar seu público adicionando Segments e filtros
  • Ajustar a reentrada e os limites de entrada do Canvas
  • Ver um resumo do seu público-alvo

Saiba mais sobre a etapa Público-alvo.

Aqui, você vai selecionar as configurações de envio do Canvas:

  • Selecionar suas configurações de inscrição
  • Definir um limite de frequência para as mensagens do Canvas
  • Ativar e configurar o horário de silêncio

Saiba mais sobre a etapa Configurações de envio.

Aqui, você vai construir seu Canvas.

Saiba como construir seu Canvas usando o construtor de Canvas.

Aqui, você encontrará o resumo dos detalhes do seu Canvas. Se o fluxo de aprovação do Canvas estiver ativado, você pode aprovar os detalhes listados do Canvas antes de lançá-lo.

Etapa 1.1: Comece com o básico do Canvas

Aqui, você vai dar um nome ao Canvas, atribuir equipes e criar ou adicionar tags. Você também pode atribuir eventos de conversão para o Canvas.

A página de detalhes do Canvas, com campos para nome, descrição, localização e tags do Canvas.

Escolha os eventos de conversão

Escolha o tipo de evento de conversão e selecione as conversões a serem registradas. Esses eventos de conversão vão medir a eficiência do seu Canvas.

Evento de conversão primária A com o tipo de evento de conversão Realiza compra para registrar conversões de usuários que fazem qualquer compra dentro de um prazo de conversão de três dias.

Se o seu Canvas tiver múltiplas variantes ou um grupo de controle, a Braze usará esse evento de conversão para determinar a melhor variação para atingir essa meta de conversão. Usando a mesma lógica, você pode criar múltiplos eventos de conversão.

Etapa 1.2: Determine o cronograma de entrada do Canvas

Você pode escolher uma de três formas pelas quais os usuários podem entrar no Canvas.

Tipos de cronograma de entrada

Com a entrega agendada, os usuários entrarão em um cronograma de tempo, de forma semelhante a como você agendaria uma campanha. Você pode inscrever usuários em um Canvas assim que ele for lançado, inseri-los na jornada em algum momento no futuro ou de forma recorrente (diária, semanal ou mensal).

Se você selecionar um cronograma recorrente mensal, observe que alguns meses podem não ter o dia selecionado. Por exemplo, digamos que você configurou um Canvas para enviar mensalmente no dia 31. Nesse cenário, a Braze envia no último dia daquele mês, como 30 de abril, porque 31 de abril não existe.

Neste exemplo, com base nas opções de tempo, os usuários entram neste Canvas toda terça-feira às 12h no fuso local, toda semana, começando em 14 de novembro de 2025 até 31 de dezembro de 2025.

A página "Cronograma de entrada" com o tipo definido como "Agendado". Devido à seleção, são exibidas opções baseadas em tempo, incluindo frequência, horário de início, recorrência, dias e mais.

Ao usar a entrega por fuso local, a Braze avalia a elegibilidade de entrada duas vezes: primeiro no horário de Samoa (UTC+13) no dia agendado e novamente no fuso local do usuário. Um usuário precisa ser elegível em ambas as verificações para entrar no Canvas. Se seus filtros de entrada usarem janelas de tempo relativas (por exemplo, “há mais de 2 dias”), o período de 24 horas pode não ter decorrido no momento da primeira verificação, fazendo com que os usuários entrem um dia atrasados. Para evitar isso, use uma janela de tempo mais ampla, como pelo menos dois dias. Para saber mais, consulte Quando a Braze avalia os usuários para entrega por fuso local?

Com a entrega baseada em ação, os usuários entrarão no Canvas e começarão a receber mensagens quando realizarem ações específicas, como abrir o app, fazer uma compra ou disparar um evento personalizado.

Você pode controlar outros aspectos do comportamento do Canvas na janela Público de entrada, incluindo regras de reelegibilidade e configurações de limite de frequência. Observe que a entrega baseada em ação não está disponível para componentes do Canvas com mensagens no app.

Um exemplo de entrega baseada em ação. Os usuários entrarão no Canvas se fizerem uma compra, com uma janela de entrada começando às 13h30 em 10 de junho de 2025.

Com a entrega disparada por API, os usuários entrarão no Canvas e começarão a receber mensagens após serem adicionados usando o endpoint /canvas/trigger/send via API. No dashboard, você pode encontrar um exemplo de solicitação cURL que faz isso, além de atribuir context opcional usando o objeto de contexto.

Um exemplo de entrega disparada por API com um Canvas ID e um exemplo de solicitação cURL.

Você pode usar os seguintes endpoints para entrega disparada por API:

Após selecionar seu método de entrega, ajuste as configurações para corresponder ao seu caso de uso e continue para definir seu público-alvo.

Comportamento de deduplicação para Canvas usando o editor original

Se a janela de reelegibilidade for menor que a duração máxima do Canvas, um usuário poderá reentrar e receber mensagens de mais de um componente. No caso extremo em que a reentrada de um usuário alcança o mesmo componente da entrada anterior, a Braze fará a deduplicação das mensagens desse componente.

Se um usuário reentrar no Canvas, alcançar o mesmo componente da entrada anterior e for elegível para uma mensagem no app em cada entrada, o usuário receberá a mensagem duas vezes (dependendo da prioridade da mensagem no app), desde que reabra uma sessão duas vezes.

Etapa 1.3: Defina o público de entrada alvo

Somente os usuários que correspondem aos critérios definidos podem entrar na jornada na etapa Público-alvo, o que significa que a Braze avalia a elegibilidade do público-alvo primeiro, antes de os usuários entrarem na jornada do Canvas. Por exemplo, se você quiser direcionar novos usuários, pode selecionar um Segment de usuários que usaram seu app pela primeira vez há menos de uma semana.

Em Controles de entrada, você pode limitar o número de usuários toda vez que o Canvas for agendado para execução. Para Canvas baseados em disparo por API e baseados em ação, esse limite ocorre a cada hora UTC.

Testando seu público

Após adicionar Segments e filtros ao seu público-alvo, você pode testar se o público está configurado conforme esperado buscando um usuário para confirmar se ele corresponde aos critérios do público.

O campo "Busca de usuário", que permite pesquisar por ID de usuário externo ou ID da Braze.

Selecionando controles de entrada

Os controles de entrada determinam se os usuários podem reentrar em um Canvas. Você também pode limitar o número de pessoas que potencialmente entrariam neste Canvas por uma cadência selecionada, dependendo do tipo de cronograma de entrada:

  • Agendado: Tempo de vida do Canvas ou toda vez que o Canvas for agendado
  • Baseado em ação: Por hora, diariamente ou pelo tempo de vida do Canvas
  • Disparado por API: Por hora, diariamente ou pelo tempo de vida do Canvas

Por exemplo, se você tem um Canvas agendado e seleciona Limitar volume de entrada e define o campo Máximo de entradas como 500.000 usuários com Toda vez que o Canvas for agendado como cadência de limite, então o Canvas envia apenas para 500.000 usuários por envio agendado.

A página "Controles de entrada" exibindo caixas de seleção para "Permitir que usuários reentrem no Canvas" e "Limitar volume de entrada".

Definindo critérios de saída

Definir os critérios de saída determina quais usuários você deseja que saiam de um Canvas. Se um usuário realizar o evento de exceção ou corresponder aos Segments e filtros, ele não receberá mais nenhuma mensagem.

Calculando o público-alvo

Na seção Público-alvo, você pode ver um resumo do seu público, como os Segments selecionados e filtros adicionais, e um detalhamento de quantos usuários são contatáveis por canal de envio de mensagens. Para calcular o número exato de usuários contatáveis no seu público-alvo em vez da estimativa padrão, selecione Calcular estatísticas exatas.

Observe que:

  • Calcular estatísticas exatas pode levar alguns minutos para ser executado. Essa função calcula apenas as estatísticas exatas no nível do Segment, não no nível do filtro ou grupo de filtros.
  • Enquanto as estatísticas exatas estão carregando, uma estimativa arredondada pode aparecer. O número exato aparece na seção Usuários contatáveis quando carregado. Você pode selecionar Mostrar estatísticas adicionais para um detalhamento completo.
  • Para Segments grandes, é normal ver pequenas variações mesmo ao calcular estatísticas exatas. A precisão desse recurso é esperada em 99,999% ou mais.

Para ver estatísticas adicionais, como a receita média ao longo da vida dos usuários direcionados, selecione Mostrar estatísticas adicionais.

Detalhamento do público-alvo com opção de calcular estatísticas exatas.

Por que a contagem do público-alvo pode diferir da contagem de usuários contatáveis

O tamanho do público-alvo exibido em uma Campaign ou Canvas pode ser diferente do tamanho do público alcançável para um segmento, mesmo que você esteja adicionando diretamente esse segmento à sua Campaign ou Canvas sem filtros adicionais. Isso pode ocorrer por vários motivos:

  • Quando um grupo de controle global se aplica a uma Campaign ou Canvas, os usuários desse grupo de controle global são excluídos da contagem de usuários contatáveis.
  • O tamanho do público-alvo de uma Campaign ou Canvas exclui os usuários que não podem ser contatados por meio de vários canais de mensagens; o comportamento difere de canal para canal. Por exemplo, o público alcançável de uma Campaign ou Canvas exclui os usuários que cancelaram a inscrição, foram marcados como SPAM (para e-mails) ou sofreram hard bounce (para e-mails). O segmento em si, no entanto, exclui apenas os cancelamentos de inscrição ao mostrar o número estimado de usuários alcançáveis por e-mail.
  • A Braze só envia mensagens SMS para usuários dentro do grupo de inscrições selecionado, portanto, o público-alvo de SMS para uma Campaign ou Canvas também excluirá todos os usuários que não fizerem parte do grupo de inscrições selecionado.

Etapa 1.4: Selecione suas configurações de envio

Selecione Configurações de envio para editar suas configurações de inscrição, ativar o limite de frequência e ativar o horário de silêncio. Ao ativar o limite de frequência ou o limite de frequência de mensagens, você pode aliviar a pressão de marketing sobre seus usuários e garantir que não está enviando mensagens em excesso.

Para Canvas direcionados a canais de e-mail e push, você pode querer limitar o Canvas para que apenas os usuários que optaram explicitamente pela aceitação recebam a mensagem (excluindo usuários inscritos ou que cancelaram a inscrição). Por exemplo, digamos que você tem três usuários com diferentes status de aceitação:

  • Usuário A está inscrito para e-mail e está com push ativado. Esse usuário não recebe o e-mail, mas receberá o push.
  • Usuário B fez a adesão (opt-in) ao e-mail, mas não está com push ativado. Esse usuário receberá o e-mail, mas não receberá o push.
  • Usuário C fez a adesão (opt-in) ao e-mail e está com push ativado. Esse usuário receberá tanto o e-mail quanto o push.

Para fazer isso, defina as Configurações de inscrição para enviar este Canvas para “apenas usuários que optaram pela aceitação”. Essa opção garantirá que apenas usuários que optaram pela aceitação receberão seu e-mail, e a Braze enviará push apenas para usuários que estão habilitados para push por padrão.

Essas configurações de inscrição são aplicadas por etapa, o que significa que não há efeito no público de entrada. Portanto, essa configuração é usada para avaliar a elegibilidade de um usuário para receber cada etapa do Canvas.

Você pode optar por especificar o horário de silêncio (o período durante o qual suas mensagens não são enviadas) para o Canvas. Marque Ativar horário de silêncio nas Configurações de envio. Em seguida, selecione o horário de silêncio no fuso local do usuário e se a mensagem deve ser interrompida ou enviada no próximo horário disponível.

Quando Enviar no próximo horário disponível estiver selecionado, o horário de silêncio suprime a mensagem e a envia no próximo horário disponível fora do horário de silêncio. Por exemplo, digamos que o horário de silêncio está configurado para impedir o envio de mensagens entre 11h30 e 14h30 no fuso local do usuário, e um usuário entra em uma etapa de mensagem às 11h35. Como esse horário está dentro do horário de silêncio, a mensagem ainda não é enviada, e o usuário recebe a etapa de mensagem às 14h30, que é após o horário de silêncio.

A página "Horário de silêncio" exibindo uma caixa de seleção para ativar o horário de silêncio. Se ativado, o horário de início, horário de término e comportamento de fallback podem ser definidos.

Etapa 2: Construa seu Canvas

Etapa 2.1: Adicionar uma variante

O botão "Adicionar variante" selecionado mostrando um menu de contexto com a opção "Adicionar variante".

Selecione Adicionar variante e adicione uma nova variante ao seu Canvas. As variantes representam uma jornada que seus usuários percorrerão e podem conter múltiplas etapas e ramificações.

Você pode adicionar variantes adicionais selecionando o botão de adição . Ao adicionar novas variantes, você poderá ajustar como seus usuários serão distribuídos entre elas para que possa comparar e analisar a eficácia de diferentes estratégias de engajamento.

Dois exemplos de variantes em um Canvas da Braze.

Etapa 2.2: Adicionar etapas do Canvas

Você pode adicionar mais etapas ao fluxo de trabalho do seu Canvas arrastando e soltando componentes da barra lateral Componentes. Ou selecione o botão de adição para adicionar um componente com o menu popover.

A janela de busca de componentes adicionando uma etapa de postergação ao Canvas da Braze.

Duração máxima

À medida que a jornada do seu Canvas aumenta em etapas, a duração máxima é o maior tempo possível que um usuário pode levar para concluir esse Canvas. Isso é calculado somando as postergações e janelas de disparo de cada etapa para cada variante no caminho mais longo. Por exemplo, se o seu Canvas tem uma etapa de postergação com uma postergação de 3 dias e uma etapa de mensagem, a duração máxima do seu Canvas será de 3 dias.

Editando uma etapa

Quer editar uma etapa na jornada do usuário? Confira como fazer isso dependendo do fluxo de trabalho do seu Canvas!

Você pode editar qualquer etapa no fluxo de trabalho do seu Canvas selecionando qualquer um dos componentes. Por exemplo, digamos que você queira editar sua primeira etapa, um componente de Postergação, no seu fluxo de trabalho para um dia específico. Selecione a etapa para visualizar suas configurações e ajuste sua postergação para 1º de março. Isso significa que em 1º de março, seus usuários avançarão para a próxima etapa do seu Canvas.

Um exemplo de etapa de "Postergação" com a postergação definida como "Até um dia específico".

Ou você pode editar e ajustar rapidamente as Configurações de ação da sua etapa de jornadas de ação para manter os usuários por um período de tempo. Isso prioriza o próximo caminho deles com base nas ações durante esse período de avaliação.

A segunda etapa no Canvas, "Configurações de ação", com uma janela de avaliação definida como 1 dia.

Os componentes leves do Canvas permitem uma experiência de edição simples, facilitando o ajuste dos detalhes mais específicos do seu Canvas.

Mensagens no Canvas

Edite as mensagens em um componente do Canvas para controlar as mensagens que uma etapa específica enviará. O Canvas pode enviar e-mails, mensagens push para dispositivos móveis e web, e webhooks para integração com outros sistemas. De forma semelhante às Campaigns, você pode usar certos modelos Liquid para personalizar suas mensagens.

O componente de mensagem gerencia as mensagens enviadas aos usuários. Você pode selecionar seus Canais de envio de mensagens e ajustar as Configurações de entrega para otimizar o envio de mensagens do seu Canvas. Para mais detalhes sobre este componente, confira Mensagem.

A etapa "Configurar mensagens", com "Canais de envio de mensagens" selecionado, exibindo a lista de canais de envio de mensagens disponíveis, como push para Android, Content Cards, e-mail e mais.

Selecione Concluído após terminar de configurar seu componente do Canvas.

O objeto context é configurado na etapa Cronograma de entrada da criação de um Canvas e indica o disparo 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 pode ter até 50 KB.

Use o seguinte Liquid ao referenciar essas propriedades criadas ao entrar no Canvas: 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 requisição: "context" : {"product_name" : "shoes", "product_price" : 79.99}. Você poderia adicionar a palavra “shoes” a uma mensagem com este Liquid {{context.${product_name}}}.

As propriedades de evento são as propriedades definidas por você em eventos personalizados e compras. Essas event_properties podem ser usadas em Campaigns com entrega baseada em ação, bem como em Canvas.

No Canvas, as propriedades de eventos personalizados e de compra podem ser usadas em Liquid em qualquer etapa de mensagem que siga uma etapa de jornadas de ação. Use este Liquid {{event_properties.${property_name}}} ao referenciar essas event_properties. Esses eventos devem ser eventos personalizados ou eventos de compra para serem usados dessa forma no componente de mensagem.

Na primeira etapa de mensagem após uma jornada de ação, você pode usar event_properties relacionadas ao evento referenciado nessa jornada de ação. 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 às event_properties se sua etapa de mensagem puder ser rastreada de volta a um caminho que não seja “Todos os outros” em uma etapa de jornada de ação.

Etapa 2.3: Editar conexões

Para mover uma conexão entre etapas, selecione a seta que conecta os dois componentes e selecione um componente diferente. Para remover a conexão, selecione a seta seguida de Cancelar conexão no rodapé do criador do Canvas.

Se uma única variante tiver múltiplas ramificações com o mesmo público e horário de envio, a Braze não garante uma divisão uniforme entre essas ramificações. A distribuição pode favorecer a ramificação que foi criada primeiro. Para uma divisão uniforme, use filtros de número de bucket aleatório em cada ramificação. Para saber mais, consulte O que acontece se o público e o horário de envio forem idênticos para um Canvas que tem uma variante, mas múltiplas ramificações?.

Etapa 3: Adicionar um grupo de controle

Você pode adicionar um grupo de controle ao seu Canvas selecionando o botão de adição para adicionar uma nova variante.

A Braze rastreará as conversões dos usuários que forem colocados no grupo de controle, embora eles não recebam nenhuma mensagem. Para manter um teste preciso, rastrearemos o número de conversões das suas variantes e do grupo de controle pelo mesmo período de tempo, conforme mostrado na tela de seleção de eventos de conversão.

Você pode ajustar a distribuição entre suas mensagens clicando duas vezes nos cabeçalhos de Variant Name.

Neste exemplo, nosso Canvas está dividido em duas variantes. A Variante 1 tem 70% dos usuários. A segunda variante é um grupo de controle com os 30% restantes dos usuários.

Um exemplo de variante em um Canvas da Braze, onde 70% vão para a "Variante 1", que posterga por 1 dia na primeira etapa e depois envia uma mensagem na segunda etapa. Os outros 30% vão para um "Controle" que não tem nenhuma etapa subsequente.

Seleção inteligente para Canvas

Os recursos de seleção inteligente agora estão disponíveis em Canvas multivariantes. Semelhante ao recurso de seleção inteligente para Campaigns multivariantes, a seleção inteligente para Canvas analisa o desempenho de cada variante do Canvas e ajusta a porcentagem de usuários direcionados para cada variante. Essa distribuição é baseada nas métricas de desempenho de cada variante para maximizar o número total esperado de conversões.

Lembre-se de que Canvas multivariantes permitem testar não apenas o texto, mas também o timing e os canais. Por meio da seleção inteligente, você pode testar Canvas de forma mais eficiente e ter confiança de que seus usuários serão enviados na melhor jornada possível do Canvas.

A opção "Seleção inteligente" está ativada na página "Editar distribuição de variantes". Conforme analisa e otimiza o Canvas, ela exibe uma barra horizontal na página dividida em várias seções, cada uma variando em cor e tamanho. Isso é apenas uma representação visual e não corresponde a nenhuma análise de dados específica.

A seleção inteligente para Canvas otimiza os resultados do seu Canvas fazendo ajustes graduais em tempo real na distribuição de usuários direcionados para cada variante. Quando o algoritmo estatístico determina um vencedor decisivo entre suas variantes, ele descarta as variantes com desempenho inferior e direciona todos os futuros destinatários elegíveis do Canvas para as variantes vencedoras.

Por esse motivo, a seleção inteligente funciona melhor em Canvas que recebem novos usuários com frequência.

Etapa 4: Salvar e lançar

Depois de terminar de criar seu Canvas, selecione Launch Canvas para salvar e lançar seu Canvas. Após o lançamento, você poderá visualizar a análise de dados da sua jornada conforme os dados forem chegando na página Canvas Details.

Você também pode salvar seu Canvas como rascunho se precisar voltar a ele depois.

Um exemplo de Canvas na Braze.

New Stuff!