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 agendamento de etapa e especifique uma postergação conforme necessário. Observe 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 a postergação, 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: Especifique as 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 obtido seu 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 da mensagem |
|---|---|
| Apps móveis | SDKs iOS, Android e Vega |
| Navegadores web | SDK Web |
| Apps móveis e navegadores web | SDKs iOS, Android, Vega e Web |
Etapa 3: Especifique seus 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 de 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 ocupará e o quão disruptiva ela pode parecer para a experiência do usuário.
- Mensagens slideup são as menos intrusivas, aparecendo sutilmente sem bloquear o conteúdo.
- Mensagens modal ficam no meio-termo — proeminentes o suficiente para chamar a atenção sem tomar conta totalmente da tela.
- Mensagens em tela cheia 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 seu conteúdo, mais espaço você precisará — e maior a probabilidade de sua 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 |
|---|---|---|---|---|
| Tela cheia | Mensagens que cobrem toda a tela 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 suas campanhas 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 toda a tela 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 visualização 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 "dentro da marca". Você pode alterar cada detalhe da mensagem — fonte, cor, forma, 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 visualizador. | N/D | É necessário definir a opção de inicialização allowUserSuppliedJavascript como true para que sua mensagem no app funcione. |
Quando solicitar que os usuários enviem seu endereço de e-mail. |
| Modal web com CSS | Mensagens modais para web com CSS personalizável. |
|
Modal web com CSS é exclusivo do SDK Web e só pode ser usado após selecionar Web Browsers. | Quando você deseja fazer upload ou escrever CSS personalizado para criar mensagens bonitas e totalmente estilizadas. |
Se a Braze detectar que você não incluiu um botão de fechar ou dispensar no seu código, solicitaremos que você adicione um. Para sua conveniência, fornecemos um trecho que você pode copiar e colar no seu código: <a href= "appboy://close">X</a>.
Etapa 4: Redija sua mensagem no app
A guia Compose permite que você edite todos os aspectos do conteúdo e comportamento da sua mensagem.
O conteúdo da guia Compose varia com base nas 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 seus idiomas antes de escrever o conteúdo para que você possa preencher o texto nos locais corretos no Liquid. Consulte nossa lista completa de idiomas disponíveis.
Imagem
Dependendo do tipo de mensagem, você pode Upload Image, Pick a Badge ou usar Font Awesome. Para fazer upload de uma imagem, selecione Add Image ou forneça uma URL de imagem. Selecionar Add Image abre a Biblioteca de mídia, onde você pode selecionar uma imagem carregada anteriormente ou adicionar uma nova. Cada tipo de mensagem e plataforma pode ter suas próprias proporções e requisitos sugeridos — certifique-se de verificar quais são antes de encomendar ou criar 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 texto totalmente personalizado (frequentemente com recursos de HTML personalizado) com as opções de incluir Liquid e outros tipos de personalização. Quanto mais rápido você conseguir transmitir sua mensagem e fazer seu cliente clicar, melhor! Recomendamos cabeçalhos e conteúdo de mensagem claros e concisos.
Alguns tipos de mensagem não precisam e, portanto, não solicitam cabeçalhos.
Dicas
Gerando texto 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á um texto de marketing semelhante ao humano para uso no seu envio de mensagens.
Criando mensagens da direita para a esquerda
Precisa de ajuda para criar mensagens da direita para a esquerda para idiomas como árabe e hebraico? Consulte Criando mensagens da direita para a esquerda para melhores práticas.
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. Você pode criar e editar texto e cor personalizados para os botões. Também é possível adicionar um link de Termos de Serviço em 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 sua 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 esteja à direita. O botão da direita frequentemente demonstra melhor potencial de ser clicado, especialmente se tiver uma cor um pouco contrastante ou que se destaque do restante da mensagem. Isso é ainda mais evidente quando o botão da esquerda se mistura mais visualmente com a mensagem.
Comportamento ao clicar
Quando seu 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 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 envio de 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. Leia mais sobre push priming, bem como melhores práticas para preparar os usuários para push. |
Observação: as opções Solicitar permissão de push, Registrar evento personalizado e Registrar atributo personalizado requerem as seguintes versões mínimas do SDK:
Opções de dispositivos iOS
Se desejar, você pode restringir sua mensagem no app para enviar apenas para dispositivos iOS. Para isso, clique em Change e selecione Only send to iOS devices.
Fechamento da mensagem
Escolha entre as seguintes opções:
- Dismiss Automatically: Selecione quantos segundos a mensagem permanecerá na tela.
- Wait for User Swipe or Touch: Requer uma opção de dispensar ou fechar.
Posição do slideup
Essa configuração se aplica apenas ao tipo de mensagem slideup. Escolha entre fazer seu slideup aparecer From Bottom of App Screen ou From Top of App Screen.
HTML e ativos
Essa configuração se aplica apenas ao tipo de mensagem de código personalizado. Copie e cole HTML no espaço disponível e faça upload dos seus ativos usando um arquivo ZIP.
Placeholder de entrada 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 texto de 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: Configure definições adicionais (opcional)
Pares chave-valor
Você pode adicionar pares chave-valor para enviar campos personalizados extras para os dispositivos dos usuários.
Etapa 7: Construa o restante da sua campanha ou Canvas
Construa o restante da sua campanha; consulte as seções a seguir para mais orientações sobre como usar melhor nossas ferramentas para criar mensagens no app.
Escolha um gatilho
Selecione a ação que você deseja que dispare sua mensagem, bem como os horários de início e término da sua campanha ou Canvas.
Observe que, 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 é inteiramente baseada nos seguintes gatilhos de ação:
- Realizar uma compra
- Abrir o app/página 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 relação ao horário local de cada um dos seus usuários.
- As mensagens também podem ser configuradas para recorrer diariamente, semanalmente (opcionalmente em dias específicos) ou mensalmente.
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 apareça 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
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, posteriormente, realizarem o evento de 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, mensagens de alta prioridade serão agendadas para aparecer nos dispositivos dos usuários antes de 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 agrupamentos, e como tal, múltiplas mensagens podem ter a mesma prioridade selecionada. Quando múltiplas mensagens compartilham a mesma prioridade, a mensagem criada ou atribuída mais recentemente tem precedência e é exibida primeiro:
- Agrupamento 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.
- Agrupamento de prioridade específica: Quando múltiplas campanhas compartilham o mesmo gatilho e são atribuídas a um agrupamento de prioridade específico, a campanha atribuída mais recentemente a esse agrupamento recebe o gatilho.
Para definir prioridades dentro desses agrupamentos, clique em Set Exact Priority, e você pode arrastar e soltar campanhas para ordená-las com a prioridade correta.
Escolha os usuários-alvo
Em seguida, você deve direcionar os usuários escolhendo Segments ou filtros para restringir seu público. Você recebe automaticamente um snapshot de como é a população aproximada desse Segment. Tenha em mente que a associação exata ao Segment é sempre calculada antes de a mensagem ser enviada.
Se houver uma postergação na etapa de mensagem no app, a associação ao Segment 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 elegibilidade da campanha e 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 frequentemente 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 esta mensagem antes de enviá-la. Além disso, quaisquer variáveis Liquid ou Conteúdo conectado serão processadas naquele 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.
Habilitar 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 está aguardando 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é que seja hora 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. 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 de Canvas. Para mais detalhes sobre como construir o restante do seu Canvas, implementar testes multivariantes e Seleção inteligente, e mais, consulte a etapa Construa 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: Revise e implante
Depois de terminar de construir a última parte da sua campanha ou Canvas, revise seus detalhes, teste-a e depois envie!
Em seguida, confira Relatórios de mensagens no app para saber como você pode acessar os resultados das suas campanhas de envio 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 não estão mais enviando mensagens ou não são mais necessárias, desacelera o desempenho geral dos serviços da Braze para você e outros clientes. Esse tempo extra necessário para processar esses grandes números de campanhas inativas significa que quaisquer mensagens no app levarão mais tempo 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 possuem horário de término. Campanhas ativas de mensagens no app que já passaram do horário de término não serão contadas. O cliente médio da Braze tem um total de 26 campanhas ativas ao mesmo tempo — portanto, é improvável que essa limitação afete você.
Avaliação de entrega no horário local
Quando uma campanha de mensagem no app é agendada usando o fuso horário local do usuário, a avaliação dos horários de início e término da campanha é feita no próprio dispositivo.
Campanhas de mensagens no app são normalmente enviadas para o dispositivo do usuário quando a sessão do app inicia 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 de gatilho do usuário ocorreu dentro do horário de início e término da campanha (conforme definido pelo fuso horário 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 disparar um evento (como um toque em 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 — assumindo que todos os critérios de elegibilidade ainda sejam atendidos.
- Semelhante a outros tipos de canal, campanhas de mensagens no app devem idealmente ser lançadas com 24 a 48 horas de antecedência. Esse intervalo 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.