Ir para o conteúdo

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 teste

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

Opcional: Crie um Grupo de Teste de Conteúdo

Uma maneira prática de organizar seus usuários teste é criar um Grupo de Teste de Conteúdo. Ele reúne um grupo de usuários que receberão mensagens de teste das campanhas. Você pode adicionar esse grupo de teste ao campo Adicionar Grupos de Teste de Conteúdo em Destinatários de Teste na sua campanha e iniciar seus testes sem precisar criar ou adicionar usuários teste individualmente.

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

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

Depois de criar sua mensagem de Banner, você pode visualizar a prévia do Banner ou enviar uma mensagem de teste.

  1. Crie o rascunho da sua mensagem de Banner.
  2. Selecione Prévia para visualizar a prévia do 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 Destinatários de teste e selecione Enviar teste.

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

Guia Prévia do criador de Banner.

Checklist de teste

  • Sua campanha de Banner está atribuída a um posicionamento?
  • As imagens e mídias aparecem e se comportam como esperado nos tipos de dispositivo e tamanhos de tela que você está direcionando?
  • Seus links e botões levam o usuário para onde deveriam?
  • O Liquid funciona como esperado? Você definiu um valor de atributo padrão caso o Liquid não retorne nenhuma informação?
  • Seu texto está claro, conciso e correto?

Os Content Cards de teste são entregues por meio de uma notificação por push. O cartão vai 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 precisa estar ativado mesmo que você esteja testando um cartão de conteúdo.

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

Depois de criar seu cartão de conteúdo, você pode enviar um cartão de conteúdo de teste para o seu app e ver como ele ficará em tempo real.

  1. Crie o rascunho do seu cartão de conteúdo.
  2. Selecione a guia Teste e escolha pelo menos um grupo de teste de conteúdo ou usuário individual para receber essa mensagem de teste.
  3. Selecione Enviar teste para enviar seu cartão de conteúdo para o app.

Teste de cartão de conteúdo

Prévia

Você pode visualizar a prévia do cartão enquanto o cria na guia Prévia. Isso ajuda a visualizar como a mensagem final vai aparecer do ponto de vista do usuário.

Checklist de teste

  • Seu usuário teste aceitou receber push e tem um token por push válido?
  • As imagens e mídias aparecem e se comportam como esperado?
  • O Liquid funciona como esperado? Você definiu um valor de atributo padrão caso o Liquid não retorne nenhuma informação?
  • Seu texto está claro, conciso e correto?
  • Seus links levam o usuário para onde deveriam?
  • Seu usuário teste aceitou receber push e tem um token por push válido?

Solução de problemas com imagens quebradas

Se a imagem de um cartão de conteúdo não estiver sendo renderizada ou aparecer quebrada:

  • Verifique se o URL está correto e codificado: Caracteres especiais no URL (como espaços ou parâmetros de consulta) precisam estar codificados corretamente. Caso contrário, a solicitação da imagem falha.
  • Verifique as políticas de segurança de conteúdo: Se a sua organização tem 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 do URL da imagem é permitido pela sua CSP.
  • Use HTTPS: Os URLs de imagem devem usar https:// em vez de http:// para evitar o bloqueio de conteúdo misto em navegadores e apps.
  • Abra o URL diretamente em um navegador: Se a imagem não carregar no navegador, o problema está no URL ou na hospedagem da imagem, e não na Braze.

Depuração

Depois que seus Content Cards forem enviados, você pode analisar ou depurar qualquer problema no registro de usuários de eventos no console de desenvolvedor.

