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.

Importante

Salve o rascunho da sua campanha após o teste para evitar a exclusão da campanha. Você pode enviar mensagens de teste sem salvar a mensagem como rascunho.

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 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, 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 precisar criar ou adicionar usuários teste individualmente.

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 canal correspondente.

• banners
• content card
• email
• mensagem no app
• line
• push
• sms/mms e rcs
• webhook
• whatsapp

Importante

Antes de testar mensagens de Banner na Braze, você precisará criar uma campanha de Banner na Braze. Além disso, verifique se o posicionamento que deseja testar já está inserido no seu app ou website.

Depois de criar sua mensagem de Banner, você pode visualizar o Banner ou enviar uma mensagem de teste.

1. Elabore sua mensagem de Banner.
2. Selecione Prévia para 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 Destinatários de Teste e selecione Enviar Teste.

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

Nota

Lembre-se de que sua prévia pode não ser idêntica à renderização final no dispositivo do usuário devido a diferenças de hardware.

Checklist de teste

• Sua campanha de Banner está atribuída a um posicionamento?
• As imagens e mídias aparecem e funcionam conforme esperado nos tipos de dispositivo e tamanhos de tela que você está direcionando?
• Seus links e botões direcionam o usuário para onde deveriam?
• O Liquid funciona conforme 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?

Importante

Para enviar um teste para grupos de teste de conteúdo ou usuários individuais, o push deve estar ativado nos seus dispositivos de teste com tokens por push válidos registrados para o usuário teste antes do envio. Para usuários de iOS, é necessário tocar na notificação por push enviada pela Braze para visualizar o Content Card de teste. Esse comportamento se aplica apenas a Content Cards de teste.

Content Cards de teste são entregues por meio de uma notificação por push. O cartão é incluído 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.

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

1. Elabore seu Content Card.
2. Selecione a guia Teste e selecione pelo menos um Grupo de Teste de Conteúdo ou usuário individual para receber esta mensagem de teste.
3. Selecione Enviar Teste para enviar seu Content Card para o app.

Prévia

Você pode visualizar o cartão enquanto o compõe na guia Prévia. Isso deve ajudar você a visualizar como será a mensagem final da perspectiva do usuário.

Nota

Na guia Prévia do criador, a visualização da sua mensagem pode não ser idêntica à renderização real no dispositivo do usuário. Recomendamos sempre enviar uma mensagem de teste para um dispositivo para garantir que mídia, texto, personalização e atributos personalizados sejam gerados corretamente.

Checklist de teste

• Seu usuário teste está com push ativado e possui um token por push válido?
• As imagens e mídias aparecem e funcionam conforme esperado?
• O Liquid funciona conforme 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 direcionam o usuário para onde deveriam?
• Seu usuário teste está com push ativado e possui um token por 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 devidamente codificados. Caso contrário, a solicitação da imagem falhará.
• Verifique as políticas de segurança de conteúdo: Se a 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 carregar em um navegador, o problema está na URL ou na hospedagem da imagem, não na Braze.

Depuração

Depois que seus Content Cards forem enviados, você pode analisar ou depurar qualquer problema 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 campanha específica:

1. Acesse Configurações > Registro de Usuários de Eventos.
2. Localize e expanda a Solicitação do SDK para o seu usuário teste.
3. Clique em Dados Brutos.

4. Encontre o id da sua sessão. A seguir, um trecho de exemplo:

   
   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
      }
    ]
   
   

5. Use uma ferramenta de decodificação como Base64 Decode and Encode para decodificar o id do formato Base64 e encontrar o campaign_id associado. Em nosso exemplo, isso resulta no 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.
   
   

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

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.

1. Elabore sua mensagem de e-mail.
2. Selecione Prévia e Teste.
3. Selecione a guia Envio de Teste e adicione seu endereço de e-mail ou ID de usuário no campo Adicionar usuários individuais.
4. Selecione Enviar Teste para enviar o e-mail elaborado para a sua caixa de entrada.

