Skip to content

Enviar mensagens de teste

Antes de enviar uma campanha de mensagens para seus usuários, como prática recomendada, sugerimos testar para garantir que tudo esteja correto e funcione conforme o esperado. Você pode criar e enviar mensagens de teste para dispositivos selecionados ou membros da equipe usando as ferramentas do dashboard da Braze.

Etapa 1: Identifique seus usuários de teste

Antes de testar sua campanha de mensagens, é importante identificar seus usuários de teste. Esses usuários podem ser IDs de usuário ou endereços de e-mail existentes, ou novos usuários usados exclusivamente para testar campanhas de mensagens.

Opcional: Crie um grupo de teste de conteúdo

Uma maneira conveniente de organizar seus usuários de teste é criando um grupo de teste de conteúdo, que inclui um grupo de usuários que receberão mensagens de teste de Campaigns. Você pode adicionar esse grupo de teste ao campo Add Content Test Groups em Test Recipients na sua Campaign e iniciar seus testes sem criar ou adicionar usuários de teste individuais.

Etapa 2: Envie mensagens de teste específicas por canal

Para ver as etapas de envio de mensagens de teste, consulte a seção a seguir para o respectivo canal.

Após criar sua mensagem de Banner, você pode pré-visualizar o Banner ou enviar uma mensagem de teste.

  1. Rascunhe sua mensagem de Banner.
  2. Selecione Preview para pré-visualizar seu Banner ou enviar uma mensagem de teste.
  3. Para enviar uma mensagem de teste, adicione um grupo de teste de conteúdo ou um ou mais usuários individuais como Test Recipients e selecione Send Test.

Você poderá visualizar sua mensagem de teste no dispositivo por até 5 minutos.

Guia de pré-visualização do criador de Banner.

Lista de verificação do teste

  • Sua Campaign de Banner está atribuída a um posicionamento?
  • As imagens e mídias aparecem e funcionam conforme o esperado nos tipos de dispositivos e tamanhos de tela direcionados?
  • Seus links e botões direcionam o usuário para onde deveriam?
  • O Liquid funciona conforme o esperado? Você considerou um valor de atributo padrão caso o Liquid não retorne nenhuma informação?
  • Seu texto está claro, conciso e correto?

Content Cards de teste são entregues por meio de uma notificação por push. O cartão é empacotado na carga útil do push, e o SDK o extrai e armazena em cache localmente quando o push é recebido.

Esse processo ignora o sistema normal de entrega de cartões, por isso o push deve estar ativado mesmo que você esteja testando um Content Card.

Content Cards de teste expiram aproximadamente cinco minutos após o envio.

Após criar seu Content Card, você pode enviar um Content Card de teste para o seu app e ver como ele ficará em tempo real.

  1. Rascunhe seu Content Card.
  2. Selecione a guia Test e selecione pelo menos um grupo de teste de conteúdo ou usuário individual para receber esta mensagem de teste.
  3. Selecione Send Test para enviar seu Content Card para o app.

Testar Content Card

Pré-visualização

Você pode pré-visualizar seu cartão enquanto o compõe na guia Preview. Isso deve ajudar a visualizar como sua mensagem final ficará da perspectiva do usuário.

Lista de verificação do teste

  • Seu usuário de teste está inscrito para push com um token de push válido?
  • As imagens e mídias aparecem e funcionam conforme o esperado?
  • O Liquid funciona conforme o esperado? Você considerou um valor de atributo padrão caso o Liquid não retorne nenhuma informação?
  • Seu texto está claro, conciso e correto?
  • Seus links direcionam o usuário para onde deveriam?
  • Seu usuário de teste está inscrito para push com um token de push válido?

Solução de problemas com imagens quebradas

Se a imagem de um Content Card não está sendo renderizada ou aparece quebrada:

  • Verifique se a URL está correta e codificada: Caracteres especiais na URL (como espaços ou parâmetros de consulta) devem ser codificados corretamente. Caso contrário, a solicitação da imagem falhará.
  • Verifique as políticas de segurança de conteúdo: Se sua organização possui uma política de segurança de conteúdo (CSP) ou regras internas de segurança de TI, a política pode bloquear o domínio da imagem. Confirme que o domínio da URL da imagem é permitido pela sua CSP.
  • Use HTTPS: As URLs de imagem devem usar https:// em vez de http:// para evitar bloqueio de conteúdo misto em navegadores e apps.
  • Abra a URL diretamente em um navegador: Se a imagem não carrega em um navegador, o problema está na URL da imagem ou na hospedagem — não na Braze.

Depuração

Após o envio dos seus Content Cards, você pode detalhar ou depurar quaisquer problemas a partir do Registro de usuários de eventos no Console de desenvolvedor.

