Checklist de QA do Canvas

Use este checklist para validar seu Canvas antes do lançamento e monitorar o desempenho nas primeiras horas após a entrada em operação. Nem todos os itens se aplicam a todos os Canvas, então percorra as fases que correspondem ao seu tipo de entrada, canais e complexidade da jornada.

Nota

Para considerações específicas de canal (estados de inscrição de push, throughput de SMS, comportamento de mensagens no app e mais), consulte também Saiba antes de enviar.

Fase 1: Configuração e governança

Conclua essas verificações em Básicos e Configurações de envio antes de criar filtros de público ou etapas de jornada. Todas as verificações seguintes dependem de acertar esses detalhes.

• Confirme o tipo de entrada: Verifique se o seu Canvas usa entrada agendada, baseada em ação ou disparada por API ao determinar o cronograma de entrada do Canvas.
• Use nomes consistentes: Nomeie seu Canvas de forma que os colegas consigam encontrá-lo em buscas e relatórios.
• Adicione tags: Tags alimentam regras de limite de frequência, filtros de Segment para redirecionamento e relatórios personalizados.
• Defina um evento de conversão primária: Eventos de conversão potencializam a otimização e os relatórios do Canvas.
• Configure os critérios de saída: Alinhe os eventos de saída com sua conversão primária ou adicione saídas baseadas em Segment para que os usuários deixem a jornada quando converterem ou não se qualificarem mais. Para combinar eventos de entrada e saída, consulte Combinar critérios de saída com eventos de entrada.
• Revise as listas de supressão: As listas de supressão do espaço de trabalho excluem usuários correspondentes de Campaigns e Canvas, a menos que o Canvas use uma tag de exceção configurada nessa lista.
• Revise a reelegibilidade: Defina a janela de reelegibilidade corretamente para evitar envio excessivo de mensagens ou problemas de redirecionamento.
• Revise as configurações de inscrição: Em Configurações de inscrição, escolha quem pode receber e-mail e push neste Canvas — usuários inscritos ou com opt-in, apenas usuários com opt-in, ou todos os usuários, incluindo não inscritos (use a última opção apenas para e-mail de transação). Essa configuração se aplica a todas as etapas de e-mail e push do Canvas.
• Ative o horário de silêncio (opcional): Para jornadas baseadas em ação, confirme se o horário de silêncio não atrasará mensagens que exigem entrega urgente.
• Defina limite de frequência e limite de taxa (opcional): Limite a frequência de entrega e proteja os sistemas downstream que lidam com o volume de mensagens.
• Adicione um grupo de teste (opcional): Grupos de teste permitem que as partes interessadas recebam cópias ao vivo dos e-mails. Se o conteúdo do seu e-mail faz referência a variáveis de contexto, use a prévia de Testar Canvas com envios de teste — cópias de teste não avaliam variáveis de contexto.
• Configure aprovações (opcional): Se sua equipe exige governança de lançamento, configure aprovações para Campaigns e Canvas.

Fase 2: Público e direcionamento

Revise o Público de entrada e o Cronograma de entrada após a conclusão da configuração.

• Verifique o tamanho estimado do público: No resumo de Público-alvo, confirme se o público alcançável parece correto. Números inesperadamente baixos geralmente indicam um problema de filtro.
• Faça uma verificação pontual da elegibilidade do usuário: Use a Pesquisa de usuário na etapa de Público-alvo para confirmar que um usuário teste conhecido corresponde ao seu Segment e aos seus filtros.
• Filtre canais alcançáveis: Direcione usuários com push ativado para etapas de push e usuários inscritos em e-mail para e-mail usando jornadas do público, para que os tamanhos dos relatórios permaneçam precisos e os usuários não sejam enviados por canais inalcançáveis.
• Teste condições de corrida: Para entrada baseada em ação, confirme que a ação-gatilho não pode ser disparada antes que os critérios do público sejam atendidos, caso contrário, usuários elegíveis podem nunca entrar. Não use o mesmo gatilho tanto no Cronograma de entrada quanto no Público-alvo.
• Verifique a entrada por fuso horário: Para entrada agendada no fuso local, lance o Canvas pelo menos 24 horas antes do horário de entrada pretendido, para que nenhum fuso horário perca a janela.

Dica

Você verá um alerta se não tiver agendado um intervalo suficiente. Uma solução rápida é ajustar o horário de envio para garantir que os usuários permaneçam no Segment direcionado por 24 horas completas.

