Observabilidade de Mensagens
A Observabilidade de Mensagens rastreia eventos em seu Canvas ou Campaign para que você possa auditar e solucionar problemas no envio de mensagens. Use-a para identificar tendências, ver como os usuários avançam em um Canvas e diagnosticar por que as mensagens podem não ter sido enviadas como esperado.
Pré-requisitos
Para acessar o Messaging Observability, você precisa da permissão “View Dashboard Reports” para seu espaço de trabalho.
Principais conceitos
Enviado e entregue
Este dashboard mostra 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. Na maioria dos canais, isso quer dizer que a Braze repassou a mensagem ao parceiro de envio terceirizado correspondente. No entanto, isso não garante a entrega final no dispositivo do usuário.
Quando a Braze “envia” uma mensagem, a entrega final pode depender de serviços externos. Confira os exemplos a seguir para cada canal.
| Canal | Exemplo de entrega final |
|---|---|
| Banners | O Banner foi enviado e está elegível para visualização. |
| Content Cards | O cartão foi enviado e está elegível para visualização. |
| A Braze repassa a mensagem a um provedor de serviços de e-mail (ESP). Então, o ESP fica responsável pela entrega final. Esse ESP pode, por exemplo, informar um “bounce” se o endereço de e-mail for inválido ou se a caixa de entrada estiver cheia. | |
| Mensagens no app | A mensagem foi visualizada pelo usuário e uma impressão foi registrada. |
| KakaoTalk | A mensagem foi repassada com sucesso a um parceiro de envio. |
| LINE | A mensagem foi repassada com sucesso a um parceiro de envio. |
| Push | A Braze repassa a mensagem ao serviço de notificação por push adequado (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 no dispositivo. |
| SMS/MMS/RCS | A Braze repassa a mensagem a um gateway de SMS (como a Twilio). Esse gateway é responsável pela entrega final à operadora de telefonia móvel. |
| Webhooks | A solicitação de webhook foi feita com sucesso e retornou uma resposta 2xx. |
| A mensagem foi repassada com sucesso a um parceiro de envio. |
Eventos de progressão do Canvas
Para Canvas, o Messaging Observability também mostra eventos de progressão: registros de como os usuários avançam pela jornada, como entrar no Canvas, entrar em uma etapa ou sair do Canvas. Os eventos de progressão são separados dos resultados de envio de mensagens. Eles ajudam você a ver em que ponto do Canvas os usuários estão.
Atualização dos dados
A frequência de atualização dos dados neste dashboard pode variar conforme a carga do sistema. Embora a frequência de atualização não seja garantida, na maioria dos casos ela provavelmente é inferior a uma hora.
Configurar o dashboard
Abra o Messaging Observability a partir de um destes locais:
- Acesse Analytics > Dashboard Builder e selecione Messaging Observability na lista de dashboards criados pela Braze.
- Em uma página de análise de dados de Canvas ou campanha, selecione Messaging Observability. Quando disponível, o dashboard abre com esse Canvas ou campanha já pré-selecionado.
Para executar o dashboard e visualizar seus dados:
- Selecione uma data ou um intervalo de datas de até os últimos sete dias.
- Selecione Campaigns ou Canvases como a fonte para os relatórios do seu dashboard.
- Selecione uma campanha ou um Canvas.
- (Opcional, somente para Canvas) Selecione uma ou mais etapas do Canvas para restringir os resultados a essas etapas.
- Selecione Run dashboard para carregar os dados dos filtros selecionados.
Depois de alterar qualquer filtro, selecione Run dashboard novamente para atualizar os blocos de resumo, o gráfico e o registro de eventos. Até que você faça isso, o dashboard poderá exibir um alerta “Outdated results”.
Interprete os dados
O dashboard mostra até os últimos sete dias de dados. Todos os registros de data e hora aparecem no fuso horário do seu espaço de trabalho.
Blocos de resumo
No topo da página, os blocos de resumo do período selecionado mostram:
- Entradas: Todas as entradas elegíveis em Canvas ou Campaign avaliadas no intervalo de tempo selecionado. Essas contagens podem diferir um pouco da visualização de análise de dados, porque o Messaging Observability usa dados de solução de problemas de fontes diferentes.
- Supressões: Mensagens que a Braze deixou de enviar intencionalmente após a entrada, por exemplo por elegibilidade, limite de frequência ou horário de silêncio. Para mais detalhes, consulte Supressões.
- Falhas: Mensagens que falharam de forma inesperada, como erros de Liquid, webhook ou push. Para mais detalhes, consulte Falhas.
- Enviadas: Mensagens que saíram com sucesso do processamento da Braze. Isso não garante a entrega ao destinatário. A entrega depende do canal, da operadora e do dispositivo. Para mais detalhes, consulte Enviadas e entregues.
Eventos ao longo do tempo
Esse gráfico de série temporal mostra um detalhamento por hora dos eventos para os filtros selecionados. Use as visualizações do gráfico para comparar os totais da visão geral ou para detalhar supressões e falhas por resultado. Os rótulos de resultado nesse gráfico são rótulos normalizados do dashboard, e não valores brutos da carga útil do evento.
Registro de eventos
O Registro de eventos lista os eventos individuais que a Braze registrou para cada usuário de acordo com os filtros e o intervalo de tempo selecionados, principalmente supressões, progressões e falhas. Use-o para revisar registros específicos, incluindo data e hora, ID do usuário, etapa do Canvas, evento, descrição e canal de envio de mensagens.
Filtre a tabela para focar em registros específicos:
- Selecione categorias de eventos ou eventos individuais no filtro Eventos (por exemplo, Supressões > Limite de frequência atingido ou Progressões > Entrou na etapa).
- Insira um ID de usuário no campo de pesquisa para mostrar as linhas desse usuário.
Quando você aplica os dois filtros, a tabela retorna as linhas que correspondem tanto aos eventos selecionados quanto ao ID de usuário inserido.
Selecione Visualizar em uma linha para abrir um painel lateral com mais contexto sobre esse evento. No painel, você também pode selecionar Perguntar ao Operator para receber orientações de correção.
Os filtros de canal se aplicam a eventos vinculados a um canal de envio de mensagens específico. Alguns eventos não dependem de canal, então ainda podem aparecer nas visualizações agregadas mesmo quando você aplica um filtro de canal.
Eventos de progressão
Os eventos de progressão descrevem como os usuários avançam por um Canvas. Eles existem apenas para Canvas. A entrada em Campaign aparece em Entradas como Entrou na Campaign.
Os rótulos de eventos de progressão no Messaging Observability são rótulos do dashboard fáceis de ler. As contagens ou os nomes podem diferir de outras áreas de análise de dados da Braze, porque esses conjuntos de dados têm representações e fluxos de processamento diferentes.
| Evento de progressão | Explicação |
|---|---|
| Entrou no Canvas | O usuário entrou no Canvas. A entrada pode ser programada, baseada em ação ou disparada por API. Usuários inscritos em um grupo de controle também podem aparecer com esse rótulo. |
| Entrou na etapa de jornadas de ação | O usuário entrou em uma etapa de jornadas de ação e seguiu uma jornada após uma ação (ou a jornada “todos os outros”). |
| Entrou na etapa de agente | O usuário entrou em uma etapa de agente em que o contexto foi avaliado. |
| Entrou na etapa de jornadas do público | O usuário entrou em uma etapa de jornadas do público e seguiu uma jornada do público (ou a jornada “todos os outros”). |
| Entrou na etapa de sincronização de público | O usuário entrou em uma etapa de sincronização de público e a sincronização do público começou. |
| Entrou na etapa do Otimizador de Conteúdo | O usuário entrou em uma etapa do Otimizador de Conteúdo e uma variante foi selecionada. |
| Entrou na etapa de contexto | O usuário entrou em uma etapa de contexto em que variáveis de contexto foram definidas ou avaliadas. |
| Entrou na etapa de divisão de decisão | O usuário entrou em uma etapa de divisão de decisão e seguiu uma ramificação. |
| Entrou na etapa de postergação | O usuário entrou em uma etapa de postergação e está aguardando, avançando imediatamente (por exemplo, com uma postergação zero) ou progredindo de outra forma nessa etapa. |
| Entrou na etapa de jornadas experimentais | O usuário entrou em uma etapa de jornadas experimentais e foi atribuído a uma variante do experimento. |
| Entrou na etapa de Feature Flag | O usuário entrou em uma etapa de Feature Flag e os Feature Flags estão sendo avaliados. |
| Entrou na etapa de mensagem | O usuário entrou em uma etapa de mensagem. Supressões, falhas ou envios posteriores dessa etapa aparecem como eventos separados. |
| Entrou na etapa de envio ao destino | O usuário entrou em uma etapa de envio ao destino. A Braze está verificando se ele se qualifica para entrar no Canvas de destino. |
| Entrou na etapa de atualização de usuário | O usuário entrou em uma etapa de atualização de usuário. Os atributos do usuário estão sendo atualizados ou o usuário está temporariamente postergado pelo limite de frequência da atualização de usuário. |
| Enviado ao destino | O usuário foi enviado ao Canvas de destino e passou para a próxima etapa do Canvas atual. |
| Não enviado ao destino | O usuário não entrou no Canvas de destino (por exemplo, por incompatibilidade de público) e passou para a próxima etapa do Canvas atual. |
| Destino não encontrado | O Canvas de destino não foi encontrado. O usuário passou para a próxima etapa do Canvas atual. |
| Saiu do Canvas | O usuário saiu do Canvas. Isso acontece quando:
|
Supressões
As supressões são não envios intencionais após a entrada, motivados por configurações, elegibilidade ou controles de entrega.
Os rótulos de supressão e falha no Messaging Observability são rótulos do dashboard fáceis de ler. Nos eventos de engajamento com mensagem do Currents, as informações de interrupção são representadas por campos como abort_type e abort_log. Como esses conjuntos de dados têm representações e fluxos de processamento diferentes, as contagens ou os nomes podem diferir entre o Currents e o Messaging Observability.
Configurações de envio
| Supressão | Explicação |
|---|---|
| Interrompida devido à prioridade | O envio foi interrompido porque outra mensagem de prioridade mais alta para esse usuário já estava pendente, ou porque essa mensagem perdeu prioridade. |
| Banner expirado | O banner expirou antes de poder ser enviado. |
| Cartão de conteúdo expirado | O cartão de conteúdo expirou antes de o usuário visualizá-lo. |
| Variante do Otimizador de Conteúdo desativada | A atribuição de variante do Otimizador de Conteúdo foi desativada antes do envio. |
| 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. |
| Campaign inativa | A Campaign foi interrompida enquanto a mensagem estava em andamento, então ela foi interrompida. |
| Canvas inativo | O Canvas foi interrompido antes de o usuário entrar na jornada. |
| Etapa do Canvas inativa | Isso pode ocorrer no Canvas se:
|
| 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 faz o usuário sair do Canvas. |
| Limite de volume atingido | A Campaign ou o Canvas atingiu o limite de volume de envios definido, então o envio foi cancelado. |
Elegibilidade do usuário
| Supressão | Explicação |
|---|---|
| Identificador de usuário duplicado | Vários usuários com um identificador correspondente (como ID externo, endereço de e-mail ou número de telefone) estavam elegíveis para receber essa mensagem. Para evitar envios duplicados ao mesmo usuário, essa mensagem foi interrompida. |
| Evento de exceção ou de saída | O usuário estava elegível para receber a mensagem, mas
|
| Usuário reprovado 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 de uma etapa de mensagem do Canvas. Esse resultado significa que o usuário ou a mensagem não passou em uma dessas verificações, então a mensagem foi interrompida nessa etapa. |
| Usuário reprovado na pré-verificação da 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 desse gatilho. Esse resultado significa que o usuário ou a mensagem não passou em uma dessas verificações, então a mensagem foi interrompida. |
| Usuário não está mais elegível | O usuário estava inicialmente no público-alvo, mas deixou de atender aos critérios do público antes de a Braze enviar a mensagem ou incluí-lo no Canvas. O tempo entre o usuário atender inicialmente aos critérios do público e sair dele pode ser causado por atrasos de:
|
| Usuário não elegível para o canal | O usuário não está elegível para receber essa mensagem no canal selecionado. Os motivos comuns incluem identificadores de canal ausentes ou inválidos, nenhum token por push elegível, restrições de estado de inscrição, recurso de canal não compatível ou países bloqueados para canais baseados em telefone. |
| 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 seguido para a próxima etapa. |
| Usuário não reelegível | O usuário estava elegível para receber a mensagem ou entrar no Canvas, mas o envio foi cancelado por causa das configurações de reelegibilidade ou reentrada. Isso pode acontecer se o usuário já recebeu a Campaign ou entrou no Canvas recentemente demais, se outro envio da mesma Campaign já estiver em andamento para esse usuário ou se a reelegibilidade ou a reentrada estiver desativada. |
Falhas
Falhas são erros inesperados durante o processamento ou as tentativas de entrega.
| Falha | Explicação |
|---|---|
| Falha no Connected Content | A Braze tentou enviar a mensagem, mas o Connected Content falhou após o número máximo de novas tentativas (o padrão é cinco). Essa contagem representa o número de mensagens interrompidas por atingirem o número máximo de novas tentativas, e não o total de solicitações de Connected Content com falha. |
| Cartão de conteúdo inválido | O cartão de conteúdo tinha erros e não foi enviado ao usuário. Alguns motivos comuns incluem:
|
| Falha na etapa de postergação | A etapa de postergação falhou, fazendo o usuário sair do Canvas. Essa falha pode acontecer quando:
|
| Interrupção por Liquid | A Liquid tag 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 que ocorra em banners, mensagens no app e e-mails. |
| Erro de sintaxe do Liquid | O modelo Liquid tinha 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. |
| Erro de entrega do parceiro | A Braze tentou enviar essa mensagem ao seu parceiro de entrega por 24 horas, mas o parceiro retornou erros temporários durante todo esse período. |
| Recomendação do produto inválida | A recomendação do produto ou a seleção do catálogo não pôde ser usada nesse envio. Os motivos comuns incluem uma recomendação ausente ou arquivada, treinamento incompleto ou filtros que removeram todos os itens do catálogo. |
| Credenciais de push inválidas | As credenciais de push desse app estão ausentes ou são inválidas, então o envio foi cancelado. Atualize suas credenciais em Configurações do app. |
| Limite de frequência por mais de 72 horas | A mensagem foi limitada por mais de 72 horas devido aos limites de frequência de velocidade de entrega, então o envio foi interrompido. |
| Falha no grupo de inscrições | Não foi possível enviar a mensagem por problemas de configuração do grupo de inscrições ou do serviço de envio de mensagens. Os motivos comuns incluem números de envio ausentes para SMS ou WhatsApp, ou MMS não compatível no serviço de envio de mensagens configurado. |
| Perfil de usuário não encontrado | O usuário nunca existiu ou não existe mais na Braze. Alguns casos comuns incluem:
|
| Falha no webhook | O webhook recebeu um código de resposta sem sucesso (diferente de 2xx). Os códigos de erro comuns podem ser erros de cliente 4XX, erro de servidor ou tempo limite 5XX, ou 598 Host Unhealthy ou solicitações brevemente interrompidas. |
| Outras | Falhas que não se encaixam nas outras categorias desta tabela. Se você notar uma grande proporção de falhas do tipo Outras, entre em contato com o suporte da Braze para receber ajuda. |
Perguntas frequentes
O que significa uma falha de “pré-verificação”?
Uma “pré-verificação” é uma checagem de validação agrupada e de alta velocidade que é executada logo no início de um estágio do pipeline (como quando uma mensagem é disparada ou quando uma etapa de mensagem do Canvas é enviada). Pense nela como uma saída antecipada projetada para máxima velocidade. Em vez de executar várias checagens 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 checagem agrupada, ele é descartado imediatamente. Essa abordagem permite que a Braze processe volumes enormes de mensagens em alta velocidade. Ela também pode contribuir para uma performance mais rápida e estável das suas Campaigns e Canvas, já que reduz a latência de processamento de cada mensagem.
O que significa uma falha do tipo “Outro”?
São falhas que não se encaixam nas categorias existentes do dashboard. Se você ainda notar uma proporção grande de falhas do tipo Outro, entre em contato com o suporte da Braze para obter mais ajuda.
Por que Entradas, Supressões, Falhas e Enviadas não somam o tamanho de público que eu esperava?
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, eles 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 ou etapas do Canvas ainda podem estar sendo processadas. Os usuários podem estar em etapas anteriores do Canvas e ainda não ter chegado a nenhuma etapa de mensagem.
- Progressão sem envio: Os usuários podem gerar eventos de progressão (como entrar em uma etapa de postergação ou de divisão de decisão) sem uma supressão, falha ou envio correspondente na mesma janela.
- 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 Campaign ou deste Canvas podem ainda não ter chegado ao dashboard.
- Casos extremos: Há uma pequena chance de você estar diante de um caso extremo que ainda não é registrado neste dashboard. Se suspeitar disso, entre em contato com o suporte da Braze.
Por que os totais dos blocos ou do registro de eventos podem ser maiores do que o público de uma Campaign ou de um Canvas?
Isso pode ocorrer pelos seguintes motivos:
- Mensagens multicanal: A Campaign ou a etapa do Canvas foi configurada para enviar em vários canais (como SMS e e-mail). Um único usuário pode receber um resultado “enviado” em um canal (como e-mail) e uma supressão ou falha em outro (como “Usuário não elegível para o canal”). Nesse caso, esse usuário é contado mais de uma vez nos blocos e no registro de eventos.
- Por exemplo, você envia uma campanha de push para 100 usuários, direcionada para iOS e Android. Se um usuário tiver apenas um dispositivo iOS, ele recebe o push do iOS (“enviado”), mas também gera uma supressão para o push do Android (“Usuário não elegível para o canal”).
- Várias etapas de mensagem (somente Canvas): Seu Canvas pode ter mais de uma etapa de mensagem em uma mesma jornada. Este dashboard agrega todos os eventos. Portanto, um único usuário pode ser contado várias vezes se passar por várias etapas dentro do intervalo de tempo selecionado.
- Mensagens de teste: Os envios de teste (que são contabilizados no dashboard) podem deixar os totais maiores do que o tamanho do público.