Criar uma mensagem no app
Você pode criar uma mensagem no app ou uma mensagem no navegador usando a plataforma da Braze por meio de Campaigns, Canvas ou como uma campanha da API. Recomendamos usar o editor de arrastar e soltar para a maioria dos casos de uso, e planejar suas mensagens e preparar todos os materiais com antecedência usando nosso Guia de preparação de mensagens no app.
Pré-requisitos
Antes de começar, verifique se você tem o seguinte:
| Requisito | Descrição |
|---|---|
| SDK da Braze | Integre o SDK da Braze ao seu app ou website. |
| Campaign ou Canvas | Use uma Campaign para uma única mensagem direcionada ou um Canvas para uma jornada de usuário com várias etapas. |
| Plano de mensagem | Prepare seu conteúdo e ativos usando o guia de preparação de mensagens no app. |
Experiência de edição
Para a maioria das mensagens no app, use o editor de arrastar e soltar. Ele oferece suporte a mensagens modal e em tela cheia com os mesmos layouts principais do editor tradicional, além de linhas, Content Blocks, modelos, fluxos de várias páginas e atualizações contínuas de recursos. Consulte Criar uma mensagem no app com arrastar e soltar para orientações passo a passo.
Use o editor tradicional quando precisar de mensagens slideup ou HTML personalizado.
Mudar uma mensagem de arrastar e soltar para o editor tradicional converte a mensagem em HTML. Não é possível voltar para o editor de arrastar e soltar depois disso.
Inicie sua mensagem
- Acesse Mensagens > Campaigns e selecione Criar Campaign.
- Selecione Mensagem no app. Observe que as mensagens no app não estão disponíveis em Campaigns multicanal.
- Dê à sua Campaign um nome claro e significativo.
- Adicione Equipes e Tags conforme necessário.
- As tags facilitam encontrar suas Campaigns e criar relatórios a partir delas. Por exemplo, ao usar o Criador de relatórios, você pode filtrar por tags específicas.
- Adicione e nomeie quantas variantes forem necessárias para sua Campaign. Você pode escolher plataformas, tipos de mensagem e layouts diferentes para cada variante adicionada. Para saber mais sobre esse tópico, consulte Testes multivariantes e A/B.
Se todas as mensagens da sua Campaign forem semelhantes ou tiverem o mesmo conteúdo, crie sua mensagem antes de adicionar outras variantes. Depois, você pode escolher Copiar da variante no menu suspenso Adicionar variante.
- Crie seu Canvas usando o criador de Canvas.
- Depois de configurar seu Canvas, adicione uma etapa no construtor de Canvas. Dê à sua etapa um nome claro e significativo.
- Escolha um cronograma de etapa e especifique um delay conforme necessário. Note que etapas contendo mensagens no app não podem ser baseadas em ação.
- Filtre seu público para esta etapa conforme necessário. Você pode refinar ainda mais os destinatários desta etapa especificando Segments e adicionando filtros adicionais. As opções de público serão verificadas após o delay, no momento em que as mensagens forem enviadas.
- Escolha seu comportamento de avanço.
- Escolha quaisquer outros canais de envio de mensagens que você deseja combinar com sua mensagem.
Não é possível ter várias variantes de mensagem no app em uma única etapa.
Você encontra mais informações específicas do Canvas em Mensagens no app no Canvas.
Plataformas de entrega
Escolha as plataformas que receberão a mensagem. As seleções de plataforma se aplicam a variantes individuais, permitindo que você teste o engajamento em diferentes plataformas.
| Plataforma | Entrega da mensagem |
|---|---|
| Mobile Apps | Apps Android, iOS, Kindle e tvOS |
| Web Browsers | Apps web |
| Both Mobile Apps & Web Browsers | Apps Android, iOS, Kindle, Kepler, tvOS e web |
| Roku Devices | Apps Roku |
Tipos de mensagem
Depois de selecionar uma plataforma de entrega, escolha um tipo de mensagem e um layout. Os tipos disponíveis dependem da plataforma de entrega e da experiência de edição. Para especificações de aparência, comportamento e criativos, consulte Tipos de mensagem no app.
| Tipo de mensagem | Experiência de edição | Disponibilidade e layouts | Quando usar |
|---|---|---|---|
| Tela cheia | Arrastar e soltar e tradicional | Imagem e texto ou somente imagem. O editor tradicional pode forçar a orientação retrato ou paisagem. | Anúncios ou promoções importantes que precisam da atenção total do usuário. |
| Modal | Arrastar e soltar e tradicional | Texto com imagem opcional ou somente imagem. O Roku é compatível apenas com mensagens modais. | Promoções e avisos de recursos que precisam se destacar sem cobrir a tela inteira. |
| Slideup | Tradicional | Aparece na parte superior ou inferior da tela do app. | Anúncios curtos, como novos recursos ou avisos de cookies, que não devem bloquear o restante da tela. |
| HTML personalizado | Tradicional | Compatível com HTML, CSS e JavaScript personalizados. Ative allowUserSuppliedJavascript para usar JavaScript. |
Layouts personalizados ou experiências interativas que os tipos de mensagem padrão não suportam. |
| Formulário de captura de e-mail | Tradicional | Disponível para as seleções de plataformas de app e web compatíveis. | Coletar endereços de e-mail de usuários no seu app ou website. |
| Modal web com CSS | Tradicional | Disponível quando você seleciona Navegadores da web. | Mensagens modais exclusivas para web que precisam de CSS personalizado. |
Mensagens com código personalizado devem incluir um controle para fechar ou dispensar a mensagem. Você pode usar o seguinte snippet:
<a href="appboy://close">X</a>
Criação
Os campos disponíveis dependem da plataforma, do tipo de mensagem, do layout e da experiência de edição.
| Campo ou configuração | O que controla | Notas |
|---|---|---|
| Idioma | Adiciona condições Liquid específicas por idioma. | Adicione os idiomas antes de escrever o conteúdo. |
| Imagem | Adiciona uma imagem enviada, um URL de imagem, um selo ou um ícone do Font Awesome. | As opções dependem do tipo de mensagem. |
| Cabeçalho e Mensagem | Define o texto da mensagem. | Suporta Liquid e outras formas de personalização. |
| Texto do botão e Comportamento ao clicar | Configura até dois botões e suas ações. | As ações disponíveis dependem das plataformas selecionadas. |
| Fechamento da mensagem | Controla como os usuários dispensam a mensagem. | Escolha o fechamento automático ou aguardar que o usuário dispense a mensagem. |
| Posição do slideup | Posiciona um slideup na parte superior ou inferior da tela do app. | Disponível somente para mensagens do tipo slideup. |
| HTML e ativos | Define o código personalizado e os ativos enviados. | Disponível para tipos de mensagem com código personalizado. |
| Pares de chave-valor | Envia campos personalizados extras para os dispositivos dos usuários. | Configure-os na guia Configurações. |
Para criar mensagens com o editor de arrastar e soltar, consulte Criar uma mensagem no app com arrastar e soltar.
A guia Criar permite editar o conteúdo e o comportamento da mensagem.
O conteúdo da guia Criar varia de acordo com as opções de mensagem selecionadas.
Idioma
Selecione Adicionar idiomas e escolha os idiomas desejados na lista fornecida. Isso vai inserir Liquid na sua mensagem. Recomendamos selecionar os idiomas antes de escrever o conteúdo, assim você pode preencher o texto no lugar certo dentro do Liquid. Confira nossa lista completa de idiomas disponíveis.
Imagem
Dependendo do tipo de mensagem, você pode usar Fazer upload de imagem, Escolher um selo ou Font Awesome. Para fazer upload de uma imagem, selecione Adicionar imagem ou informe um URL de imagem. Ao selecionar Adicionar imagem, a Biblioteca de mídia é aberta. Lá, você pode escolher uma imagem enviada anteriormente ou adicionar uma nova. Cada tipo de mensagem e plataforma pode ter proporções e requisitos próprios. Por isso, confira quais são antes de encomendar ou criar uma nova imagem.
Se você está carregando imagens com Conteúdo conectado ou Liquid, certifique-se de que a URL da imagem comece com https://. Usar http:// pode causar falha no seu app.
Cabeçalho e corpo
Insira o cabeçalho e o texto da mensagem. Você pode usar Liquid e outras formas de personalização. Mantenha os cabeçalhos e o conteúdo da mensagem claros e concisos.
Alguns tipos de mensagem não precisam de cabeçalho e, por isso, não solicitam um.
Gerar texto com IA
Para gerar o texto da mensagem, use o assistente de copywriting com IA.
Criar mensagens da direita para a esquerda
Para idiomas como árabe e hebraico, consulte Criar mensagens da direita para a esquerda.
Texto do botão
Quando disponível para o seu tipo de mensagem, você pode exibir até dois botões abaixo do corpo do texto. É possível criar e editar o texto e a cor dos botões. Você também pode adicionar um link para os Termos de Serviço em formulários de captura de e-mail.
Se você usar apenas um botão, ele se ajusta automaticamente para ocupar o espaço disponível na parte inferior da mensagem, em vez de deixar espaço para um botão adicional.
Escolher um botão principal
Use o Botão 2 para a chamada para ação principal. Dê a ele uma cor contrastante para que se destaque do restante da mensagem.
Comportamento ao clicar
Quando um usuário seleciona um botão na sua mensagem no app, as seguintes ações podem estar disponíveis, dependendo da plataforma e da configuração do espaço de trabalho.
| Ação | Descrição |
|---|---|
| Fechar mensagem | Fecha a mensagem atual. |
| Abrir URL da web | Abre uma página da web. Você pode optar por abrir o URL dentro do app. |
| Fazer deep linking no aplicativo | Abre um conteúdo dentro do seu app. Para saber mais, consulte Deep linking para conteúdo no app. |
| Registrar evento personalizado | Registra um evento personalizado. |
| Registrar atributo personalizado | Define um atributo personalizado para o usuário atual. |
| Solicitar permissão push | Exibe o prompt nativo de permissão push. Para saber mais, consulte Primers de push. |
As opções Solicitar permissão push, Registrar evento personalizado e Registrar atributo personalizado exigem as seguintes versões mínimas do SDK:
Para combinar várias ações ou executar ações adicionais do SDK que não estão disponíveis no dashboard (como adicionar a um grupo de inscrições ou definir um tipo de inscrição de e-mail), você pode usar deep links de Ações do Braze.
Opções de dispositivos iOS
Para mensagens que incluem apps iOS, selecione Alterar para enviar para todos os dispositivos, todos os dispositivos iOS, somente iPads ou somente iPhones e iPod Touches.
Fechamento da mensagem
Escolha entre as seguintes opções:
- Dispensar automaticamente: Selecione por quantos segundos a mensagem permanece na tela, até 60 segundos.
- Aguardar o usuário dispensar: Mantém a mensagem aberta até que o usuário a dispense.
Dispensar uma mensagem registra uma impressão, mas não um clique. Para saber como os cliques são rastreados por ação do usuário, consulte Rastreamento de cliques.
Posição do slideup
Esta configuração se aplica somente ao tipo de mensagem slideup. Escolha se o slideup vai aparecer Da parte inferior da tela do app ou Da parte superior da tela do app.
HTML e ativos
Esta configuração se aplica somente ao tipo de mensagem com código personalizado. Copie e cole o HTML no espaço disponível e faça upload dos seus ativos usando um arquivo ZIP.
Placeholder do campo de captura de e-mail
Esta configuração se aplica somente ao tipo de mensagem de formulário de captura de e-mail. Insira um texto personalizado que vai aparecer como placeholder no campo de entrada de e-mail. O padrão é “Enter your email address”.
Design
Use a guia Design para ajustar a aparência visual de uma mensagem criada no editor tradicional. As configurações disponíveis dependem da plataforma, do tipo de mensagem e do layout.
| Configuração | O que controla |
|---|---|
| Perfil de cor | Aplica um perfil de cor reutilizável da galeria de modelos de mensagens no app. |
| Alinhamento do texto | Alinha o texto de cabeçalho e corpo compatíveis à esquerda, ao centro ou à direita. |
| Cabeçalho e texto | Define a cor e a opacidade do texto. |
| Botões | Define o fundo, texto, borda e opacidade de cada botão. |
| Cor de fundo | Define a cor e a opacidade do fundo da mensagem. |
| Sobreposição de tela | Define a cor e a opacidade ao redor de mensagens modais e em tela cheia. |
| Controle de fechar | Define a cor da seta ou de outro controle de fechamento. |
Sempre pré-visualize e teste sua mensagem antes de enviar.
Tipos de mensagem com código personalizado não incluem a guia Design. Adicione HTML, CSS, JavaScript e ativos na guia Compose. Para modelos CSS específicos para web, consulte Modal web com CSS.
Configurações adicionais
Pares de chave-valor
Você pode adicionar pares de chave-valor para enviar campos personalizados extras aos dispositivos dos usuários.
- No criador de mensagens, selecione a guia Configurações.
- Em Pares de chave-valor, selecione Adicionar novo par.
- Insira uma chave e um valor para cada par. Para adicionar outro par, selecione Adicionar novo par novamente.
Entrega e direcionamento
Escolha um gatilho de Campaign
Escolha uma ação que dispara a Campaign e, em seguida, defina o horário de início e, se quiser, o de término da Campaign.
Para disparar uma mensagem no app a partir de um evento personalizado, registre o evento pelo SDK.
As Campaigns de mensagens no app aceitam as seguintes ações-gatilho:
- Iniciar uma sessão no app ou no site
- Fazer uma compra
- Realizar um evento personalizado registrado pelo SDK
Para mensagens disparadas pelo servidor e mensagens locais, consulte Disparar mensagens no app.
Disparar mensagens offline
A Braze envia as mensagens elegíveis e seus gatilhos para o dispositivo do usuário. Depois que uma mensagem é armazenada em cache, ela pode ser exibida quando o gatilho ocorrer, mesmo com o dispositivo offline.
Depois que uma Campaign de mensagem no app é interrompida, os usuários que iniciaram uma sessão antes da interrupção ainda podem ver a mensagem em cache ao realizar o evento-gatilho. Esses usuários contam como impressões únicas.
Escolha uma prioridade
Defina a ordem em que as mensagens no app elegíveis são exibidas quando várias mensagens compartilham o mesmo gatilho. As Campaigns e as etapas de Mensagem do Canvas usam a mesma ordem de prioridade.
Você pode escolher entre as seguintes prioridades de mensagem:
- Prioridade alta (exibida antes das outras mensagens)
- Prioridade média (padrão)
- Prioridade baixa (exibida depois das outras mensagens)
As opções alta, média e baixa são grupos de prioridade. Mensagens novas ou recém-atribuídas recebem a posição mais alta dentro do seu grupo, a menos que você defina uma prioridade exata.
Selecione Definir prioridade exata para arrastar Campaigns e Canvas para uma ordem específica. Você também pode fixar uma mensagem para mantê-la no topo do grupo de prioridade alta.
Escolha os usuários a serem direcionados
Use Segments e filtros para direcionar usuários. A Braze calcula a associação exata ao Segment antes de enviar a mensagem para o dispositivo.
Se uma etapa de mensagem no app tiver uma postergação, a Braze avalia a associação ao Segment depois da postergação. Se o usuário for elegível, a mensagem é sincronizada na próxima sessão disponível.
Reavaliar a elegibilidade da Campaign e o Liquid
Para Campaigns, selecione Reavaliar a elegibilidade da campanha antes de exibir quando a elegibilidade depender de atributos que mudam com frequência ou quando a mensagem precisar de dados de perfil atualizados.
Quando você seleciona essa opção, o SDK faz uma solicitação adicional para confirmar que o usuário ainda é elegível. A Braze também avalia o Liquid e o Connected Content imediatamente antes de exibir a mensagem.
Essa opção impede que mensagens em cache sejam exibidas quando o usuário não atende mais aos critérios de elegibilidade da Campaign.
Essa opção exige conexão de rede e adiciona uma solicitação antes da exibição. Não a use para mensagens que precisam ser disparadas enquanto o usuário está offline.
Usar dados adicionados pela REST API em uma mensagem
Os dados de usuário que o endpoint /users/track adiciona na mesma sessão às vezes podem ser usados na mensagem no app desse usuário. Por exemplo, se um usuário está no público de uma mensagem no app que aguarda um gatilho, inicia uma sessão e, nessa mesma sessão, a REST API atualiza o perfil dele, esses novos dados podem aparecer na mensagem no app quando Reavaliar a elegibilidade da campanha antes de exibir estiver selecionado. A Braze só aplica o modelo à mensagem no app quando chega a hora de renderizá-la.
Se um único gatilho envia dados para a Braze e também dispara a mensagem no app, a mensagem não consegue usar esses dados de perfil recém-atualizados, mesmo com uma postergação programada. Nesse caso, use dois gatilhos separados: um para enviar os dados e outro para disparar a mensagem no app.
Configurar os controles de mensagem do Canvas
As mensagens no app do Canvas incluem controles de expiração, ações-gatilho e uma postergação de até duas horas. Para saber mais, consulte Mensagens no app no Canvas.
Informações importantes
Capacidade de Campaigns ativas de mensagens no app
Para manter o desempenho da entrega de mensagens, interrompa as Campaigns de mensagens no app baseadas em ação que não forem mais necessárias.
A capacidade padrão é de 200 Campaigns de mensagens no app ativas e baseadas em ação por espaço de trabalho. Seu espaço de trabalho pode ter uma capacidade diferente. Isso não se aplica a Canvas.
A contagem inclui Campaigns ativas que ainda não atingiram o horário de término e Campaigns sem horário de término. Ela exclui Campaigns que já passaram do horário de término, atingiram o número máximo de impressões ou não estão mais ativadas.
Avaliação da entrega no horário local
Quando uma Campaign de mensagem no app usa o fuso horário local do usuário, a Braze avalia o horário de início e de término da Campaign nesse fuso horário. Uma mensagem armazenada em cache só é exibida quando o usuário é elegível e o gatilho ocorre dentro da janela de entrega configurada.
Próximas etapas
Depois de criar sua mensagem no app, continue construindo e validando a Campaign ou o Canvas:
- Configure o Canvas ou finalize o agendamento da sua Campaign
- Defina os usuários-alvo e configure os eventos de conversão
- Faça a prévia e teste a mensagem
- Confira os relatórios de mensagens no app