• Revise a sobreposição entre Canvas: Quando vários Canvas estão em execução ao mesmo tempo, verifique a sobreposição de público e persona, além das listas de supressão, para que os usuários não recebam mensagens concorrentes de múltiplas jornadas.
• Considere expressões regulares para filtros: No Público-alvo, nas jornadas do público e nas validações de entrega, expressões regulares podem capturar valores que os filtros Equals não detectam por causa de diferenças de capitalização ou formatação. Se o seu público-alvo for menor do que o esperado, tente Matches Regex ou Does Not Match Regex.

Fase 3: Conteúdo e personalização

Com a configuração e o público definidos, abra cada etapa de Mensagem e valide a personalização, a mídia e o conteúdo específico de cada canal antes de testar a jornada.

• Verifique as propriedades de entrada, evento e contexto: Confirme que as propriedades de eventos, atributos, catálogos, Conteúdo Conectado e cargas úteis de API estão sendo preenchidas corretamente nas prévias.
• Teste a lógica e os fallbacks de Liquid: Garanta que a personalização seja renderizada para todas as variantes e que os valores padrão sejam preenchidos quando houver dados ausentes.
• Adicione lógica de interrupção para Conteúdo Conectado: Use a lógica de interrupção de mensagem ou interrompa o Conteúdo Conectado para que chamadas de API com falha não enviem mensagens com erros.
• Revise as configurações de entrega: Verifique o tempo por etapa, Intelligent Timing, horário de silêncio e as validações de entrega.
• Aplique diretrizes da marca (opcional): Se o seu espaço de trabalho utiliza diretrizes da marca, confirme que o texto está alinhado com a voz e o tom definidos — ou use o BrazeAI Operator para aplicá-las ao redigir o conteúdo.
• Teste todas as mídias: Confirme que imagens, mídia de push avançado e anexos são renderizados corretamente em todos os canais da sua jornada.
• Revise a renderização de e-mail com o Inbox Vision: Faça a prévia nos principais clientes de e-mail e dispositivos, não apenas em uma caixa de entrada.
• Realize a garantia de qualidade do conteúdo: Revise ortografia, gramática e tom no conteúdo das mensagens.
• Confirme os links de cancelamento de inscrição e opt-out: Verifique se os rodapés obrigatórios e os links de opt-out para e-mail e SMS estão presentes e foram testados.
• Verifique os limites de caracteres: Confirme que o texto de push e SMS não será silenciosamente truncado. Para SMS, use a calculadora de segmentos de SMS.

Fase 4: Revisar a lógica da jornada, testar e visualizar

Após o conteúdo ser criado, revise o mapa da jornada e teste na seguinte ordem.

1. Visualizar jornadas do usuário: Confirme se as postergações, divisões de decisão, jornadas do público e jornadas de ação se comportam conforme esperado.
2. Verificar conflitos nos controles de entrega: Intelligent Timing e horário de silêncio entram em conflito — escolha um. Intelligent Timing e limite de frequência também entram em conflito — escolha um.
3. Confirmar se os disparadores baseados em ação chegam à Braze: Verifique se o ponto de dados de disparo aparece em um perfil de usuário ativo no histórico de mensagens antes do lançamento.
4. Enviar mensagens de teste: Envie para um grupo de teste interno.
5. Realizar um teste de Canvas de ponta a ponta ao vivo (opcional): Recomendado para jornadas complexas:
   • Duplique seu Canvas e restrinja a entrada apenas a usuários teste (filtre por ID externo, endereço de e-mail ou número de telefone).
   • Reduza as postergações para cerca de um segundo para agilizar o QA e, em seguida, lance o Canvas de teste.
   • Execute comportamentos reais no seu app (web, iOS e Android) para percorrer cada ramificação e confirmar se as mensagens esperadas chegam e se todos os links — incluindo deep links — funcionam conforme esperado.

Para testes passo a passo e testes de ramificação baseados em API, consulte Enviar Canvas de teste.

Importante

Connected Content é executado durante a visualização de jornadas do usuário. Webhooks são executados quando mensagens de teste são enviadas, não durante a execução da visualização em si. Remova Connected Content ou webhooks que alteram perfis de usuário ou dados referenciados em outros Canvas antes de testar.

Revisar etapas de mensagem para avanço do usuário

Por padrão, os usuários avançam por todas as etapas de mensagem independentemente de terem recebido a mensagem. Se você quiser avançar apenas os usuários que receberam uma mensagem específica, adicione uma etapa de divisão de decisão diretamente após o componente de mensagem. Adicione o filtro Received Message from Canvas Step e selecione o Canvas e a etapa de mensagem.

Para etapas de mensagem com mensagens no app, use um componente de jornadas de ação em vez de divisão de decisão. Defina um grupo de ação com o filtro Interact with Step e selecione View in app message. Configure a janela de avaliação para a janela de expiração da mensagem no app.

Para um componente de mensagem multicanal, faça o seguinte:

