Dashboard de diagnóstico de envio de mensagens

O dashboard Messaging Diagnostics oferece uma visão geral dos resultados de envio de mensagens, permitindo que você identifique tendências e diagnostique possíveis problemas na sua configuração de envio de mensagens. Esse dashboard pode ajudar a entender por que as mensagens de suas campanhas ou Canvas podem não ter sido enviadas conforme o esperado.

Conceitos principais

Enviado e entregue

É fundamental entender que esse dashboard relata como a Braze processou internamente uma mensagem, e não o status final de entrega da mensagem.

Uma mensagem marcada como “enviada” nesse dashboard significa que a Braze processou e despachou a mensagem com sucesso. Para a maioria dos canais, isso significa que a Braze encaminhou 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 exemplos a seguir 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 encaminha a mensagem a um provedor de serviço de e-mail (ESP). O ESP é então responsável pela entrega final. Esse ESP, por exemplo, pode reportar 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 exibida ao usuário.
LINE	A mensagem foi encaminhada com sucesso a um parceiro de envio.
Push	A Braze encaminha 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 encaminha a mensagem a um gateway de SMS (como o Twilio). Esse gateway é responsável pela entrega final à operadora de celular.
Webhooks	A solicitação de webhook foi feita com sucesso, retornando uma resposta 2xx.
WhatsApp	A mensagem foi encaminhada com sucesso a um parceiro de envio.

Atualização dos dados

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

Configurando o dashboard

Você pode acessar o dashboard de diagnóstico em Analytics > Criador de dashboard e selecionando Messaging Diagnostics na lista de dashboards criados pela Braze.

Para executar o dashboard e visualizar seus dados:

1. Escolha Campaigns ou Canvases como a origem dos relatórios do seu dashboard.
2. Selecione uma ou mais campanhas ou Canvas.
3. Selecione Run Dashboard para carregar os dados dos filtros selecionados.

Interpretando os dados

Blocos de resumo

No topo da página, há blocos de resumo com as principais métricas do período selecionado:

• Total Aborts: 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 dele porque tiveram uma falha em uma etapa ou atenderam aos critérios de saída ao realizar um evento de saída.
• Message Sends: 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 encaminhada com sucesso a um parceiro de envio.
  • Webhooks: A solicitação de 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 ao usuário.

Resultados de mensagens ao longo do tempo

Este gráfico de série temporal mostra um detalhamento 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.

Detalhamento dos resultados de mensagens

Este gráfico mostra o detalhamento de todos os resultados de 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.
• O detalhamento proporcional de cada motivo de aborto e remoção. Isso ajuda 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 exibidos 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
Content Card expired	O cartão de conteúdo expirou antes que o usuário o visse.
Content Card invalid	O cartão de conteúdo continha erros e não foi enviado ao usuário. Alguns motivos comuns incluem: Tamanho máximo excedido (2 KB) Data de expiração inválida A mensagem contém caracteres inválidos
Connected Content failed	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: Essa 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.
In-app-message rendering timeout	Após múltiplas tentativas, o Liquid não pôde ser renderizado e atingiu o tempo limite.
Liquid abort	A Liquid tag abort_message foi chamada, então o envio foi cancelado.
Liquid rendering timeout	A renderização do modelo Liquid demorou demais. Isso ocorre com mais frequência em Banners, mensagens no app e e-mail.
Liquid syntax error	O modelo Liquid continha um erro de sintaxe, então a mensagem foi cancelada.

Estado da campanha e do Canvas

Resultado de aborto	Explicação
Delay step failure	A etapa de postergação falhou, fazendo o usuário sair do Canvas. Essa falha pode ocorrer quando: A variável fornecida à etapa de postergação personalizada estava vazia ou era de um tipo inválido A postergação ultrapassa a duração máxima permitida no Canvas
Exception or exit event	O usuário era 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 e foi removido no meio da jornada.
Inactive campaign	A campanha foi interrompida enquanto a mensagem estava em trânsito, então foi abortada.
Inactive Canvas	O Canvas foi interrompido antes que o usuário entrasse na jornada.
Inactive Canvas step	Isso pode ocorrer no Canvas se: A etapa do Canvas foi excluída O Canvas foi interrompido, fazendo com que todas as etapas se tornassem inativas
Volume limited	A campanha atingiu o limite de volume de envios definido, então o envio foi cancelado.

Limite de taxa e temporização

Resultado de aborto	Explicação
Frequency capped	O usuário já recebeu o número máximo de mensagens permitido pelas regras de limite de frequência do seu espaço de trabalho, então o envio foi cancelado.
Quiet Hours abort	O horário de silêncio estava ativado para a campanha ou etapa do Canvas com o fallback definido como Abort message. 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 remove o usuário do Canvas.
Rate limited over 72 hours	A mensagem foi limitada por mais de 72 horas devido aos limites de velocidade de entrega, então o envio foi abortado.

Elegibilidade e perfil do usuário