Se o seu e-mail inclui um link para a Central de Preferências, os envios de teste não geram um link funcional nem permitem salvar preferências. Para testar a Central de Preferências, envie a mensagem para um usuário teste ou um Segment interno pequeno. Para mais detalhes, consulte Testando centrais de preferências.

Se sua campanha de e-mail contém uma imagem grande e não está sendo exibida conforme esperado no Outlook, considere reduzir as dimensões reais do arquivo da imagem com uma ferramenta de edição ou redimensionamento de imagem, em vez de apenas escalá-la com CSS ou HTML.

Aviso

Para enviar um teste para Grupos de Teste de Conteúdo ou usuários individuais, o push deve estar ativado nos seus dispositivos de teste antes do envio. Por exemplo, você deve ter o push ativado no seu dispositivo iOS para tocar na notificação antes que a mensagem de teste seja exibida.

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

1. Elabore 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 sua mensagem push para o dispositivo.

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

Importante

Envios de teste podem resultar em mais de uma mensagem no app sendo enviada para cada destinatário.

Ao clicar diretamente e abrir a mensagem push, você será direcionado para o seu app, onde poderá visualizar o teste da mensagem no app. Esse recurso de teste de mensagem no app depende de o usuário clicar em uma notificação por push de teste para disparar a mensagem no app. Sendo assim, o usuário deve ser elegível para receber notificações por push no app correspondente para a entrega bem-sucedida da notificação por push de teste.

Prévia

Você pode visualizar sua mensagem no app enquanto a compõe na guia Prévia. Isso deve ajudar você a ter uma ideia de como será a mensagem final da perspectiva do usuário. Você pode pré-visualizar como a mensagem aparecerá 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.

A Braze possui 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.

Aviso

Na Prévia, a visualização da sua mensagem pode não ser idêntica à renderização real no dispositivo do usuário. Recomendamos sempre enviar uma mensagem de teste para um dispositivo para garantir que mídia, texto, personalização e atributos personalizados sejam gerados corretamente.

Checklist de teste

• As imagens e mídias aparecem e funcionam conforme esperado?
• O Liquid funciona conforme 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 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 com o editor de HTML tradicional de acordo com 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 da Web (WCAG). WCAG é um conjunto de padrões técnicos reconhecidos internacionalmente, desenvolvidos pelo World Wide Web Consortium (W3C) para tornar o conteúdo da web mais acessível a pessoas com deficiência.

Nota

O scanner de acessibilidade de mensagens no app funciona apenas em mensagens criadas com HTML personalizado.

Como funciona

O scanner é executado automaticamente em mensagens HTML personalizadas e avalia toda a sua mensagem HTML com base no 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 na Braze compartilha dicas práticas para tornar seu conteúdo mais fácil de ser usado por todos, inclusive:

• Títulos e estrutura
• Texto alternativo e imagens
• Links e botões
• Contraste de cores
• Alvos de toque

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 selecione pelo menos um Grupo de Teste de Conteúdo ou usuário individual para receber esta mensagem de teste.
3. Selecione Enviar Teste para enviar sua mensagem.

Push móvel

1. Elabore seu push móvel.
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 elaborada para o seu dispositivo.

Se você vir um erro indicando que nenhum dos usuários selecionados possui tokens por push correspondentes, o usuário teste não tem um token por push válido para a plataforma selecionada. O usuário deve ter iniciado uma sessão no app e ativado o push para aquele 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 seu web push para o navegador.

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

Se você vir um erro indicando que nenhum dos usuários selecionados possui 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 deve estar configurado para receber notificações por push para o app em seu dispositivo. Para mais detalhes, 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 o seu celular para ver como ficará em tempo real. O destinatário deve pertencer ao grupo de inscrições de SMS que você selecionar ao enviar o teste, ter um número de telefone válido e ter pelo menos um país selecionado em Permissões Geográficas. Para mais detalhes, consulte Perguntas frequentes sobre SMS.