• Inclua uma etapa de postergação entre suas etapas de mensagem e divisão de decisão, e defina a postergação para pelo menos cinco segundos.
• Se o componente incluir Intelligent Timing, defina a postergação para 24 horas.
• Se o componente incluir limite de frequência, divida suas mensagens em várias etapas de mensagem de canal único e conecte-as entre si. Em seguida, conecte a etapa de divisão de decisão diretamente após a última etapa de mensagem para verificar se o usuário recebeu alguma das mensagens.

Fase 5: Monitoramento pós-lançamento

Nos primeiros minutos e horas após a ativação, fique atento a esses padrões.

• Monitore a entregabilidade desde o início: Verifique se há picos de bounce, erro ou rejeição antes que o volume aumente em Relatórios de e-mail e Observabilidade de envio de mensagens.
• Investigue muitas entradas com poucos envios: Na maioria das vezes, isso se deve a um filtro de elegibilidade de canal ou estado de inscrição, um controle de entrega muito restrito ou o tamanho do grupo de controle. Verifique o público de entrada e o detalhamento de envio da primeira etapa na análise de dados do Canvas, e depois revise o Público de entrada, o Primeiro componente do Canvas e o Grupo de controle do Canvas.

Público de entrada

Se você está usando um envio agendado, confira seu público-alvo revisando o público-alvo. Como estão os números em cada canal, e como isso se relaciona com os canais do seu Canvas? Se os números mais baixos correspondem aos canais que você usou, pode ser que você tenha encontrado o problema.

Primeiro componente do Canvas

Revise filtros de público, ações-gatilho ou Segments nos componentes iniciais. Procure por erros de digitação ou condições excessivamente restritivas. Confirme que você não está usando Equals quando Matches Regex seria mais adequado.

Grupo de controle do Canvas

Revise a distribuição entre variantes e seu grupo de controle. O grupo de controle está maior do que o pretendido? Se Otimizar com BrazeAI^TM (exibido como Intelligent Selection em alguns espaços de trabalho) estiver ativado e o grupo de controle estiver vencendo, considere interromper o Canvas e tentar uma nova abordagem.

• Investigue público vazio: Geralmente é uma condição de corrida ou um filtro excessivamente restritivo. Confirme que o Segment tem usuários por meio do público-alvo. Para entrada baseada em ação, verifique se você não duplicou o disparador em público-alvo.
• Investigue queda inesperada entre etapas: Verifique se há erros de digitação e de capitalização nos filtros. Revise o Intelligent Timing, o horário de silêncio e as validações de entrega.
• Investigue volumes de envio suspeitos entre jornadas: Quando os envios entre jornadas do público ou jornadas de ação não correspondem às expectativas, revise Segments, filtros e ações-gatilho. Remova filtros sobrepostos.

Para um fluxo completo de investigação, consulte Solução de problemas de Canvas.

Verificações finais comuns

Execute apenas os itens que se aplicam ao seu Canvas:

• Planeje a entrada agendada no fuso local: permita 24 horas de antecedência para uma entrega ideal em todos os fusos horários globais. Consulte Verificar entrada por fuso horário na Fase 2.
• Prefira Intelligent Timing com uma janela de 3 dias: o Intelligent Timing funciona melhor com pelo menos uma janela de Segment de 3 dias para que os usuários não saiam antes do horário ideal de envio.
• Confirme o tamanho do grupo de controle antes do lançamento: não é possível adicionar um grupo de controle retroativamente. Defina as porcentagens de variante e controle no construtor ou nas jornadas experimentais antes de ativar.
• Teste deep links em um dispositivo real: confirme que os links abrem a tela correta no app e fornecem um fallback adequado para usuários sem o app instalado. Para falhas específicas de plataforma, consulte Solução de problemas de deep linking.
• Confirme que o rastreamento funciona de ponta a ponta: verifique se os UTMs são adicionados corretamente e se o rastreamento de cliques é registrado em um envio de teste real, e não apenas na prévia.

Verificações específicas por canal

Se o seu Canvas inclui esses canais, verifique estes detalhes adicionais:

• Push: confirme que a mídia avançada e as imagens carregam, que os botões de ação funcionam e que você testou tanto no iOS quanto no Android. Confirme o comportamento de badge e som, se utilizados.
• SMS e MMS: confirme o ID do remetente ou código curto correto, o rodapé com palavra-chave de cancelamento, o encurtamento de links e o custo por Segment.
• In-App Messages e Content Cards: realize um teste ao vivo dentro do app ou na web — esses canais dependem de uma sessão do SDK, e não de um envio de teste pelo dashboard. Consulte também Content Cards.
• WhatsApp: confirme que um modelo aprovado está em uso e que as variáveis do modelo estão mapeadas para os dados corretos.