Um caso de uso comum é tentar depurar por que um usuário não consegue ver um Content Card específico. Para isso, você pode verificar nos Registros de usuários de eventos os Content Cards entregues ao SDK no início da sessão, mas antes de uma impressão, e rastreá-los até uma Campaign específica:

  1. Acesse Settings > Event User Log.
  2. Localize e expanda a solicitação do SDK para seu usuário de teste.
  3. Clique em Raw Data.

  4. Encontre o id da sua sessão. Veja um exemplo de trecho a seguir:

    1
2
3
4
5
6
7
8
9
10
11
12

     [
   {
     "session_id": "D1B051E6-469B-47E2-B830-5A728D1D4AC5",
     "data": {
       "ids": [
         "NDg2MTY5MmUtNmZjZS00MjE1LWJkMDUtMzI1NGZiOWU5MDU3"
       ]
     },
     "name": "cci",
     "time": 1636106490.155
   }
 ]

  1. Use uma ferramenta de decodificação como Base64 Decode and Encode para decodificar o id do formato Base64 e encontrar o campaign_id associado. No nosso exemplo, o resultado é o seguinte:

    1

     4861692e-6fce-4215-bd05-3254fb9e9057_$_cc=c3b25740-f113-c047-4b1d-d296f280af4f&mv=6185005b9d9bee79387cce45&pi=cmp

    Onde 4861692e-6fce-4215-bd05-3254fb9e9057 é o campaign_id.

  2. Acesse a página Campaigns e pesquise pelo campaign_id.

Pesquisar campaign_id na página Campaigns

A partir daí, você pode revisar as configurações e o conteúdo da mensagem para investigar e determinar por que um usuário não consegue ver um Content Card específico.

Se você tem notificações por push configuradas no seu app e no seu dispositivo de teste, pode enviar mensagens de teste no app para ver como ficam em tempo real.

  1. Rascunhe sua mensagem no app.
  2. Selecione a guia Test e adicione seu endereço de e-mail ou ID de usuário no campo Add Individual Users.
  3. Selecione Send Test para enviar sua mensagem push para o dispositivo.

Uma mensagem push de teste aparecerá no topo da tela do seu dispositivo.

Testar mensagem no app

Ao clicar diretamente e abrir a mensagem push, você será direcionado ao seu app, onde poderá visualizar o teste da mensagem no app. Observe que esse recurso de teste de mensagem no app depende de o usuário clicar em uma notificação por push de teste para acionar a mensagem no app. Portanto, o usuário deve ser elegível para receber notificações por push no app relevante para a entrega bem-sucedida da notificação por push de teste.

Pré-visualização

Você pode pré-visualizar sua mensagem no app enquanto a compõe na guia Preview. Isso deve ajudar a visualizar como sua mensagem final ficará da perspectiva do usuário. Você pode pré-visualizar como sua mensagem ficará para um usuário aleatório, um usuário específico ou um usuário personalizado. Também é possível pré-visualizar mensagens para dispositivos móveis ou tablets.

Guia de composição ao criar uma mensagem no app mostrando a pré-visualização de como a mensagem ficará. Nenhum usuário está selecionado, então o Liquid adicionado na seção do corpo é exibido como está.

A Braze tem três gerações de mensagens no app disponíveis. Você pode ajustar para quais dispositivos suas mensagens devem ser enviadas, com base na geração que eles suportam.

Alternando entre gerações ao pré-visualizar uma mensagem no app.

Lista de verificação do teste

  • As imagens e mídias aparecem e funcionam conforme o esperado?
  • O Liquid funciona conforme o esperado? Você considerou um valor de atributo padrão caso o Liquid não retorne nenhuma informação?
  • Seu texto está claro, conciso e correto?
  • Seus botões direcionam o usuário para onde deveriam?

Scanner de acessibilidade

Para apoiar as melhores práticas de acessibilidade, a Braze verifica automaticamente o conteúdo de mensagens no app criadas usando o editor HTML tradicional em relação aos padrões de acessibilidade. Esse scanner ajuda a identificar conteúdo que pode não atender aos padrões das Diretrizes de Acessibilidade para Conteúdo Web (WCAG). WCAG é um conjunto de padrões técnicos reconhecidos internacionalmente, desenvolvidos pelo World Wide Web Consortium (W3C) para tornar o conteúdo web mais acessível a pessoas com deficiência.

Resultados do scanner de acessibilidade

Como funciona

O scanner é executado automaticamente em mensagens HTML personalizadas e avalia toda a sua mensagem HTML em relação ao conjunto completo de regras WCAG 2.1 AA. Para cada problema identificado, ele mostra:

  • O elemento HTML específico envolvido
  • Uma descrição do problema de acessibilidade
  • Um link para contexto adicional ou orientação de correção