Um caso de uso comum é tentar descobrir por que um usuário não consegue ver um determinado cartão de conteúdo. Para isso, você pode procurar no Registro 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 campanha específica:

  1. Acesse Configurações > Registro de usuários de eventos.
  2. Localize e expanda a solicitação do SDK do seu usuário teste.
  3. Clique em Dados brutos.
  4. Encontre o id da sua sessão. Veja um trecho de exemplo a seguir:

     [
       {
         "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:

     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 o campaign_id.

Pesquisa de campaign_id na página Campaigns

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

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

  1. Crie o rascunho da sua mensagem no app.
  2. Selecione a guia Teste e adicione seu endereço de e-mail ou ID de usuário no campo Adicionar usuários individuais.
  3. Selecione Enviar teste para enviar a mensagem push para seu dispositivo.

Uma mensagem push de teste aparecerá na parte superior da tela do dispositivo.

Teste de mensagem no app

Ao clicar diretamente na mensagem push e abri-la, você será levado ao app, onde poderá ver o teste da mensagem no app. Esse recurso de teste depende de o usuário clicar em uma notificação por push de teste para disparar a mensagem no app. Portanto, o usuário precisa estar elegível para receber notificações por push no app correspondente para que a notificação por push de teste seja entregue.

Prévia

Você pode visualizar a prévia da mensagem no app enquanto a cria na guia Prévia. Isso ajuda a visualizar como a mensagem final vai aparecer do ponto de vista do usuário. Você pode ver como a mensagem ficará para um usuário aleatório, um usuário específico ou um usuário personalizado. Também é possível visualizar mensagens para dispositivos móveis ou tablets.

Guia Criar ao montar uma mensagem no app, mostrando a prévia de como a mensagem vai ficar. Nenhum usuário está selecionado, então o Liquid adicionado na seção do corpo aparece como está.

A Braze oferece três gerações de mensagens no app. Você pode ajustar para quais dispositivos suas mensagens devem ser enviadas, de acordo com a geração que eles suportam.

Alternando entre gerações ao visualizar a prévia de uma mensagem no app.

Checklist de teste

  • As imagens e mídias aparecem e se comportam como esperado?
  • O Liquid funciona como esperado? Você definiu 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 levam o usuário para onde deveriam?

Verificador de acessibilidade

Para apoiar as práticas recomendadas de acessibilidade, a Braze verifica automaticamente o conteúdo das mensagens no app criadas com o editor de HTML tradicional em relação aos padrões de acessibilidade. Esse verificador ajuda a identificar conteúdos que podem não atender às Diretrizes de Acessibilidade para Conteúdo Web (WCAG). As WCAG são 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 da verificação de acessibilidade

Como funciona

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

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

Entendendo os 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 na 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 Teste e escolha pelo menos um grupo de teste de conteúdo ou usuário individual para receber essa mensagem de teste.
  3. Selecione Enviar teste para enviar a mensagem.

Teste de mensagem LINE.

Push para dispositivos móveis

  1. Crie o rascunho do seu push para dispositivos móveis.
  2. Selecione a guia Teste e adicione seu endereço de e-mail ou ID de usuário no campo Adicionar usuários individuais.
  3. Selecione Enviar teste para enviar o rascunho da mensagem para seu dispositivo.

Teste de push

Se aparecer um erro informando que nenhum dos usuários selecionados tem tokens por push correspondentes, o usuário teste não tem um token por push válido para a plataforma selecionada. O usuário precisa ter iniciado uma sessão no app e ativado o push nesse dispositivo. Para saber mais, consulte Ativação de push e inscrição em push.

Web push

  1. Crie seu web push.
  2. Selecione a guia Teste.
  3. Selecione Enviar teste para mim.
  4. Selecione Enviar teste para enviar o web push para seu navegador web.

Teste de web push

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

Se aparecer um erro informando que nenhum dos usuários selecionados tem tokens por push correspondentes para Web Push, verifique se o usuário teste tem um token por push válido registrado para a plataforma selecionada. Para receber um token por push, o usuário precisa estar configurado para receber notificações por push do app no dispositivo. Para saber mais, consulte Ativação de push e inscrição em push.

Depois de criar sua mensagem SMS, MMS ou RCS, você pode enviar uma mensagem de teste para seu telefone e ver como ela ficará em tempo real. O destinatário precisa pertencer ao grupo de inscrições selecionado no envio do teste, ter um número de telefone válido e ter pelo menos um país selecionado em Permissões geográficas.

  1. Crie o rascunho da sua mensagem SMS, MMS ou RCS.
  2. Selecione a guia Teste e escolha pelo menos um grupo de teste de conteúdo ou usuário individual para receber essa mensagem de teste.
  3. Selecione Enviar teste para enviar sua mensagem de teste.

Teste de mensagem SMS

Depois de criar seu webhook, você pode fazer um envio de teste para verificar a resposta do webhook. Selecione a guia Teste e selecione Enviar teste para fazer um envio de teste para o URL do webhook informado. Você também pode selecionar um usuário individual para visualizar a resposta como um usuário específico.

  1. Crie sua mensagem do WhatsApp.
  2. Selecione a guia Teste e escolha pelo menos um grupo de teste de conteúdo ou usuário individual para receber essa mensagem de teste.
  3. Abra uma janela de conversa enviando uma mensagem do WhatsApp para o número de telefone associado ao grupo de inscrições que você está usando para essa mensagem. O número de telefone associado aparece no alerta da guia Teste.
  4. Selecione Enviar teste para enviar a mensagem.

Teste de mensagem do WhatsApp.

Teste de Campaigns personalizadas

Se você estiver testando Campaigns que preenchem dados de usuários ou usam propriedades de eventos personalizados, precisará seguir etapas adicionais ou diferentes.

Teste de Campaigns personalizadas com atributos de usuário

Se você usa personalização na sua mensagem, precisa seguir algumas etapas adicionais. Assim, você consegue visualizar corretamente a prévia da sua Campaign e confirmar que os dados de usuários estão preenchendo o conteúdo como esperado. Para saber mais sobre as limitações da prévia no criador, no Inbox Vision e no Canvas, consulte Prévia da personalização.

Ao enviar uma mensagem de teste, escolha a opção Selecionar usuário existente ou faça a prévia como Usuário personalizado.

Teste de uma mensagem personalizada

Selecionar um usuário existente

Se você selecionar um usuário existente, insira o ID de usuário específico ou o e-mail no campo de pesquisa. Depois, use a prévia do dashboard para ver como sua mensagem apareceria para esse usuário. Você também pode enviar uma mensagem de teste para o seu dispositivo que reflita o que esse usuário veria.

Seleção de um usuário

Selecionar um usuário personalizado

Se você fizer a prévia como um usuário personalizado, insira texto nos diversos campos disponíveis para personalização, como o nome do usuário e quaisquer atributos personalizados. Mais uma vez, você pode inserir seu próprio endereço de e-mail para enviar um teste para o seu dispositivo.

Usuário personalizado

Personalizar um usuário existente

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

A guia "Prévia como usuário" com um botão "Editar".

Teste de Campaigns personalizadas com propriedades de eventos personalizados

Testar Campaigns personalizadas com propriedades de eventos personalizados é um pouco diferente de testar os outros tipos de Campaigns descritos.

Método 1: Disparar a Campaign manualmente

Disparar a Campaign você mesmo é uma forma robusta de testar Campaigns personalizadas com propriedades de eventos personalizados:

  1. Escreva o texto que envolve a propriedade do evento.

Criação de uma 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. Defina o direcionamento para os usuários como faria em um teste, usando um filtro de teste ou direcionando para o seu próprio endereço de e-mail, e termine de criar a Campaign.

Direcionamento da mensagem de teste

  1. Acesse seu app e conclua o evento personalizado.

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

Exemplo de mensagem de teste

Método 2: Enviar uma mensagem de teste para você mesmo

Como alternativa, se você salva IDs de usuário personalizados, também pode testar a Campaign enviando uma mensagem de teste personalizada para você mesmo.

  1. Escreva o texto da sua Campaign.
  2. Selecione a guia Teste e escolha Usuário personalizado.
  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 Enviar teste para receber uma mensagem personalizada com a propriedade.

Teste usando um usuário personalizado

Método 3: Usar Liquid

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

  1. No editor de mensagens, insira valores para as propriedades do seu evento personalizado.
  2. Selecione a guia Prévia como usuário para verificar se a mensagem correta é exibida.

Limitações

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

  • Ao visualizar o centro de preferências da Braze a partir de mensagens de teste, o botão Salvar preferências fica desativado. As Liquid tags do centro de preferências também podem não gerar links válidos. Esse é o comportamento esperado. Para fazer um teste de ponta a ponta, consulte Testar centros de preferências.
  • Para testar mensagens no app e Content Cards, o usuário-alvo precisa ter um token por push para o dispositivo-alvo.
  • Para testar links de cancelamento de inscrição em e-mails, {{${set_user_to_unsubscribed_url}}} só é renderizado como URL completo quando o endereço de e-mail do destinatário tem um perfil de usuário associado com um ID externo no espaço de trabalho. Sem um perfil de usuário ou ID externo, a tag é renderizada como <a href="#">Unsubscribe</a>. Confira se o endereço de e-mail do seu usuário teste tem um perfil existente no respectivo espaço de trabalho.
  • O cabeçalho List-Unsubscribe não é incluído nos e-mails enviados pela funcionalidade de mensagem de teste.
  • Os e-mails enviados para usuários de grupos de teste não atualizam a lista de Campaigns recebidas no perfil do usuário nem aumentam a contagem de envios na análise de dados do dashboard.

Solução de problemas

Mensagens no app

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

Em envios de teste no Android e no iOS, as mensagens no app que usam o comportamento ao clicar Solicitar permissão de push podem não ser exibidas em alguns dispositivos. Como alternativa:

  • Android: Os dispositivos precisam estar no Android 13 e na versão 21.0.0 do nosso SDK para Android. Outro motivo pode ser que o dispositivo em que a mensagem no app é exibida já tenha um prompt no nível do sistema. Talvez você tenha selecionado Não perguntar novamente. Nesse caso, pode ser necessário reinstalar o app para redefinir as permissões de notificação antes de testar de novo.
  • 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 saber mais, consulte Mensagens no app de primer de push.

Para que uma campanha de mensagem no app com entrega baseada em ação seja entregue, você precisa registrar eventos personalizados pelo SDK da Braze, e não pelas REST APIs. Assim, os usuários podem receber mensagens no app elegíveis diretamente no dispositivo. Os usuários recebem a mensagem no app se realizarem o evento durante a sessão.

New Stuff!