Painel de diagnósticos de envio de mensagens

O painel de Diagnósticos de Envio de Mensagens fornece uma visão geral dos resultados do envio de mensagens, permitindo que você identifique tendências e diagnostique problemas potenciais na sua configuração de envio de mensagens. Este painel pode ajudar você a entender por que as mensagens de suas campanhas ou canvas podem não ter sido enviadas como esperado.

Conceitos-chave

Enviadas e entregues

É crucial entender que este painel relata como a Braze processou internamente uma mensagem, não o status final de entrega da mensagem.

Uma mensagem marcada como “enviada” neste painel significa que a Braze processou e despachou a mensagem com sucesso. Para a maioria dos canais, isso significa que a Braze entregou a mensagem ao parceiro de envio terceirizado relevante. No entanto, isso não garante a entrega final ao dispositivo do usuário.

Quando a Braze “envia” uma mensagem, a entrega final pode depender de serviços externos. Considere os seguintes exemplos para cada canal.

Canal	Exemplo de entrega final
Cartões de conteúdo	O cartão foi enviado e está elegível para visualização.
E-mail	A Braze entrega a mensagem a um prestador de serviço de e-mail (ESP). O ESP é então responsável pela entrega final. Esse ESP, por exemplo, pode relatar um “bounce” se o endereço de e-mail for inválido ou a caixa de entrada estiver cheia.
Mensagens no app	A mensagem foi apresentada ao usuário.
LINE	A mensagem foi entregue com sucesso a um parceiro de envio.
Push	A Braze entrega a mensagem ao serviço de notificação por push apropriado (como o serviço de Notificações por Push da Apple para iOS ou o Firebase Cloud Messaging para Android). Esse serviço é responsável pela entrega final da notificação ao dispositivo.
SMS/MMS/RCS	A Braze entrega a mensagem a um gateway de SMS (como o Twilio). Esse gateway é responsável pela entrega final à operadora móvel.
Webhooks	A solicitação do webhook foi feita com sucesso, retornando uma resposta 2xx.
WhatsApp	A mensagem foi entregue com sucesso a um parceiro de envio.

Atualização de dados

A frequência com que os dados neste dashboard são atualizados pode variar com base na carga do sistema. Embora a frequência de atualização não seja garantida, é provável que seja inferior a uma hora na maioria dos casos.

Configurando o dashboard

Você pode acessar o dashboard de diagnósticos indo para Análise de dados > Construtor de Dashboard e selecionando Diagnósticos de Envio de Mensagens na lista de dashboards criados pela Braze.

Para executar o dashboard e visualizar seus dados:

1. Escolha Campanhas ou Canvas como a origem dos seus relatórios de dashboard.
2. Selecione uma ou mais campanhas ou canvas.
3. Selecione Executar Dashboard para carregar os dados dos filtros selecionados.

Interpretando os dados

Blocos de resumo

Na parte superior da página, há blocos de resumo para o período selecionado que mostram:

• Total de abortos: A contagem total de mensagens que foram abortadas. Isso inclui membros do público do Canvas que não entraram no Canvas ou saíram do Canvas porque enfrentaram uma falha de etapa ou atenderam aos critérios de saída ao realizar um evento de saída.
• Envios de mensagens: A contagem total de mensagens que a Braze processou e enviou com sucesso.
  • E-mail, SMS/MMS/RCS, WhatsApp, LINE e push: A mensagem foi entregue com sucesso a um parceiro de envio.
  • Webhooks: A solicitação do webhook foi feita com sucesso, retornando uma resposta 2xx.
  • Cartões de conteúdo: O cartão foi enviado e está elegível para visualização.
  • Mensagens no app: A mensagem foi exibida para o usuário.

Resultados das mensagens ao longo do tempo

Este gráfico de séries temporais mostra uma análise dia a dia dos diferentes motivos pelos quais uma mensagem foi abortada ou um usuário foi removido de um Canvas. Este gráfico não exibe o número de envios.

Análise dos resultados das mensagens

Este gráfico mostra a análise de todos os resultados das mensagens dentro do período selecionado. Ele fornece uma visão completa de:

• O número total de envios como proporção de todos os resultados.
• A análise proporcional de cada motivo de aborto e remoção. Isso ajuda você a identificar rapidamente os motivos mais comuns pelos quais as mensagens não estão sendo enviadas.

