Observabilidade de Mensagens
A Observabilidade de Mensagens rastreia eventos em seu Canvas ou Campaign para que você possa auditar e solucionar problemas de envio de mensagens. Use-a para identificar tendências, ver como os usuários progridem em um Canvas e diagnosticar por que mensagens podem não ter sido enviadas conforme esperado.
Para acessar a Observabilidade de Mensagens, você precisa da permissão de usuário “View Dashboard Reports” para o seu espaço de trabalho.
Conceitos-chave
Enviadas e entregues
Esse dashboard mostra 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 transferiu a mensagem para o parceiro de envio terceirizado correspondente. 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 |
|---|---|
| Content Cards | O cartão foi enviado e está elegível para visualização. |
| A Braze transfere a mensagem para 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 se 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 transferida com sucesso para um parceiro de envio. |
| Push | A Braze transfere a mensagem para o 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 transfere a mensagem para um gateway de SMS (como Twilio). Esse gateway é responsável pela entrega final à operadora de telefonia móvel. |
| Webhooks | A solicitação de webhook foi realizada com sucesso, retornando uma resposta 2xx. |
| A mensagem foi transferida com sucesso para 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 se movem 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 onde os usuários estão no Canvas.
Atualização dos dados
A frequência com que os dados nesse dashboard são atualizados pode variar de acordo com a carga do sistema. Embora a frequência de atualização não seja garantida, na maioria dos casos ela é inferior a uma hora.
Configurar o dashboard
Abra a Observabilidade de Envio de Mensagens em qualquer 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 Campaign, selecione Messaging Observability. O dashboard é aberto com o Canvas ou a Campaign pré-selecionada, 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 a origem dos seus relatórios do dashboard.
- Selecione uma Campaign ou um Canvas.
- (Opcional, somente 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.
Após 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 de “Outdated results”.
Interpretar os dados
O dashboard exibe até 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, os blocos de resumo para o período selecionado mostram:
- Entradas: Todas as entradas elegíveis de Canvas ou Campaign avaliadas no intervalo de tempo selecionado. Esses números podem diferir ligeiramente da visualização de análise de dados porque a Observabilidade de Mensagens utiliza dados de solução de problemas de diferentes fontes.
- Supressões: Mensagens que a Braze intencionalmente não enviou após a entrada, como por elegibilidade, limite de frequência ou horário de silêncio. Para mais detalhes, consulte Supressões.
- Falhas: Mensagens que falharam inesperadamente, 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
Este gráfico de série temporal mostra uma análise horária dos eventos para os filtros selecionados. Use as visualizações do gráfico para comparar os totais gerais ou para detalhar supressões e falhas por resultado. Os rótulos de resultado neste gráfico são rótulos normalizados do dashboard, 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 com base nos filtros e no intervalo de tempo selecionados, principalmente supressões, progressões e falhas. Use-o para revisar registros específicos, incluindo o timestamp, o ID do usuário, a etapa do Canvas, o evento, a descrição e o canal de envio de mensagens.
Filtre a tabela para focar em registros específicos:
- Selecione categorias de eventos ou eventos individuais no filtro Events (por exemplo, Suppressions > Frequency capped ou Progressions > Entered step).
- Insira um ID de usuário no campo de busca para exibir as linhas desse usuário.
Quando você aplica ambos os filtros, a tabela retorna linhas que correspondem tanto aos eventos selecionados quanto ao ID de usuário inserido.
Selecione View em uma linha para abrir um painel lateral com mais contexto sobre esse evento. A partir do painel, você também pode selecionar Ask Operator para obter orientação de correção.
Os filtros de canal se aplicam a eventos que estão vinculados a um canal de envio de mensagens específico. Alguns eventos são independentes de canal, então ainda podem aparecer em visualizações agregadas mesmo quando você aplica um filtro de canal.
Eventos de progressão
Eventos de progressão descrevem como os usuários avançam por um Canvas. Eles são exclusivos do Canvas. A entrada em Campaign aparece em Entradas como Entered campaign.
Os rótulos de eventos de progressão na Observabilidade de Mensagens são rótulos legíveis do dashboard. Os números ou a nomenclatura podem diferir de outras superfícies de análise de dados da Braze porque esses conjuntos de dados possuem diferentes representações e caminhos de processamento.
| Evento de progressão | Explicação |
|---|---|
| Entered Canvas | O usuário entrou no Canvas. A entrada pode ser agendada, baseada em ação ou disparada por API. Os usuários incluídos em um grupo de controle também podem aparecer sob esse rótulo. |
| Entered Action Path step | O usuário entrou em uma etapa de jornadas de ação e seguiu uma jornada após uma ação (ou a jornada de todos os outros). |
| Entered Agent step | O usuário entrou em uma etapa de Agente onde o contexto foi avaliado. |
| Entered Audience Path step | O usuário entrou em uma etapa de jornada do público e seguiu uma jornada do público (ou a jornada de todos os outros). |
| Entered Audience Sync step | O usuário entrou em uma etapa de Audience Sync e a sincronização de público foi iniciada. |
| Entered Content Optimizer step | O usuário entrou em uma etapa do Otimizador de Conteúdo e uma variante foi selecionada. |
| Entered Context step | O usuário entrou em uma etapa de contexto onde as variáveis de contexto foram definidas ou avaliadas. |
| Entered Decision Split step | O usuário entrou em uma etapa de divisão de decisão e seguiu uma ramificação. |
| Entered Delay step | O usuário entrou em uma etapa de postergação e está aguardando, avançando imediatamente (por exemplo, uma postergação zero) ou progredindo de outra forma nessa etapa. |
| Entered Experiment Path step | O usuário entrou em uma etapa de jornada experimental e foi atribuído a uma variante do experimento. |
| Entered Feature Flag step | O usuário entrou em uma etapa de Feature Flag e os feature flags estão sendo avaliados. |
| Entered Message step | O usuário entrou em uma etapa de Mensagem. Supressões, falhas ou envios posteriores para essa etapa aparecem como eventos separados. |
| Entered Send to Destination step | 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. |
| Entered User Update step | 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 devido ao limite de frequência da atualização de usuário. |
| Sent to destination | O usuário foi enviado ao Canvas de destino e avançou para a próxima etapa no Canvas atual. |
| Not sent to destination | O usuário não entrou no Canvas de destino (por exemplo, devido a uma incompatibilidade de público) e avançou para a próxima etapa no Canvas atual. |
| Destination not found | O Canvas de destino não foi encontrado. O usuário avançou para a próxima etapa no Canvas atual. |
| Exited Canvas | O usuário saiu do Canvas. Isso acontece quando:
|
Supressões
Supressões são não envios intencionais após a entrada, causados 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 com campos como abort_type e abort_log. Como esses conjuntos de dados possuem diferentes representações e caminhos de processamento, os números ou a nomenclatura podem diferir entre Currents e a Observabilidade de Mensagens.
Configurações de envio
| Supressão | Explicação |
|---|---|
| Aborted due to priority | O envio foi interrompido porque outra mensagem de prioridade mais alta para este usuário já estava pendente, ou esta mensagem foi desprioritizada. |
| Banner expired | O banner expirou antes de poder ser despachado. |
| Content Card expired | O Content Card expirou antes que o usuário o visse. |
| Content Optimizer variant deactivated | A atribuição de variante do Otimizador de Conteúdo foi desativada antes do envio. |
| 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. |
| Inactive campaign | A Campaign foi interrompida enquanto a mensagem estava em trânsito, então ela foi cancelada. |
| Inactive Canvas | O Canvas foi interrompido antes que o usuário entrasse na jornada. |
| Inactive Canvas step | Isso pode ocorrer no Canvas se:
|
| Quiet Hours abort | O horário de silêncio estava ativado para a Campaign ou etapa do Canvas com o fallback definido como Abort message. 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 cancelada. No entanto, isso não retira o usuário do Canvas. |
| Volume limited | A Campaign ou Canvas atingiu o limite de volume de envios definido, então o envio foi cancelado. |
Elegibilidade do usuário
| Supressão | Explicação |
|---|---|
| Duplicate user identifier | 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 cancelada. |
| Exception or exit event | O usuário era previamente elegível para receber a mensagem, mas:
|
| User failed pre-check for Message step | A Braze executa um primeiro conjunto 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. Esse resultado significa que o usuário ou a mensagem falhou em uma dessas verificações, então a mensagem foi cancelada para essa etapa. |
| User failed pre-check for triggered message | 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 deste disparo. Esse resultado significa que o usuário ou a mensagem falhou em uma dessas verificações, então a mensagem foi cancelada. |
| User no longer eligible | 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 intervalo entre o usuário atender inicialmente aos critérios de público e deixar de atender pode ser causado por atrasos de:
|
| User not eligible for channel | O usuário não é elegível para receber esta mensagem no canal selecionado. Razões comuns incluem identificadores de canal ausentes ou inválidos, nenhum token por 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. |
| User not eligible for step | 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 Delivery validations, o usuário pode ter saído do Canvas ou avançado para a próxima etapa. |
| User not re-eligible | 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 reentrada. Isso pode acontecer se o usuário já recebeu a Campaign ou entrou no Canvas recentemente demais, se outro envio para a mesma Campaign já está em andamento para este usuário, ou se a reelegibilidade ou reentrada está desativada. |
Falhas
Falhas são erros inesperados durante o processamento ou tentativas de entrega.
| Falha | Explicação |
|---|---|
| Connected Content failed | A Braze tentou enviar a mensagem, mas o Connected Content falhou após o número máximo de tentativas (o padrão é cinco). Esse número representa a quantidade de mensagens canceladas por atingir o número máximo de tentativas, não o número total de requisições de Connected Content com falha. |
| Content Card invalid | O Content Card apresentou erros e não foi enviado ao usuário. Algumas razões comuns incluem:
|
| Delay step failure | A etapa de postergação falhou, fazendo com que o usuário saísse do Canvas. Essa falha pode acontecer quando:
|
| Liquid abort | A tag abort_message do Liquid foi chamada, então o envio foi cancelado. |
| Liquid rendering timeout | A renderização do modelo Liquid demorou muito. Mais provável de ocorrer em banners, mensagens no app e e-mail. |
| Liquid syntax error | O modelo Liquid apresentou um erro de análise, então a mensagem foi cancelada. |
| Media URL failure | A Braze não conseguiu processar a URL de mídia na 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. |
| Partner delivery error | 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. |
| Product recommendation invalid | A recomendação de produto ou seleção de catálogo não pôde ser usada para este envio. Razões comuns incluem uma recomendação ausente ou arquivada, treinamento incompleto ou filtros que removeram todos os itens do catálogo. |
| Push credentials invalid | As credenciais de push deste app estão ausentes ou inválidas, então o envio foi cancelado. Atualize suas credenciais em App Settings. |
| Rate limited over 72 hours | A mensagem foi limitada por mais de 72 horas devido aos limites de frequência na velocidade de entrega, então o envio foi cancelado. |
| Subscription group failure | 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. Razões comuns incluem números de envio ausentes para SMS ou WhatsApp, ou MMS não suportado no serviço de envio de mensagens configurado. |
| User profile not found | O usuário nunca existiu ou não existe mais na Braze. Alguns casos comuns incluem:
|
| Webhook failed | O webhook recebeu um código de resposta sem sucesso (não 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 brevemente interrompidas. |
| Other | Falhas que não se enquadram nas outras categorias desta tabela. Se você notar uma grande proporção de falhas do tipo Other, entre em contato com o suporte da Braze para assistência adicional. |
Perguntas frequentes
O que significa uma falha de “pré-verificação”?
Uma “pré-verificação” refere-se a uma validação rápida e agrupada que ocorre 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 intensivas em 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 uma falha “Outro”?
Essas 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 assistência.
Por que Entradas, Supressões, Falhas e Enviadas não somam 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: Mensagens ou etapas do Canvas ainda podem estar sendo processadas. Usuários podem ainda estar em etapas anteriores do Canvas e não ter alcançado nenhuma etapa de mensagem.
- Progressão sem envio: Usuários podem gerar eventos de progressão (como entrar em uma etapa de postergação ou 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 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 os totais dos blocos ou do registro de eventos podem ser maiores que o público de uma Campaign ou 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 “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 Campaign de push para 100 usuários, direcionada para iOS e Android. Se um usuário tiver apenas um dispositivo iOS, ele recebe o push de iOS (“enviado”), mas também gera uma supressão para o push de 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 eventos, então um único usuário pode ser contado múltiplas vezes se passar por várias etapas dentro do intervalo de tempo selecionado.
- Mensagens de teste: O envio de testes (que é contado no dashboard) pode fazer com que os totais sejam maiores que o tamanho do público.