Criar uma mensagem no app com arrastar e soltar
O editor de arrastar e soltar é a forma recomendada para criar a maioria das mensagens no app. Crie mensagens modais e em tela cheia com os mesmos layouts principais do editor tradicional, além de mais personalização por meio de linhas, Content Blocks, modelos e fluxos de várias páginas. Para conhecer os blocos de construção do editor, consulte Blocos do editor.
Se você quiser usar seus modelos HTML personalizados existentes ou modelos criados por terceiros, eles precisam ser recriados no editor de arrastar e soltar.
Não tem certeza se sua mensagem no app deve ser enviada usando uma Campaign ou um Canvas? Campaigns são melhores para mensagens únicas e direcionadas, enquanto Canvas são melhores para jornadas de usuário com várias etapas. Depois de selecionar onde criar sua mensagem, siga estas etapas para criar uma mensagem no app com arrastar e soltar.
Pré-requisitos
Requisitos de SDK
| Versão mínima do SDK | Versão recomendada do SDK |
|---|---|
Mais informações sobre os SDKs mínimos
As mensagens criadas com o editor de arrastar e soltar só podem ser enviadas para usuários que estejam nas versões mínimas do SDK (consulte a tabela na seção anterior). Se um usuário não tiver atualizado o app (ou seja, se estiver em uma versão mais antiga do SDK), ele não receberá a mensagem no app.
Para aproveitar todos os recursos disponíveis no editor de arrastar e soltar, atualize seus SDKs para as versões recomendadas. Assim, você terá acesso aos seguintes recursos adicionais:
- Links de texto que não fecham a mensagem
- Ação de botão para solicitar o primer de push
Confira abaixo os requisitos mínimos de SDK de cada um desses recursos:
| Links de texto* | Solicitar primer de push |
|---|---|
*Se você incluir na mensagem no app um link que redireciona para um URL e o usuário final não estiver nas versões mínimas do SDK especificadas, selecionar o link fechará a mensagem. Então, o usuário não conseguirá voltar à mensagem para enviar o formulário.
Pré-requisitos adicionais
- Para o Web SDK, a opção de inicialização
allowUserSuppliedJavascriptdeve estar definida comotrue. A opçãoenableHtmlInAppMessagestambém permite que essas mensagens funcionem, mas está obsoleta e deve ser substituída porallowUserSuppliedJavascript. - Se você usa o Google Tag Manager, precisa ativar “Allow HTML In-App Messages” na configuração do GTM.
Etapa 1: Crie uma mensagem no app
Crie uma nova mensagem no app ou etapa do Canvas e selecione Editor de arrastar e soltar como sua experiência de edição.
Etapa 2: Selecione seu modelo
Depois de selecionar o editor de arrastar e soltar como sua experiência de edição, você pode escolher:
- Começar com um modelo modal em branco
- Usar um modelo de mensagem no app de arrastar e soltar da Braze
- Selecionar um modelo salvo de mensagem no app de arrastar e soltar
Selecione Criar mensagem para começar a projetar sua mensagem no app no editor de arrastar e soltar.

Você também pode acessar todos os modelos na seção Modelos do dashboard.
Etapa 3: Adicionar páginas adicionais (opcional)
Adicionar páginas à sua mensagem no app permite guiar os usuários por um fluxo sequencial, como um fluxo de integração ou jornada de boas-vindas. Você pode gerenciar páginas na seção Pages da guia Build.

Etapa 3a: Conectar páginas entre si
Mensagens no app com várias páginas são sequenciais, o que significa que os usuários interagem com a mensagem tocando ou clicando para avançar para a próxima página no fluxo.
Para conectar páginas entre si:
- Selecione sua página inicial.
- Selecione um elemento de botão ou imagem no canvas.
- Defina On-click behavior como Go to page.
- Selecione a página para a qual deseja vincular a partir da página inicial.
- Continue até que todas as páginas estejam vinculadas.

Se uma página não estiver vinculada a nenhuma outra página, a mensagem não poderá ser lançada.

Os usuários podem selecionar o botão X de fechar para sair da mensagem a qualquer momento. Esse botão não pode ser removido.
Etapa 4: Crie e projete sua mensagem no app
É aqui que sua mensagem desfila na passarela, vestida com o estilo característico da sua marca. Combinando blocos do editor e configurações de estilo, você pode personalizar e projetar sua mensagem no app.
- Para ver uma lista dos blocos do editor disponíveis e suas propriedades, consulte Blocos do editor.
- Para obter ajuda com a personalização da aparência da sua mensagem, confira Configurações de estilo.
- Para conhecer as práticas recomendadas de criação de mensagens da direita para a esquerda, consulte Criação de mensagens da direita para a esquerda.
Etapa 5: Adicionar pares de chave-valor (opcional)
Você pode adicionar pares de chave-valor para enviar dados personalizados extras aos dispositivos dos usuários junto com a mensagem. A Braze entrega os pares na carga útil da mensagem, para que seu app possa lê-los e agir com base neles. Por exemplo, seu app pode usar pares de chave-valor para aplicar estilos personalizados ou lógica de layout, direcionar a mensagem para uma parte específica do app ou enviar metadados para sua própria análise de dados.
- No criador de mensagem, selecione a guia Configurações.
- Selecione a guia Pares de chave-valor e, em seguida, selecione Adicionar novo par.
- Insira uma chave e um valor para cada par. Para adicionar outro par, selecione Adicionar novo par novamente.
Para ver um exemplo de leitura de pares de chave-valor no seu app, consulte Personalizar o estilo de mensagens usando pares de chave-valor.
Etapa 6: Teste sua mensagem no app
A seção Prévia e Teste permite que você tenha uma prévia das suas mensagens no app em diferentes dispositivos e envie uma mensagem de teste para o seu dispositivo. Aqui, você pode garantir que os detalhes estejam alinhados em todas as suas plataformas na sua campanha de mensagem no app de arrastar e soltar.
É importante sempre testar suas mensagens no app antes de enviar suas campanhas. Assim, você consegue visualizar como a mensagem final vai aparecer da perspectiva do usuário.
Prévia da mensagem como usuário