1. Elabore sua mensagem SMS, MMS ou RCS.
2. Selecione a guia Teste e selecione pelo menos um Grupo de Teste de Conteúdo ou usuário individual para receber esta mensagem de teste.
3. Selecione Enviar Teste para enviar sua mensagem de teste.

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

1. Crie sua mensagem WhatsApp.
2. Selecione a guia Teste 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 Teste.
4. Selecione Enviar Teste para enviar sua mensagem.

Testar campanhas personalizadas

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

Testando campanhas personalizadas com atributos de usuário

Se você estiver usando personalização na sua mensagem, precisará seguir etapas adicionais para visualizar corretamente sua campanha e verificar se os dados do usuário estão preenchendo o conteúdo de forma adequada. Para limitações de prévia no criador, Inbox Vision e Canvas, consulte Prévia de personalização.

Ao enviar uma mensagem de teste, escolha a opção Select Existing User ou visualize como Custom User.

Selecionando um usuário existente

Se estiver selecionando um usuário existente, insira o ID de usuário específico ou o e-mail no campo de busca. Em seguida, use a prévia 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.

Selecionando um usuário personalizado

Se estiver visualizando como um usuário personalizado, insira texto para os diversos 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 ao seu dispositivo.

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 pode ser modificado.

Testando campanhas personalizadas com propriedades de eventos personalizados

Testar campanhas personalizadas com propriedades de eventos personalizados difere um pouco de testar outros tipos de campanhas descritos acima.

• disparar manualmente
• mensagem de teste
• liquid

Método 1: Disparando a campanha manualmente

Você pode disparar a campanha por conta própria como uma maneira robusta de testar campanhas personalizadas com propriedades de eventos personalizados:

1. Escreva o texto envolvendo a propriedade do evento.

2. Use a entrega baseada em ação para entregar a campanha quando o evento ocorrer.

Nota

Se você estiver testando uma campanha de push para iOS, deverá definir a postergação para um minuto para ter tempo de sair do app, pois o iOS não entrega notificações por push para o app atualmente aberto. Outros tipos de campanhas podem ser configurados para entrega imediata.

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

4. Acesse seu app e conclua o evento personalizado.

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

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

Como alternativa, se você estiver salvando IDs de usuário personalizados, também poderá testar a campanha enviando uma mensagem de teste personalizada para si mesmo.

1. Escreva o texto da sua campanha.
2. Selecione a guia Test e escolha Customized User.
3. Adicione a propriedade de 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.

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 o Canvas para um conjunto limitado de usuários teste para validar esse comportamento.

• Visualizar a Central de Preferências da Braze a partir de mensagens de teste faz com que o botão Salvar preferências fique desativado. As Liquid tags da Central de Preferências também podem não resolver para links válidos. Esse é o comportamento esperado. Para testar de ponta a ponta, consulte Testando centrais de preferências.
• Para testar mensagens no app e Content Cards, o usuário-alvo deve 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}}} é renderizado como uma URL completa somente quando o endereço de e-mail do destinatário possui 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>. Verifique se o endereço de e-mail do seu usuário teste possui um perfil existente 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.
• E-mails enviados para usuários do grupo de teste não atualizam a lista de Campaigns recebidas no perfil de usuário nem incrementam os envios na análise de dados do dashboard.

Solução de problemas

Mensagens no app

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

Para envios de teste em Android e 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 com a versão 21.0.0 ou superior do nosso SDK para Android. Outro motivo pode ser que o dispositivo no qual a mensagem no app é exibida já tenha um prompt em nível de sistema. Você pode ter selecionado Não perguntar novamente, 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 das 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 push primer.

Para que uma campanha de mensagem no app baseada em ação seja entregue, você precisa registrar eventos personalizados pelo SDK da Braze, e não por REST APIs, para que os usuários possam receber 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.