Entendendo testes automatizados de acessibilidade

Os testes automatizados de acessibilidade ajudam a detectar problemas comuns, como texto alternativo ausente ou baixo contraste de cores, com base nos padrões WCAG Nível AA. Esse é um ponto de partida poderoso para a criação de mensagens mais inclusivas.

Mas a automação não pode capturar tudo. Algumas questões precisam de um olhar humano - por exemplo, se a ordem do foco faz sentido, se os links e botões estão claramente identificados ou se suas instruções são fáceis de seguir. Pense nessas verificações como uma ferramenta de diagnóstico, não como um veredicto final. Recomendamos revisar os problemas sinalizados manualmente e usar seu bom senso quando algo estiver marcado como “Precisa de revisão”.

Para obter suporte adicional, nosso guia Acessibilidade no Braze compartilha dicas práticas para tornar seu conteúdo mais fácil de ser usado por todos, inclusive:

Ao combinar testes automatizados com uma revisão manual cuidadosa, você detectará mais problemas e criará uma experiência melhor para todos os seus usuários.

  1. Crie sua mensagem LINE.
  2. Selecione a guia Test e selecione pelo menos um grupo de teste de conteúdo ou usuário individual para receber esta mensagem de teste.
  3. Selecione Send Test para enviar sua mensagem.

Testar mensagem LINE.

Push para celular

  1. Rascunhe seu push para celular.
  2. Selecione a guia Test e adicione seu endereço de e-mail ou ID de usuário no campo Add Individual Users.
  3. Selecione Send Test para enviar a mensagem rascunhada para o seu dispositivo.

Testar push

Push para a web

  1. Crie seu push para a web.
  2. Selecione a guia Test.
  3. Selecione Send Test to Myself.
  4. Selecione Send Test para enviar seu push para a web ao seu navegador.

Testar push para a web

Se você já aceitou mensagens push do dashboard da Braze, a mensagem aparecerá no canto da sua tela. Caso contrário, selecione Allow quando solicitado, e a mensagem será exibida.

Se você vir um erro informando que nenhum dos usuários selecionados possui tokens de push correspondentes para push para a web, verifique se o usuário de teste possui um token de push válido registrado para a plataforma selecionada. Para receber um token de push, o usuário deve estar configurado para receber notificações por push do app no seu dispositivo. Para mais detalhes, consulte Ativação de push e estados de inscrição de push.

Após criar sua mensagem SMS, MMS ou RCS, você pode enviar uma mensagem de teste para o seu telefone e ver como ficará em tempo real.

  1. Rascunhe sua mensagem SMS, MMS ou RCS.
  2. Selecione a guia Test e selecione pelo menos um grupo de teste de conteúdo ou usuário individual para receber esta mensagem de teste.
  3. Selecione Send Test para enviar sua mensagem de teste.

Testar Content Card

Após criar seu webhook, você pode fazer um envio de teste para verificar a resposta do webhook. Selecione a guia Test e selecione Send Test para enviar um teste para a URL do webhook fornecida. Você também pode selecionar um usuário individual para pré-visualizar a resposta como um usuário específico.

Testar Content Card

  1. Crie sua mensagem WhatsApp.
  2. Selecione a guia Test e selecione pelo menos um grupo de teste de conteúdo ou usuário individual para receber esta mensagem de teste.
  3. Inicie uma janela de conversa enviando uma mensagem WhatsApp para o número de telefone associado ao grupo de inscrições que você está usando para esta mensagem. O número de telefone associado está listado no alerta na guia Test.
  4. Selecione Send Test para enviar sua mensagem.

Testar mensagem WhatsApp.

Testar Campaigns personalizadas

Se você está testando Campaigns que preenchem dados de usuários ou usam propriedades de eventos personalizados, será necessário seguir etapas adicionais ou diferentes.

Testando Campaigns personalizadas com atributos de usuário

Se você está usando personalização na sua mensagem, precisará seguir etapas adicionais para pré-visualizar corretamente sua Campaign e verificar se os dados do usuário estão preenchendo o conteúdo adequadamente.

Ao enviar uma mensagem de teste, certifique-se de escolher a opção Select Existing User ou pré-visualizar como um Custom User.

Testando uma mensagem personalizada

Selecionando um usuário existente

Se estiver selecionando um usuário existente, insira o ID de usuário ou e-mail específico no campo de pesquisa. Em seguida, use a pré-visualização do dashboard para ver como sua mensagem apareceria para esse usuário e envie uma mensagem de teste para o seu dispositivo que reflita o que esse usuário veria.