Para enviar um teste para grupos de teste de conteúdo ou para usuários individuais, o push precisa estar ativado nos seus dispositivos de teste antes do envio.
Na guia Prévia e Teste, você pode ter uma prévia das mensagens como se fosse um usuário. Você pode selecionar um usuário específico, um usuário aleatório ou criar um usuário personalizado:
- Usuário aleatório: A Braze seleciona aleatoriamente um usuário do banco de dados e gera a prévia da mensagem no app com base nos atributos ou nas informações de eventos dele.
- Selecionar usuário: Você pode selecionar um usuário específico com base no endereço de e-mail ou no
external_id. A prévia da mensagem no app será gerada com base nos atributos e nas informações de eventos desse usuário. - Usuário personalizado: Você pode personalizar um usuário. A Braze oferece campos para todos os atributos e eventos disponíveis. Insira as informações que você quer ver na prévia do e-mail.
Checklist de teste
Considere as seguintes perguntas ao testar sua mensagem no app:
- Você testou a mensagem em diferentes dispositivos?
- As imagens e mídias aparecem e se comportam como esperado?
- O Liquid funciona como esperado? Você definiu um valor de atributo padrão para o caso de o Liquid não retornar nenhuma informação?
- Seu texto está claro, conciso e correto?
- Seus botões direcionam o usuário para onde ele deve ir?
Perguntas frequentes
Por que os cliques no corpo não aparecem na minha página de análise de dados?
Os cliques no corpo não são coletados automaticamente em mensagens no app criadas com o editor de arrastar e soltar. Para saber mais, consulte os changelogs do SDK para iOS e Android.
Posso segmentar com base em cliques em botões?
Sim. Você pode segmentar com base em cliques em até dois botões da sua mensagem. Para isso, defina o Identificador para relatórios dos botões como “0” e “1”. Esses valores correspondem aos filtros de segmentação “Clicked in-app message button 1” e “Clicked in-app message button 2”, respectivamente.

Posso personalizar minha mensagem no app com HTML ou JavaScript personalizados, ou transferir mensagens HTML existentes para o editor?
Não é possível transferir diretamente mensagens HTML existentes para o editor, mas você pode inserir HTML, CSS e JavaScript brutos em um bloco de Código personalizado. Use blocos de Código personalizado para incorporar vídeos de terceiros e Liquid avançado, como Connected Content ou instruções condicionais. Para ver métodos JavaScript do brazeBridge e exemplos de rastreamento de cliques, consulte Mensagens no app em HTML personalizado.
Por que a visualização do criador no editor de arrastar e soltar pode ser diferente da mensagem final?
O editor de arrastar e soltar renderiza sua mensagem dentro de um criador e aplica estilos e padrões exclusivos da prévia para que você possa montar e revisar o layout. Esses tratamentos ajudam você a ver a estrutura e o conteúdo de espaço reservado durante a edição, mas não são incluídos na mensagem que seus usuários recebem.
Exemplos comuns de comportamentos exclusivos do editor:
- O editor envolve os blocos de Código personalizado em um contêiner
bz-html-code-blockcom ummin-heightpadrão de40px, para que blocos vazios ou curtos continuem visíveis durante a edição - Imagens em branco ou que contêm Liquid exibem um espaço reservado no editor
- Grupos de caixas de seleção e botões de opção pré-selecionam a primeira opção para que você possa ter uma prévia do estado ativo
Se algo parece diferente só no editor, geralmente é um comportamento da prévia. Ao solucionar problemas na mensagem entregue, revise os estilos e a marcação nos blocos da sua mensagem, e não o quadro exclusivo do editor nem os padrões da prévia.
Como posso criar uma mensagem no app do tipo slideup?
No momento, o editor é limitado a mensagens modais e de tela cheia. Você pode alternar entre os tipos de exibição na seção Contêiner da mensagem do painel Estilos de mensagem.
Posso salvar minha mensagem no app como modelo depois de criá-la na minha Campaign ou no meu Canvas?
Sim. Qualquer mensagem no app que você queira reutilizar em uma Campaign futura ou em uma etapa do Canvas pode ser salva como modelo personalizado com o botão Salvar como modelo, disponível depois que você sai do editor. Antes de salvá-la como modelo, você precisa lançar a Campaign OU salvá-la como rascunho.

Você também pode criar e salvar modelos de mensagens no app acessando Conteúdo > Mensagem no app.
Por que minha sintaxe Liquid aparece como texto simples na minha mensagem no app paginada?
Se a sintaxe Liquid aparecer como texto simples ao testar uma mensagem no app paginada (em vez do conteúdo personalizado), pode haver um erro de sintaxe Liquid em uma das páginas. Um erro de sintaxe em uma página afeta a renderização do Liquid em todas as páginas da mensagem, porque as páginas não são independentes.
Para solucionar o problema:
- Verifique se há erros de sintaxe Liquid em todas as páginas da mensagem. Uma prévia com falha em uma página não significa que o erro esteja nela. Como as páginas não são independentes, o erro de sintaxe pode estar em qualquer lugar da mensagem.
- Confirme se todas as Liquid tags estão fechadas e formatadas corretamente.