Resultado de aborto	Explicação
Duplicate user identifier	Múltiplos 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 ao mesmo usuário, esta mensagem foi abortada.
User failed pre-check for Message step	Essa pré-verificação é executada 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 não elegí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 só é verificada aqui para etapas de mensagem de canal único.
User failed pre-check for triggered message	Para uma mensagem disparada, a Braze executa um primeiro conjunto de pré-verificações básicas de elegibilidade de público, reelegibilidade e elegibilidade de canal antes de criar uma mensagem para enviar a partir desse gatilho.
User no longer eligible	O usuário estava inicialmente no público-alvo, mas deixou de atender aos critérios do público antes que a Braze enviasse a mensagem ou inserisse o usuário no Canvas. O intervalo entre o usuário atender inicialmente aos critérios do público e deixar de atendê-los pode ser causado por atrasos de: Intelligent Timing Horário de silêncio Horário local Limites de velocidade de entrega (não aplicável para entrada no Canvas) Atrasos no pipeline de envio de mensagens
User not eligible for step	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.
User not re-eligible	O usuário era elegível para receber a mensagem ou entrar no Canvas, mas o envio foi cancelado devido às configurações de reelegibilidade ou reentrada. Isso pode acontecer se o usuário já recebeu a campanha ou entrou no Canvas recentemente, se outro envio da mesma campanha já está em andamento para esse usuário, ou se a reelegibilidade ou reentrada está desativada.
User profile not found	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
Partner delivery timeout	A Braze tentou enviar esta mensagem ao seu parceiro de entrega por 24 horas, mas o parceiro retornou erros temporários durante todo o período.
Push credentials invalid	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.
User not enabled for Android push, app, or device	Não é possível enviar push para este usuário. Alguns motivos comuns: O usuário não tem o app instalado. O usuário não tem 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.
User not enabled for iOS push, app, or device	Mesmo que o resultado de aborto “User not enabled for Android push, app, or device”.
User not enabled for Kindle push, app, or device	Mesmo que o resultado de aborto “User not enabled for Android push, app, or device”.
User not enabled for web push, app, or device	Mesmo que o resultado de aborto “User not enabled for Android push, app, or device”.
User not enabled for Content Cards	O usuário não utilizou nenhum app que inclua este cartão de conteúdo.
User not enabled for email	Não é possível enviar e-mails para este usuário. Alguns motivos comuns: O usuário não tem um endereço de e-mail no 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 anteriormente como inválido (hard bounce). Mensagens enviadas para este endereço de e-mail são consistentemente marcadas como spam, então o envio foi cancelado.
User not enabled for LINE	Não é possível enviar mensagens LINE para este usuário. Alguns motivos comuns: O usuário não tem um número de telefone no 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 tem um ID LINE.
User not enabled for SMS/MMS/RCS	Não é possível enviar mensagens SMS para este usuário. Alguns motivos comuns: O usuário não tem um número de telefone no 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á em um formato E.164 válido, e as tentativas de formatação automática 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.
User not enabled for WhatsApp	Não é possível enviar mensagens WhatsApp para este usuário. Alguns motivos comuns: O usuário não tem um número de telefone no 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 tem uma conta WhatsApp.
Webhook failed	O webhook recebeu um código de resposta malsucedido (não 2xx). Consulte o Registro de atividades de envio de mensagem 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” é uma verificação de validação rápida 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 única “primeira passagem”.

Se um usuário falhar nessa verificação agrupada, ele é removido 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 das suas campanhas e Canvas, reduzindo a latência de processamento de cada mensagem.

O que significa um resultado de aborto “other”?

São abortos que não se enquadraram 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 Aborts e Message Sends é menor que o tamanho esperado do meu público?

Isso pode acontecer por vários motivos:

• 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 o Canvas foi lançado.
• Processamento em andamento: As mensagens ainda podem estar sendo processadas. Os usuários podem ainda estar em etapas anteriores do Canvas e não ter chegado a nenhuma etapa de mensagem.
• Atualização dos dados: Os dados do dashboard são atualizados aproximadamente a cada 15 minutos, mas isso não é garantido. Os dados mais recentes desta campanha ou Canvas podem ainda não ter chegado ao dashboard.
• Casos extremos: Há uma pequena chance de você estar encontrando um caso extremo que não é capturado neste dashboard no momento. Se você suspeitar que esse é o caso, entre em contato com o suporte da Braze.

Por que a soma de Total Aborts e Message Sends é maior que o público de 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 “User not enabled for SMS/MMS/RCS”). Nesse caso, esse único usuário seria contado duas vezes no gráfico: uma vez como “enviado” e uma vez como “aborto”.
  • Exemplo: Você envia uma campanha de push para 100 usuários, direcionando tanto iOS quanto Android. Se um usuário tem apenas um dispositivo iOS, ele recebe o push iOS (“enviado”), mas também dispara um aborto para o push Android (“User not enabled for Android push, app, or device”).
• Múltiplas 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 múltiplas vezes se passar por múltiplas etapas de mensagem dentro do período selecionado.
• Mensagens de teste: O envio de testes (que é contabilizado no dashboard) está fazendo com que as contagens totais sejam maiores que o tamanho do público.