Selecionar um usuário

Selecionando um usuário personalizado

Se estiver pré-visualizando como um usuário personalizado, insira texto para os vários campos disponíveis para personalização, como o nome do usuário e quaisquer atributos personalizados. Novamente, você pode inserir seu próprio endereço de e-mail para enviar um teste para o seu dispositivo.

Usuário personalizado

Personalizando um usuário existente

Você pode editar campos individuais de um usuário aleatório ou existente para ajudar a testar conteúdo dinâmico na sua mensagem. Selecione Edit para converter o usuário selecionado em um usuário personalizado que você pode modificar.

A guia "Preview as a User" com um botão "Edit".

Testando Campaigns personalizadas com propriedades de eventos personalizados

Testar Campaigns personalizadas com propriedades de eventos personalizados difere um pouco do teste de outros tipos de Campaigns descritos.

Método 1: Disparando a Campaign manualmente

Você pode disparar a Campaign manualmente como uma forma robusta de testar Campaigns personalizadas usando propriedades de eventos personalizados:

  1. Escreva o texto envolvendo a propriedade do evento.

Compondo mensagem de teste com propriedades

  1. Use a entrega baseada em ação para entregar a Campaign quando o evento ocorrer.

Entrega da mensagem de teste

  1. Direcione os usuários como faria para testes, usando um filtro de teste ou direcionando seu próprio endereço de e-mail, e finalize a criação da Campaign.

Direcionamento da mensagem de teste

  1. Acesse seu app e conclua o evento personalizado.

A Campaign será disparada e mostrará a mensagem personalizada com a propriedade do evento.

Exemplo de mensagem de teste

Método 2: Enviando uma mensagem de teste para si mesmo

Alternativamente, se você está salvando IDs de usuário personalizados, também pode testar a Campaign enviando uma mensagem de teste personalizada para si mesmo.

  1. Escreva o texto da sua Campaign.
  2. Selecione a guia Test e escolha Customized User.
  3. Adicione a propriedade do evento personalizado na parte inferior da página e adicione seu ID de usuário ou endereço de e-mail na caixa superior.
  4. Selecione Send Test para receber uma mensagem personalizada com a propriedade.

Testando usando usuário personalizado

Método 3: Usando Liquid

Você pode testar propriedades de eventos personalizados inserindo valores manualmente com Liquid.

  1. No editor de mensagens, insira valores para suas propriedades de eventos personalizados.
  2. Selecione a guia Preview as a User para verificar se a mensagem correta é exibida.

Limitações

Existem algumas situações em que as mensagens de teste não se comportam da mesma forma que Campaigns ou Canvas enviados para usuários reais. Nesses casos, considere lançar a Campaign ou Canvas para um conjunto limitado de usuários de teste para validar esse comportamento.

  • Visualizar a Central de Preferências da Braze a partir de mensagens de teste fará com que o botão Save Preferences fique esmaecido.
  • Para testar mensagens no app e Content Cards, o usuário alvo deve ter um token de push para o dispositivo alvo.
  • Para testar links de cancelamento de inscrição em e-mails, certifique-se de que o endereço de e-mail do seu usuário de teste esteja no respectivo espaço de trabalho.
  • O cabeçalho List-Unsubscribe não é incluído em e-mails enviados pela funcionalidade de mensagem de teste.

Solução de problemas

Mensagens no app

Se sua Campaign de mensagem no app não está sendo disparada por uma Campaign de push, verifique a segmentação da Campaign no app para confirmar que o usuário atende ao público-alvo antes de receber a mensagem push.

Para envios de teste no Android e iOS, as mensagens no app que usam o comportamento ao clicar Request push permission podem não ser exibidas em alguns dispositivos. Como solução alternativa:

  • Android: Os dispositivos devem estar no Android 13 e na versão 21.0.0 do nosso SDK Android. Outro motivo pode ser que o dispositivo no qual a mensagem no app é exibida já possui um prompt no nível do sistema. Você pode ter selecionado Do not ask again, então pode ser necessário reinstalar o app para redefinir as permissões de notificação antes de testar novamente.
  • iOS: Recomendamos que sua equipe de desenvolvimento revise a implementação de notificações por push do seu app e remova manualmente qualquer código que solicite permissões de push. Para mais informações, consulte Mensagens no app de introdução ao push.

Para que uma Campaign de mensagem no app baseada em ação seja entregue, você deve registrar eventos personalizados por meio do SDK da Braze, não por REST APIs, para que os usuários recebam mensagens no app elegíveis diretamente em seus dispositivos. Os usuários recebem a mensagem no app se realizarem o evento durante a sessão.
New Stuff!