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.
O dashboard Messaging Diagnostics está disponível de forma geral. Entre em contato com seu gerente de sucesso do cliente se tiver interesse em obter acesso ao recurso.
Para acessar o dashboard Messaging Diagnostics, você precisa das permissões de usuário “View Dashboard Reports” e “View PII” no seu espaço de trabalho.
Conceitos-chave
Enviado e entregue
É fundamental entender que este dashboard reporta como a Braze processou internamente uma mensagem, e não o status final de entrega da mensagem.
Uma mensagem marcada como “enviada” neste 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 |
|---|---|
| Content Cards | O cartão foi enviado e está elegível para visualização. |
| A Braze encaminha a mensagem a um provedor de serviços 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. | |
| In-App Messages | A mensagem foi visualizada pelo usuário e uma impressão foi registrada. |
| 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 Apple Push Notification service 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 móvel. |
| Webhooks | A requisição do webhook foi feita com sucesso, retornando uma resposta 2xx. |
| A mensagem foi encaminhada com sucesso a um parceiro de envio. |
Atualização dos 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, na maioria dos casos ela é inferior a uma hora.
Configurando o dashboard
Você pode acessar o dashboard de diagnósticos acessando Analytics > Dashboard Builder e selecionando Messaging Diagnostics na lista de dashboards criados pela Braze.
Para executar o dashboard e visualizar seus dados:
- Escolha Campaigns ou Canvas como a fonte dos seus relatórios do dashboard.
- Selecione uma ou mais Campaigns ou Canvas.
- Selecione Run Dashboard para carregar os dados dos filtros selecionados.
Interpretando os dados
O dashboard exibe apenas os últimos sete dias de dados. Todos os timestamps são exibidos no fuso horário do seu espaço de trabalho.
Blocos de resumo
No topo da página, há blocos de resumo com as principais métricas do período selecionado:
- Enviadas: 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 requisição do webhook foi feita com sucesso, retornando uma resposta
2xx. - Content Cards: O cartão foi enviado e está elegível para visualização.
- In-App Messages: A mensagem foi exibida para o usuário.
- Não enviadas: A contagem total de mensagens que foram interrompidas. Isso inclui membros do público do Canvas que não entraram no Canvas ou saíram do Canvas porque tiveram uma falha em uma etapa ou atenderam aos critérios de saída ao realizar um evento de saída.
Resultados de mensagens ao longo do tempo
Este gráfico de série temporal mostra uma análise por hora dos motivos pelos quais uma mensagem foi interrompida ou por que um usuário foi removido de um Canvas. Os rótulos de resultado neste gráfico são rótulos normalizados do dashboard, não valores brutos do payload do evento. Este gráfico não exibe o número de envios.
Log granular de resultados de mensagens
O dashboard exibe uma tabela granular de resultados individuais de mensagens para os filtros e o período selecionados. Use esta tabela para revisar registros específicos, incluindo timestamp, ID do usuário, etapa do Canvas, resultado, detalhes e canal.
Você pode filtrar a tabela para focar em registros específicos:
- Filtrar por resultado: Selecione um resultado no filtro de resultados para exibir apenas as linhas com esse resultado (por exemplo,
Frequency cappedouUser not eligible for channel). - Pesquisar por ID do usuário: Insira um ID de usuário no campo de pesquisa para exibir as linhas desse usuário específico.
Quando você aplica ambos os filtros, a tabela retorna as linhas que correspondem tanto ao resultado selecionado quanto ao ID do usuário inserido.
Selecione uma linha na tabela para abrir o painel de detalhes. O painel de detalhes fornece contexto adicional sobre o resultado, e o Ask Operator oferece orientações de correção para ajudar você a solucionar o problema subjacente.
Os filtros de canal se aplicam a resultados vinculados a um canal de envio de mensagens específico. Alguns resultados são independentes de canal, então ainda podem aparecer em visualizações agregadas mesmo quando você aplica um filtro de canal.
Resultados de interrupção
As definições a seguir explicam os resultados de interrupção exibidos no dashboard. Os resultados são agrupados por categoria para facilitar a localização do que você está investigando.
Os resultados de interrupção no Messaging Diagnostics são rótulos legíveis do dashboard. Nos eventos de engajamento com mensagem do Currents, as informações de interrupção são representadas com campos como abort_type e abort_log. Como esses conjuntos de dados têm representações e caminhos de processamento diferentes, as contagens ou nomenclaturas podem diferir entre o Currents e o Messaging Diagnostics.
Conteúdo e renderização
| Resultado de interrupção | Explicação |
|---|---|
| Content Card expirado | O Content Card expirou antes que o usuário o visse. |
| Content Card inválido | O Content Card continha erros e não foi enviado ao usuário. Alguns motivos comuns incluem:
|
| Falha no Connected Content | A Braze tentou enviar a mensagem, mas o Connected Content falhou após o número máximo de tentativas (o padrão é cinco). Nota: Essa contagem representa o número de mensagens interrompidas por atingir o número máximo de tentativas, não o total de requisições de Connected Content que falharam. |
| Tempo limite de renderização de mensagem no app | Após múltiplas tentativas, o Liquid não pôde ser renderizado e atingiu o tempo limite. |
| Interrupção por Liquid | A tag Liquid abort_message foi chamada, então o envio foi cancelado. |
| Tempo limite de renderização do Liquid | A renderização do modelo Liquid demorou demais. Mais provável de ocorrer em 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. |
| Falha na URL de mídia | A Braze não conseguiu processar a URL de mídia na mensagem. Isso pode acontecer quando a URL está bloqueada, é inválida, atinge o tempo limite, retorna um status HTTP inválido ou falha na validação SSL. |
Estado de Campaign e Canvas
| Resultado de interrupção | Explicação |
|---|---|
| Falha na etapa de postergação | A etapa de postergação falhou, fazendo o usuário sair do Canvas. Essa falha pode acontecer quando:
|
| Evento de exceção ou saída | O usuário era previamente elegível para receber a mensagem, mas:
|
| Campaign inativa | A Campaign foi interrompida enquanto a mensagem estava em trânsito, então foi cancelada. |
| Canvas inativo | O Canvas foi interrompido antes que o usuário entrasse na jornada. |
| Etapa do Canvas inativa | Isso pode ocorrer no Canvas se:
|
| Limite de volume atingido | A Campaign atingiu o limite de volume de envios definido, então o envio foi cancelado. |
Limite de frequência e timing
| Resultado de interrupção | Explicação |
|---|---|
| Limite de frequência atingido | 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. |
| Interrupção por horário de silêncio | O horário de silêncio estava ativado para a Campaign ou etapa do Canvas com o fallback definido como Interromper mensagem. O usuário disparou a Campaign ou entrou na etapa de mensagem do Canvas durante o horário de silêncio, então a mensagem foi interrompida. No entanto, isso não remove o usuário do Canvas. |
| Limite de frequência excedido por mais de 72 horas | A mensagem foi limitada por mais de 72 horas devido aos limites de velocidade de entrega, então o envio foi cancelado. |
Elegibilidade e perfil do usuário
| Resultado de interrupção | Explicação |
|---|---|
| Identificador de usuário duplicado | 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 para o mesmo usuário, esta mensagem foi interrompida. |
| Usuário falhou na pré-verificação da etapa de mensagem | A Braze executa um conjunto inicial de pré-verificações básicas de elegibilidade de público, reelegibilidade e elegibilidade de canal antes das validações completas de entrega para uma etapa de mensagem do Canvas. Este resultado significa que o usuário ou a mensagem falhou em uma dessas verificações, então a mensagem foi interrompida para essa etapa. |
| Usuário falhou na pré-verificação de mensagem disparada | A Braze executa um conjunto inicial 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 deste disparo. Este resultado significa que o usuário ou a mensagem falhou em uma dessas verificações, então a mensagem foi interrompida. |
| Usuário não é mais elegível | O usuário estava inicialmente no público-alvo, mas não correspondia mais aos critérios de público antes que a Braze enviasse a mensagem ou inserisse o usuário no Canvas. O tempo entre o usuário atender inicialmente aos critérios de público e deixar de atendê-los pode ser devido a atrasos de:
|
| Usuário não elegível para a etapa | O usuário não atendeu às validações de entrega definidas para a etapa de mensagem ou fazia parte de uma lista de supressão. Dependendo das configurações de Validações de entrega, o usuário pode ter saído do Canvas ou avançado para a próxima etapa. |
| Usuário não reelegível | 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 Campaign ou entrou no Canvas recentemente, se outro envio da mesma Campaign já está em andamento para este usuário, ou se a reelegibilidade ou reentrada está desativada. |
| Perfil de usuário não encontrado | O usuário nunca existiu ou não existe mais na Braze. Alguns casos comuns incluem:
|
Canal e entrega
| Resultado de interrupção | Explicação |
|---|---|
| Erro de entrega do parceiro | A Braze tentou enviar esta mensagem ao seu parceiro de entrega por 24 horas, mas o parceiro retornou erros temporários durante toda a janela. |
| 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 App Settings. |
| Falha no grupo de inscrições | A mensagem não pôde ser enviada devido a problemas de configuração do grupo de inscrições ou do serviço de envio de mensagens. Motivos comuns incluem números de envio ausentes para SMS ou WhatsApp, ou MMS não suportado no serviço de envio de mensagens configurado. |
| Usuário não elegível para o canal | O usuário não é elegível para receber esta mensagem no canal selecionado. Motivos comuns incluem identificadores de canal ausentes ou inválidos, nenhum token de push elegível, restrições de estado de inscrição, capacidade de canal não suportada ou países bloqueados para canais baseados em telefone. |
| Falha no webhook | O webhook recebeu um código de resposta sem sucesso (diferente de 2xx). Códigos de erro comuns podem ser erros de cliente 4XX, erro de servidor ou tempo limite 5XX, ou 598 Host Unhealthy ou requisições interrompidas brevemente. |
Perguntas frequentes
O que significa uma falha de “pré-verificação”?
Uma “pré-verificação” se refere a uma validação rápida e agrupada que é executada logo no início de uma etapa do pipeline (como o disparo de uma mensagem 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 várias verificações separadas e que consomem muitos recursos (como validar cada detalhe do perfil de um usuário), a Braze agrupa diversas validações básicas em uma única “primeira passagem”.
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 um desempenho mais rápido e estável das suas Campaigns e Canvas, reduzindo a latência de processamento de cada mensagem.
O que significa um resultado de interrupção “outro”?
São interrupções que não se enquadram nas categorias existentes do dashboard. Se você ainda notar uma grande proporção de interrupções com “Outro”, entre em contato com o suporte da Braze para obter mais assistência.
Por que a soma de Não enviadas e Enviadas é menor do 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 Segment ou não tinham os atributos necessários) quando a Campaign 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 alcançado 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 dessa Campaign 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 Não enviadas e Enviadas é maior do que o público de uma Campaign e Canvas?
Isso pode ocorrer pelos seguintes motivos:
- Mensagens multicanal: A Campaign 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 “enviada” para um canal (como e-mail) e um resultado de “interrupção” para outro (como “Usuário não elegível para o canal”). Nesse caso, esse único usuário seria contado duas vezes no gráfico: uma vez como “enviada” e uma vez como “interrupção”.
- Exemplo: Você envia uma Campaign de push para 100 usuários, direcionando tanto iOS quanto Android. Se um usuário tiver apenas um dispositivo iOS, ele recebe o push do iOS (“enviada”), mas também dispara uma interrupção para o push do Android (“Usuário não elegível para o canal”).
- Múltiplas etapas de mensagem (somente 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 múltiplas etapas de mensagem dentro do intervalo de tempo selecionado.
- Mensagens de teste: O envio de testes (que é contabilizado no dashboard) está fazendo com que as contagens totais sejam maiores do que o tamanho do público.