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 “Visualizar relatórios do dashboard” 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 dessa mensagem.
Uma mensagem marcada como “enviada” neste dashboard foi processada e despachada com sucesso pela Braze. Na maioria dos canais, isso significa que a Braze repassou a mensagem ao parceiro de envio terceirizado correspondente. Mas 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. Veja 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. Eles registram como os usuários avançam pela jornada, por exemplo, ao 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 e 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 de acordo com a carga do sistema. Embora essa frequência não seja garantida, na maioria dos casos ela provavelmente fica abaixo de 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. O dashboard abre com esse Canvas ou campanha pré-selecionado, quando disponível.
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 fonte para os relatórios do seu dashboard.
- Selecione uma campanha ou um Canvas.
- (Opcional, apenas 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 Event log. Até que você faça isso, o dashboard poderá exibir um alerta “Outdated results”.
Interpretar os dados
O dashboard mostra até os últimos sete dias de dados. Todos os registros de data e hora são exibidos 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 no Canvas ou na Campaign avaliadas no intervalo de tempo selecionado. Essas contagens podem ser um pouco diferentes da visualização de análise de dados, porque a Observabilidade de Mensagens usa dados de solução de problemas de outras fontes.
- Supressões: Mensagens que a Braze intencionalmente não enviou após a entrada, por exemplo, por elegibilidade, limite de frequência ou horário de silêncio. Para saber mais, consulte Supressões.
- Falhas: Mensagens que falharam inesperadamente, como erros de Liquid, webhook ou push. Para saber mais, 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 saber mais, consulte Enviadas e entregues.
Eventos ao longo do tempo
Este gráfico de série temporal mostra um detalhamento por hora dos eventos dos 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 neste 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 nos filtros e no 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 aquele evento. No painel, você também pode selecionar Perguntar ao Operator para obter 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 podem continuar aparecendo 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 somente para Canvas. A entrada em uma Campaign aparece em Entradas como Entrou na Campaign.
Os rótulos dos eventos de progressão na Observabilidade de Mensagens são rótulos legíveis do dashboard. As contagens ou os nomes podem ser diferentes 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 este 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 do agente | O usuário entrou em uma etapa do 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 as 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 postergação zero) ou progredindo de outra forma por essa etapa. |
| Entrou na etapa de jornada experimental | O usuário entrou em uma etapa de jornada experimental 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 Enviar para destino | O usuário entrou em uma etapa Enviar para 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 aguardando por causa do 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
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 na Observabilidade de Mensagens 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 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 ser diferentes entre o Currents e a Observabilidade de Mensagens.
Configurações de envio
| Supressão | Explicação |
|---|---|
| Interrompido por prioridade | O envio foi interrompido porque outra mensagem de prioridade mais alta para esse usuário já estava pendente, ou porque esta mensagem teve a prioridade reduzida. |
| 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 vê-lo. |
| Variante do Otimizador de Conteúdo desativada | A atribuição da 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 a 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) eram elegíveis para receber esta mensagem. Para evitar envios duplicados ao mesmo usuário, esta mensagem foi interrompida. |
| Evento de exceção ou de saída | O usuário era elegível para receber a mensagem, mas
|
| Usuário reprovado na verificação prévia da etapa de mensagem | A Braze executa um primeiro conjunto de verificações prévias básicas de elegibilidade do público, reelegibilidade e elegibilidade do 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 verificação prévia da mensagem disparada | A Braze executa um primeiro conjunto de verificações prévias básicas de elegibilidade do público, reelegibilidade e elegibilidade do 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 é mais elegível | O usuário estava inicialmente no público-alvo, mas deixou de corresponder aos critérios do público antes de a Braze enviar a mensagem ou inseri-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 é elegível para receber esta mensagem no canal selecionado. Os motivos comuns incluem identificadores de canal ausentes ou inválidos, nenhum token por push elegível, restrições do 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 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 por causa das configurações de reelegibilidade ou de 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 número 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 da mensagem. Isso pode acontecer quando a URL está bloqueada, é inválida, excede o tempo limite, retorna um status HTTP inválido ou falha na validação SSL. |
| Erro de entrega do parceiro | A Braze tentou enviar esta mensagem ao seu parceiro de entrega durante 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 neste 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 deste 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 por causa dos limites 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 causa de 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 suspensas brevemente. |
| 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 obter mais ajuda. |
Perguntas frequentes
O que significa uma falha de “pré-verificação”?
Uma “pré-verificação” é uma verificação de validação agrupada e de alta velocidade, 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 nela 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 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 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 dos seus Canvas, pois 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 grande proporção de falhas do tipo Outro, entre em contato com o suporte da Braze para obter mais ajuda.
Por que a soma de Entradas, Supressões, Falhas e Enviadas não corresponde ao 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 quando a campanha ou o Canvas foi lançado. Por exemplo, eles não estavam no segmento ou não tinham os atributos necessários.
- Processamento em andamento: As mensagens ou etapas do canva ainda podem estar em processamento. 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 campanha ou deste Canvas talvez ainda não tenham chegado ao dashboard.
- Casos extremos: Há uma pequena chance de você estar diante de um caso extremo que este dashboard ainda não captura. Se você suspeitar disso, entre em contato com o suporte da Braze.
Por que os totais dos blocos ou do registro de eventos podem ser maiores que o público de uma campanha ou de um Canvas?
Isso pode ocorrer pelos seguintes motivos:
- Mensagens multicanal: A campanha ou etapa do canva 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 são contabilizados no dashboard e podem deixar os totais maiores que o tamanho do público.