Resultados de aborto

As definições a seguir explicam os resultados de aborto mostrados no dashboard. Os resultados são agrupados por categoria para facilitar a localização do que você está investigando.

Conteúdo e renderização

Resultado de aborto	Explicação
Cartão de conteúdo expirado	O cartão de conteúdo expirou antes que o usuário o visse.
Cartão de conteúdo inválido	O cartão de conteúdo teve erros e não foi enviado ao usuário. Algumas razões comuns para isso incluem: Tamanho máximo excedido (2 KB) A data de expiração é inválida A mensagem contém caracteres inválidos
Conteúdo conectado falhou	A Braze tentou enviar a mensagem, mas o Conteúdo conectado falhou após o número máximo de tentativas (o padrão é cinco). Nota: Esta contagem representa o número de mensagens abortadas por atingir o número máximo de tentativas, não o número total de solicitações de Conteúdo conectado que falharam.
Tempo limite de renderização de mensagem no app	Após várias tentativas, o Liquid não pôde ser renderizado e atingiu o tempo limite.
Aborto do Liquid	A Liquid tag abort_message foi chamada, então o envio foi cancelado.
Tempo limite de renderização do Liquid	Demorou muito para renderizar o modelo Liquid. Mais provável de ocorrer para Banners, mensagens no app e e-mail.
Erro de sintaxe do Liquid	O modelo Liquid teve um erro de análise, então a mensagem foi cancelada.

Estado da campanha e do Canvas

Resultado de aborto	Explicação
Falha na etapa de postergação	A etapa de postergação falhou, fazendo com que o usuário saísse do Canvas. Essa falha pode ocorrer quando: A variável fornecida para a etapa de postergação personalizada estava vazia ou era de um tipo inválido A postergação ultrapassou a duração máxima permitida dentro do Canvas
Exceção ou evento de saída	O usuário estava anteriormente elegível para receber a mensagem, mas realizou um evento de exceção para uma campanha baseada em ação, então a mensagem foi abortada, ou atendeu aos critérios de saída do Canvas, então foi removido no meio da jornada.
Campanha inativa	A campanha foi interrompida enquanto a mensagem estava em trânsito, então foi abortada.
Canvas inativo	O Canvas foi interrompido antes que o usuário entrasse na jornada.
Etapa do Canvas inativa	Isso pode ocorrer no Canvas se: A etapa do Canvas foi excluída O Canvas foi interrompido, o que faz com que todas as etapas se tornem inativas
Limite de volume atingido	A campanha atingiu o limite de volume de envios definido, então o envio foi cancelado.

Limite de taxa e tempo

Resultado de aborto	Explicação
Limite de frequência	O usuário já recebeu o número máximo de mensagens permitidas pelas regras de limitação de frequência do seu espaço de trabalho, então o envio foi cancelado.
Aborto por horário de silêncio	O horário de silêncio foi ativado para a campanha ou etapa do Canvas com o fallback definido para Abortar mensagem. O usuário disparou a campanha ou entrou na etapa de Mensagem do Canvas durante o horário de silêncio, então a mensagem foi abortada. No entanto, isso não retira o usuário do Canvas.
Limite de taxa por mais de 72 horas	A mensagem foi limitada por mais de 72 horas devido a limites de taxa de velocidade de entrega, então o envio foi abortado.

Elegibilidade e perfil do usuário

