Criar uma mensagem no app com o editor tradicional
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 fortemente que você planeje suas mensagens e prepare todos os materiais com antecedência usando nosso prático Guia de preparação de mensagens no app.
Etapa 1: Escolha onde criar sua mensagem
Não tem certeza se sua mensagem deve ser enviada usando uma Campaign ou um Canvas? Campaigns são melhores para campanhas de mensagens únicas e direcionadas, enquanto Canvas são melhores para jornadas de usuários com várias etapas.
- Acesse Messaging > Campaigns e selecione Create Campaign.
- Selecione In-App Message. Observe que mensagens no app não estão disponíveis em campanhas multicanal.
- Dê à sua campanha um nome claro e significativo.
- Adicione Equipes e Tags conforme necessário.
- Tags facilitam a busca e a criação de relatórios das suas campanhas. 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 campanha. Você pode escolher diferentes plataformas, tipos de mensagem e layouts para cada variante adicionada. Para saber mais sobre esse tópico, consulte Testes multivariantes e A/B.
Se todas as mensagens da sua campanha forem semelhantes ou tiverem o mesmo conteúdo, redija sua mensagem antes de adicionar variantes extras. Em seguida, escolha Copy from Variant no menu suspenso Add Variant.
- 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 múltiplas variantes de mensagem no app em uma única etapa.
Você pode encontrar mais informações específicas sobre Canvas em Mensagens no app no Canvas.
Etapa 2: Especificar plataformas de entrega
Comece escolhendo quais plataformas devem receber a mensagem. Use essa seleção para limitar a entrega de uma campanha a um conjunto específico de apps. Por exemplo, você pode escolher Web Browsers para uma mensagem no navegador incentivando os usuários a baixar seu app móvel, garantindo que eles não recebam a mensagem depois de já terem baixado o app. Como as seleções de plataforma são específicas para cada variante, você pode testar o engajamento com mensagem por plataforma.
| Plataforma | Entrega de mensagem |
|---|---|
| Mobile Apps | SDKs para iOS, Android e Vega |
| Web Browsers | SDK para web |
| Both Mobile Apps & Web Browsers | SDKs para iOS, Android, Vega e web |
Etapa 3: Especifique os tipos de mensagem
Depois de selecionar uma plataforma de envio, navegue pelos tipos de mensagem, layouts e outras opções associadas a ela. Saiba mais sobre o comportamento esperado e a aparência de cada uma dessas mensagens na nossa página Tipos de mensagem, ou clicando nos tipos de mensagem vinculados nas tabelas a seguir.
Ao decidir qual tipo de mensagem usar, considere quanto espaço sua mensagem vai ocupar e o quanto ela pode ser disruptiva para a experiência do usuário.
- Mensagens slideup são as menos intrusivas, aparecendo de forma sutil sem bloquear o conteúdo.
- Mensagens modal ficam no meio-termo — proeminentes o suficiente para chamar a atenção sem tomar conta da tela inteira.
- Mensagens fullscreen são as que mais chamam a atenção e são ideais para anúncios críticos ou promoções.
Quanto mais complexo for o seu conteúdo, mais espaço você vai precisar — e maior a chance de a mensagem interromper o fluxo do usuário.
Tipos de mensagem
Essas mensagens no app são aceitas tanto por apps móveis quanto por aplicações web.
| Tipo de mensagem | Descrição do tipo | Layouts disponíveis | Outras opções | Uso recomendado |
|---|---|---|---|---|
| Fullscreen | Mensagens que cobrem a tela inteira com um bloco de mensagem. |
|
Orientação do dispositivo forçada (retrato ou paisagem) | Grande e impactante! Use quando quiser garantir que os usuários vejam seu conteúdo, como nas Campaigns mais importantes, notificações essenciais ou grandes promoções. Observe que em dispositivos móveis, mensagens em retrato e paisagem não serão exibidas se a orientação do dispositivo não corresponder à orientação da mensagem. |
| Modal | Mensagens que cobrem a tela inteira com uma sobreposição e um bloco de mensagem. |
|
N/D | Um bom meio-termo. Use quando precisar de uma forma evidente de chamar a atenção do usuário, como incentivar os usuários a experimentar um novo recurso ou aproveitar uma promoção. |
| Slideup | Mensagens que deslizam para a tela em um local designado sem bloquear o restante da tela. | N/D | N/D | Discreta — ocupa a menor quantidade de espaço na tela. Use para alertar os usuários sobre pequenas informações, como novos recursos, anúncios, uso de cookies, etc. |
Tipos de mensagem avançados
Essas mensagens no app são personalizáveis de acordo com suas necessidades.
| Tipo de mensagem | Descrição do tipo | Layouts disponíveis | Requisitos | Uso recomendado |
|---|---|---|---|---|
| Mensagem HTML personalizada | Mensagens personalizadas que funcionam conforme definido no seu código personalizado (HTML, CSS e/ou JavaScript). | N/D | É necessário definir a opção de inicialização allowUserSuppliedJavascript como true para que sua mensagem no app funcione. |
Essa é uma boa opção se você quer todas as vantagens das mensagens no app, mas precisa de funcionalidades adicionais ou que a aparência permaneça alinhada com a identidade da marca. Você pode alterar cada detalhe da mensagem — fonte, cor, formato, tamanho, botões, etc. Exemplos de casos de uso incluem pedir feedback sobre o app, formulários de captura de e-mail ou mensagens paginadas |
| Formulário de captura de e-mail | Normalmente usado para capturar o e-mail do visitante. | N/D | É necessário definir a opção de inicialização allowUserSuppliedJavascript como true para que sua mensagem no app funcione. |
Quando quiser solicitar que os usuários enviem seu endereço de e-mail. |
| Modal web com CSS | Mensagens modal para web com CSS personalizável. |
|
O modal web com CSS é exclusivo do Web SDK e só pode ser usado após selecionar Web Browsers. | Quando você quiser fazer upload ou escrever CSS personalizado para criar mensagens com estilo totalmente personalizado e visualmente atraentes. |
Se a Braze detectar que você não incluiu um botão de fechar ou dispensar no seu código, vamos solicitar que você adicione um. Para sua conveniência, fornecemos um snippet que você pode copiar e colar no seu código: <a href= "appboy://close">X</a>.
Etapa 4: Crie sua mensagem no app
A guia Criar permite editar todos os aspectos do conteúdo e do comportamento da sua mensagem.
O conteúdo da guia Criar varia de acordo com as opções de mensagem escolhidas na etapa anterior, mas pode incluir qualquer uma das seguintes opções:
Idioma
Selecione Add Languages e escolha os idiomas desejados na lista fornecida. Isso inserirá Liquid na sua mensagem. Recomendamos selecionar os idiomas antes de escrever o conteúdo para que você possa preencher o texto no local correto dentro do Liquid. Consulte nossa lista completa de idiomas disponíveis.
Imagem
Dependendo do tipo de mensagem, você pode Fazer upload de imagem, Escolher um badge ou usar Font Awesome. Para fazer upload de uma imagem, selecione Add Image ou forneça uma URL de imagem. Ao selecionar Add Image, a Biblioteca de mídia será aberta, onde você pode selecionar uma imagem já carregada ou adicionar uma nova. Cada tipo de mensagem e plataforma pode ter suas próprias proporções e requisitos sugeridos — verifique quais são antes de criar ou produzir uma imagem do zero.
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
Escreva o que quiser! Inclua textos totalmente personalizados (geralmente com recursos de HTML personalizado) com opções para incluir Liquid e outros tipos de personalização. Quanto mais rápido você conseguir transmitir sua mensagem e fazer o cliente clicar, melhor! Recomendamos cabeçalhos e conteúdos de mensagem claros e concisos.
Alguns tipos de mensagem não precisam de cabeçalhos e, portanto, não os solicitam.
Dicas
Gerando textos com IA
Precisa de ajuda para criar textos incríveis? Experimente usar o Assistente de Copywriting com IA. Insira o nome ou a descrição de um produto e a IA gerará textos de marketing semelhantes aos escritos por humanos para uso nas suas mensagens.
Criando mensagens da direita para a esquerda
Precisa de ajuda para criar mensagens da direita para a esquerda em idiomas como árabe e hebraico? Consulte Criando mensagens da direita para a esquerda para conhecer as práticas recomendadas.
Texto do botão
Quando disponível para o seu tipo de mensagem, você pode ter até dois botões exibidos abaixo do corpo do texto. É possível criar e editar texto e cor personalizados para os botões. Você também pode adicionar um link de Termos de Serviço nos formulários de captura de e-mail.
Se você optar por usar apenas um botão, ele se ajustará automaticamente para ocupar o espaço disponível na parte inferior da mensagem, em vez de deixar espaço para um botão adicional.
Escolhendo um botão principal
Se você decidir formatar esses botões com suas próprias cores, recomendamos usar o Botão 2 para o resultado que você mais deseja.
Em outras palavras, se você quer que o usuário clique em um botão mais do que no outro, certifique-se de que ele seja o botão secundário. O botão secundário geralmente apresenta maior potencial de cliques, especialmente se tiver uma cor que contraste ou se destaque em relação ao restante da mensagem. Isso é ainda mais evidente quando o botão principal se mistura visualmente com a mensagem.
Comportamento ao clicar
Quando o cliente clica em um botão na sua mensagem no app, as seguintes ações estão disponíveis.
| Ação | Descrição |
|---|---|
| Redirecionar para URL da web | Abre uma página da web não nativa. |
| Deep link para o app | Faz deep link para uma tela existente no seu app. |
| Fechar mensagem | Fecha a mensagem ativa no momento. |
| Registrar evento personalizado | Escolha um evento personalizado para disparar. Pode ser usado para exibir outra mensagem no app ou disparar mensagens adicionais. |
| Registrar atributo personalizado | Escolha um atributo personalizado para definir para o usuário atual. |
| Solicitar permissão de push | Exibe a solicitação nativa de permissão de push. Saiba mais sobre push priming, bem como as práticas recomendadas para preparar os usuários para push. |
Nota: as opções Solicitar permissão de 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 Braze Actions.
Opções de dispositivos iOS
Se desejar, você pode restringir sua mensagem no app para envio apenas a dispositivos iOS. Para isso, clique em Change e selecione Only send to iOS devices.
Fechamento da mensagem
Escolha entre as seguintes opções:
- Dispensar automaticamente: Selecione por quantos segundos a mensagem permanecerá na tela.
- Aguardar deslize ou toque do usuário: Requer uma opção de dispensa ou fechamento.
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
Essa configuração se aplica apenas ao tipo de mensagem slideup. Escolha entre exibir o slideup Na parte inferior da tela do app ou Na parte superior da tela do app.
HTML e ativos
Essa configuração se aplica apenas ao tipo de mensagem de 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
Essa configuração se aplica apenas ao tipo de mensagem de formulário de captura de e-mail. Insira um texto personalizado que aparecerá como placeholder no campo de entrada de e-mail. O padrão é “Enter your email address”.
Etapa 5: Estilize sua mensagem no app
A guia Style permite que você ajuste todos os aspectos visuais da sua mensagem. Faça upload de uma imagem ou badge, ou escolha um ícone de badge pré-projetado. Altere as cores do texto do cabeçalho e do corpo, botões e fundo selecionando de uma paleta ou inserindo um código hex, RGB ou HSB.
O conteúdo da guia Style varia com base nas opções de mensagem escolhidas na etapa anterior, mas pode incluir qualquer uma das seguintes opções:
| Formatação | Entrada | Descrição |
|---|---|---|
| Perfil de cor | Aplicar a partir da galeria de modelos de mensagens no app. | Selecione Apply Template e escolha na galeria. Em seguida, selecione Save. |
| Alinhamento do texto | Esquerda, centro ou direita. | Disponível apenas para versões mais recentes do SDK da Braze. |
| Cabeçalho | Código de cor HEX. | A cor HEX desejada será exibida. Você também poderá escolher a opacidade da cor. |
| Texto | Código de cor HEX. | A cor HEX desejada será exibida. Você também poderá escolher a opacidade da cor. |
| Botões | Código de cor HEX. | As cores HEX desejadas serão exibidas. Você também poderá escolher a opacidade das cores. Você pode escolher cores para: o fundo do botão de fechar da mensagem, bem como o fundo, texto e borda de cada botão. |
| Borda do botão | Código de cor HEX. | Novo! Isso permitirá que você diferencie seus botões principal e secundário. Sugerimos contornar os botões com cores contrastantes. |
| Cor de fundo | Código de cor HEX. | A cor HEX desejada será exibida. Você também poderá escolher a opacidade da cor. Este é o fundo de toda a mensagem e será exibido claramente atrás do corpo do texto. |
| Sobreposição de tela | Código de cor HEX. | A cor HEX desejada será exibida. Você também poderá escolher a opacidade da cor. Disponível apenas para versões mais recentes do SDK da Braze. Este é o quadro ao redor de toda a mensagem. |
| Seta ou outra opção de fechar mensagem | Código de cor HEX. | A cor HEX desejada será exibida. Você também poderá escolher a opacidade da cor. |
Sempre pré-visualize e teste sua mensagem antes de enviar.
Alguns tipos de mensagem no app não possuem a opção de estilização além do upload de HTML personalizado (ou CSS ou JavaScript) e ativos usando um arquivo ZIP. Modal web com CSS permite que você faça upload ou escreva CSS personalizado para criar mensagens bonitas e totalmente estilizadas.
Etapa 6: Configurar definições adicionais (opcional)
Pares chave-valor
Você pode adicionar pares chave-valor para enviar campos personalizados extras aos dispositivos dos usuários.
Etapa 7: Crie o restante da sua campanha ou Canvas
Crie o restante da sua campanha; consulte as seções a seguir para mais orientações sobre como usar nossas ferramentas para criar mensagens no app.
Escolha um gatilho
Selecione a ação que você deseja usar como gatilho para a sua mensagem, bem como os horários de início e término da sua campanha ou Canvas.
Se você pretende disparar sua mensagem no app com base em um evento personalizado, esse evento personalizado deve ser enviado usando o SDK.
A entrega de mensagens no app é totalmente baseada nos seguintes gatilhos de ação:
- Fazer um pedido
- Abrir o app ou a página da web
- Realizar um evento personalizado (funciona apenas com eventos enviados usando o SDK)
- Abrir uma mensagem push específica
- Agendar automaticamente campanhas para envio em um determinado horário com base no fuso local de cada usuário.
- As mensagens também podem ser configuradas para recorrência diária, semanal (opcionalmente em dias específicos) ou mensal.
Uma data e hora de início devem ser selecionadas; no entanto, uma data de término é opcional. Uma data de término impedirá que essa mensagem no app específica seja exibida nos dispositivos após a data/hora especificada.
Consulte nossa documentação para desenvolvedores sobre disparo de eventos no servidor e entrega local de mensagens no app.
Disparo online versus offline
As mensagens no app funcionam enviando a mensagem e os gatilhos para o dispositivo do usuário. Depois que as mensagens no app estão no dispositivo, elas aguardam para serem exibidas até que a condição de gatilho seja atendida. Se as mensagens no app já estiverem em cache no dispositivo do usuário, você pode até disparar mensagens no app offline, sem conexão com a Braze (por exemplo, no modo avião).
Depois que uma mensagem no app for interrompida, pode haver alguns usuários que continuem a ver a mensagem se iniciaram uma sessão antes de a mensagem ser interrompida e, em seguida, realizarem o evento-gatilho. Esses usuários serão contados como uma impressão única mesmo após a campanha ter sido interrompida.
Escolha uma prioridade
Por fim, depois de selecionar a ação que disparará a mensagem no app, você também deve definir uma prioridade. Se duas mensagens forem disparadas pela mesma ação, as mensagens de alta prioridade serão agendadas para aparecer nos dispositivos dos usuários antes das mensagens com prioridades mais baixas.
Você pode escolher entre as seguintes prioridades de mensagem:
- Alta prioridade (exibida antes de outras mensagens)
- Prioridade média (padrão)
- Baixa prioridade (exibida após outras mensagens)
As opções de alta, média e baixa prioridade para mensagens disparadas são agrupadas em categorias e, portanto, várias mensagens podem ter a mesma prioridade selecionada. Quando várias mensagens compartilham a mesma prioridade, a mensagem criada ou atribuída mais recentemente tem precedência e é exibida primeiro:
- Categoria de prioridade padrão: quando duas campanhas compartilham o mesmo gatilho e usam a prioridade padrão (média), a campanha criada por último recebe o gatilho.
- Categoria de prioridade específica: quando várias campanhas compartilham o mesmo gatilho e são atribuídas a uma categoria de prioridade específica, a campanha atribuída mais recentemente a essa categoria recebe o gatilho.
Para definir prioridades dentro dessas categorias, clique em Set exact priority e arraste e solte as campanhas para ordená-las com a prioridade correta.
Escolha os usuários-alvo
Em seguida, você deve direcionar os usuários escolhendo segmentos ou filtros para restringir seu público. Você recebe automaticamente um snapshot de como é a população aproximada desse segmento. Lembre-se de que a associação exata ao segmento é sempre calculada antes do envio da mensagem.
Se houver uma postergação na etapa de mensagem no app, a associação ao segmento será avaliada após a postergação. Se o usuário for elegível, a mensagem no app será sincronizada na próxima sessão disponível.
Reavaliar a elegibilidade da campanha e o Liquid
Em alguns cenários, você pode querer reavaliar a elegibilidade de um usuário quando ele dispara uma mensagem no app para exibição. Exemplos incluem campanhas que direcionam um atributo personalizado que muda com frequência ou mensagens que devem refletir quaisquer alterações de perfil de última hora.
Quando você seleciona Re-evaluate campaign eligibility before displaying, uma solicitação adicional à Braze será feita para confirmar que o usuário ainda é elegível para essa mensagem antes do envio. Além disso, quaisquer variáveis Liquid ou Connected Content serão processadas nesse momento, antes de a mensagem ser exibida.
Isso evita que mensagens no app sejam enviadas a usuários em campanhas expiradas ou arquivadas. Se você não reavaliar a elegibilidade de um usuário, ele receberá a mensagem no app mesmo após a campanha ter expirado ou sido arquivada, porque a mensagem está no seu SDK e aguardando que os usuários a disparem.
Ativar essa opção resultará em um leve atraso (< 100ms) entre o momento em que um usuário dispara uma mensagem no app e o momento em que a mensagem é exibida, devido à solicitação adicional de elegibilidade e processamento de template.
Não use essa opção para mensagens que podem ser disparadas enquanto o usuário está offline ou quando a reavaliação de elegibilidade e Liquid não é necessária.
Usar dados adicionados pela REST API em uma mensagem
Dados de usuário que o endpoint /users/track adiciona na mesma sessão podem, às vezes, 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 seu perfil, esses novos dados podem aparecer na mensagem no app quando Re-evaluate campaign eligibility before displaying estiver selecionado. A Braze não processará o template da mensagem no app até o momento de renderizá-la.
Se um gatilho envia dados para a Braze e dispara a mensagem no app ao mesmo tempo, a mensagem não pode usar esses dados de perfil recém-atualizados, mesmo com uma postergação agendada. Em vez disso, use dois gatilhos separados: um para enviar os dados e outro para disparar a mensagem no app.
Escolha eventos de conversão
A Braze permite que você rastreie com que frequência os usuários realizam ações específicas, eventos de conversão, após receberem uma campanha. Você tem a opção de permitir uma janela de até 30 dias durante a qual uma conversão será contada se o usuário realizar a ação especificada.
Se ainda não o fez, conclua as seções restantes do seu componente Canvas. Para mais detalhes sobre como construir o restante do seu Canvas, implementar testes multivariantes e seleção inteligente, e mais, consulte a etapa Crie seu Canvas da nossa documentação de Canvas.
Para informações sobre opções de mensagens no app específicas do Canvas, consulte Mensagens no app no Canvas.
Etapa 8: Revisar e implantar
Depois de terminar de criar a última parte da sua Campaign ou Canvas, revise os detalhes, teste-a e envie!
Em seguida, confira Relatórios de mensagens no app para saber como acessar os resultados das suas campanhas de mensagens.
Informações importantes
Limites de campanhas ativas de mensagens no app
A Braze valoriza confiabilidade e velocidade. Sugerimos que você envie apenas os dados necessários para a Braze e desative quaisquer campanhas que não agreguem mais valor à sua marca.
O processamento de campanhas de mensagens no app baseadas em ação que ainda estão em estado ativo, mas que não estão mais enviando mensagens ou não são mais necessárias, reduz o desempenho geral dos serviços da Braze para você e para outros clientes. Esse tempo extra necessário para processar esse grande número de campanhas sem atividades faz com que as mensagens no app demorem mais para aparecer nos dispositivos dos usuários finais, o que impacta a experiência do usuário final.
Você pode ter até 200 campanhas ativas de mensagens no app baseadas em ação por espaço de trabalho para otimizar a velocidade de entrega de mensagens e evitar timeouts. Isso não se aplica a Canvas.
A contagem de 200 inclui campanhas ativas de mensagens no app que ainda não atingiram o horário de término e aquelas que não têm horário de término. Campanhas ativas de mensagens no app que já passaram do horário de término não serão contabilizadas. O cliente médio da Braze tem um total de 26 campanhas ativas ao mesmo tempo — então é improvável que essa limitação afete você.
Avaliação de entrega no horário local
Quando uma campanha de mensagens no app é agendada usando o fuso local do usuário, a avaliação do horário de início e término da campanha é feita no próprio dispositivo.
As campanhas de mensagens no app geralmente são enviadas ao dispositivo do usuário quando a sessão do app é iniciada ou atualizada. Nesse momento:
- O SDK avalia se o usuário se qualifica para quaisquer mensagens no app baseadas em gatilho.
- O dispositivo verifica se o evento-gatilho do usuário ocorreu dentro do horário de início e término da campanha (conforme definido pelo fuso local do usuário).
- Se ambas as condições forem atendidas, a mensagem no app estará elegível para exibição.
Considerações
- Se um usuário dispara um evento (como o toque em um botão) logo após a mensagem no app ser entregue, a mensagem pode não aparecer até a próxima atualização de sessão — desde que todos os critérios de elegibilidade ainda sejam atendidos.
- Assim como outros tipos de canal, as campanhas de mensagens no app devem idealmente ser lançadas com 24 a 48 horas de antecedência. Essa margem dá aos usuários tempo suficiente para atender aos critérios de elegibilidade e iniciar uma sessão para que a mensagem seja avaliada e exibida.