Resultado de aborto	Explicação
Identificador de usuário duplicado	Vários usuários com um identificador correspondente (como ID externo, endereço de e-mail, número de telefone) eram elegíveis para receber esta mensagem. Para evitar envios duplicados para o mesmo usuário, esta mensagem foi abortada.
Usuário falhou na pré-verificação para a etapa de Mensagem	Esta pré-verificação é realizada antes das validações de entrega. Quando isso ocorre, o usuário não atendeu à pré-verificação básica para esta etapa de Mensagem (usuário não encontrado ou inelegível para o canal da etapa de Mensagem). Nota: Para uma etapa de Mensagem multicanal, isso significa que o usuário não foi encontrado; a elegibilidade do canal é verificada aqui apenas para etapas de Mensagem de canal único.
Usuário falhou na pré-verificação para mensagem disparada	Para uma mensagem disparada, a Braze realiza um conjunto inicial de pré-verificações básicas para elegibilidade do público, re-elegibilidade e elegibilidade do canal antes de criar uma mensagem para enviar a partir deste gatilho.
Usuário não mais elegível	O usuário estava inicialmente no público-alvo, mas não correspondia mais aos critérios do público antes que a Braze enviasse a mensagem ou inserisse o usuário no Canvas. O tempo entre o usuário inicialmente atender aos critérios do público e deixar de atendê-los pode ser devido a atrasos de: Intelligent Timing Horário de silêncio Horário local Limites de taxa de velocidade de entrega (não aplicável para entrada no Canvas) Atrasos no pipeline de envio de mensagens
Usuário não elegível para a etapa	O usuário saiu do Canvas porque não atendeu às validações de entrega definidas para a etapa de Mensagem ou porque fazia parte de uma lista de supressão.
Usuário não re-elegível	O usuário estava elegível para receber a mensagem ou entrar no Canvas, mas o envio foi cancelado devido a configurações de re-elegibilidade ou reentrada. Isso pode acontecer se o usuário já recebeu a campanha ou entrou no Canvas muito recentemente, se outro envio para a mesma campanha já estiver em andamento para este usuário, ou se a re-elegibilidade ou reentrada estiver desativada.
Perfil do usuário não encontrado	O usuário nunca existiu ou não existe mais na Braze. Alguns casos comuns incluem: O usuário foi direcionado usando envio de mensagens por API, mas nunca existiu na Braze. O usuário foi excluído antes que a mensagem fosse enviada ou a etapa do Canvas fosse executada. O usuário foi mesclado com outro perfil antes que a mensagem fosse enviada.

Canal e entrega

Resultado de aborto	Explicação
Tempo limite de entrega do parceiro	A Braze tentou enviar esta mensagem para seu parceiro de entrega por 24 horas, mas o parceiro retornou erros temporários durante todo o período.
Credenciais de push inválidas	As credenciais de push para este app estão ausentes ou inválidas, então o envio foi cancelado. Atualize suas credenciais em Configurações do App.
Usuário não habilitado para push Android, app ou dispositivo	Push não pode ser enviado para este usuário. Algumas razões comuns: O usuário não tem o app instalado. O usuário não possui um token por push válido. O usuário não tem o dispositivo necessário para esta notificação por push. O usuário desativou as notificações para este app nas configurações do dispositivo. O usuário não está inscrito ou não optou por receber notificações por push.
Usuário não habilitado para push iOS, app ou dispositivo	Mesma situação que “Usuário não habilitado para push Android, app ou dispositivo”.
Usuário não habilitado para push Kindle, app ou dispositivo	Mesma situação que “Usuário não habilitado para push Android, app ou dispositivo”.
Usuário não habilitado para push para a web, app ou dispositivo	Mesma situação que “Usuário não habilitado para push Android, app ou dispositivo”.
Usuário não habilitado para Cartões de conteúdo	O usuário não usou nenhum app que inclua este cartão de conteúdo.
Usuário não habilitado para e-mail	E-mails não podem ser enviados para este usuário. Algumas razões comuns: O usuário não possui um endereço de e-mail em seu perfil de usuário. O estado de inscrição do usuário o exclui de receber este e-mail. O endereço de e-mail do usuário foi marcado como inválido anteriormente (hard bounce). As mensagens enviadas para este endereço de e-mail são consistentemente marcadas como spam, então o envio foi cancelado.
Usuário não habilitado para LINE	Mensagens do LINE não podem ser enviadas para este usuário. Algumas razões comuns: O usuário não possui um número de telefone em seu perfil de usuário. O número de telefone do usuário foi marcado como inválido devido a falhas de entrega. O estado de inscrição do usuário o exclui de receber esta mensagem. O usuário não possui um ID do LINE.
Usuário não habilitado para SMS/MMS/RCS	Mensagens SMS não podem ser enviadas para este usuário. Algumas razões comuns: O usuário não possui um número de telefone em seu perfil de usuário. O número de telefone do usuário foi marcado como inválido devido a falhas de entrega. O número de telefone do usuário não está no formato E.164 válido, e as tentativas de formatar o número automaticamente falharam. O estado de inscrição do usuário o exclui de receber a mensagem SMS. O número de telefone do usuário está em um país bloqueado.
Usuário não habilitado para WhatsApp	Mensagens do WhatsApp não podem ser enviadas para este usuário. Algumas razões comuns: O usuário não possui um número de telefone em seu perfil de usuário. O número de telefone do usuário foi marcado como inválido devido a falhas de entrega. O estado de inscrição do usuário o exclui de receber esta mensagem. O usuário não possui uma conta do WhatsApp.
Falha no webhook	O webhook recebeu um código de resposta malsucedido (não 2xx). Veja o Registro de Atividade de Mensagens para mais detalhes. Registros com mais de 60 horas são limpos e não estão mais acessíveis; erros de webhook são amostrados em até 20 registros por hora.

Perguntas frequentes

O que significa uma falha de “pré-verificação”?

Uma “pré-verificação” refere-se a uma verificação de validação em alta velocidade e agrupada que é executada no início de uma etapa do pipeline (como uma mensagem sendo disparada ou o envio de uma etapa de Mensagem do Canvas). Pense nisso como uma saída antecipada projetada para máxima velocidade. Em vez de executar muitas verificações separadas e que consomem muitos recursos (como validar cada detalhe do perfil de um usuário), a Braze agrupa várias validações básicas em uma “primeira passada”.

Se um usuário falhar nessa verificação agrupada, ele é descartado imediatamente. Essa abordagem agrupada permite que a Braze processe volumes massivos de mensagens em alta velocidade e pode contribuir para uma performance mais rápida e estável para suas campanhas e canvas, reduzindo a latência de processamento para cada mensagem.

O que significa um resultado de aborto “outro”?

São abortos que não se encaixaram em nenhuma das categorias pré-existentes da Braze. Se você notar uma grande proporção de abortos com esse resultado, entre em contato com o suporte da Braze para obter mais assistência.

Por que a soma de Total de abortos e Envios de mensagens é menor do que o tamanho esperado do público?

Isso pode acontecer por várias razões:

• Critérios de público: Menos usuários do que o esperado podem ter atendido aos critérios de público (por exemplo, não estavam no segmento ou não tinham os atributos necessários) quando a campanha ou Canvas foi lançada.
• Processamento em andamento: As mensagens ainda podem estar sendo processadas ativamente. Os usuários ainda podem estar em etapas anteriores do Canvas e não ter chegado a nenhuma etapa de Mensagem.
• Atualização de dados: Os dados do dashboard são atualizados aproximadamente a cada 15 minutos, mas isso não é garantido. Os dados mais recentes para esta campanha ou Canvas podem não ter chegado ao dashboard ainda.
• Casos extremos: Há uma pequena chance de você estar enfrentando um caso extremo que não está capturado neste dashboard neste momento. Se você suspeitar que este é o caso, entre em contato com o suporte da Braze.

Por que a soma de Total de abortos e Envios de mensagens é maior do que o público para uma campanha e Canvas?

Isso pode ocorrer pelos seguintes motivos:

• Mensagens multicanal: A campanha ou etapa do Canvas foi configurada para enviar em múltiplos canais (como SMS e e-mail). Um único usuário pode receber um resultado de “enviado” para um canal (como e-mail) e um resultado de “aborto” para outro (como “Usuário não habilitado para SMS/MMS/RCS”). Nesse caso, esse único usuário seria contado duas vezes no gráfico: uma vez como “enviado” e outra como “aborto”.
  • Exemplo: Você envia uma campanha push para 100 usuários, direcionando tanto para iOS quanto para Android. Se um usuário tiver apenas um dispositivo iOS, ele recebe o push do iOS (“enviado”), mas também dispara um aborto para o push do Android (“Usuário não habilitado para push Android, app ou dispositivo”).
• Várias etapas de Mensagem (apenas Canvas): Seu Canvas pode ter mais de uma etapa de Mensagem em uma determinada jornada. Este dashboard agrega todos os resultados, então um único usuário pode ser contado várias vezes se passar por várias etapas de Mensagem dentro do período selecionado.
• Mensagens de teste: O envio de teste (que é contado no dashboard) está fazendo com que as contagens totais sejam maiores do que o tamanho do público.