Relatórios de engajamento
Os relatórios de engajamento permitem que você extraia estatísticas de engajamento de mensagens específicas de Campaigns e Canvas para receber por e-mail no horário de sua preferência.

Você precisa da permissão “Export User Data” para executar relatórios de engajamento.
Com os relatórios de engajamento, você pode selecionar manualmente Campaigns e Canvas para incluir no seu relatório por e-mail ou especificar regras para selecionar automaticamente Campaigns e Canvas relevantes.
Independentemente do número de Campaigns ou Canvas selecionados, até dois arquivos CSV são gerados — um para todos os dados de Campaign e outro para todos os dados de Canvas. Você pode acessar esses arquivos CSV pelo link incorporado no e-mail do relatório. Os relatórios de engajamento não são salvos no dashboard da Braze.
Alguns dados são agregados no nível de Campaign ou Canvas, e não no nível de variante de campanha individual ou etapa do Canvas. Se você excluir uma etapa do Canvas após o lançamento, isso também removerá os dados dos relatórios de engajamento.

Você pode executar o relatório novamente para gerar estatísticas atualizadas.
Criando um novo relatório
Etapa 1: Criar um relatório
Na sua conta do dashboard, acesse Analytics > Relatórios de engajamento. Selecione + Criar Novo Relatório.
Etapa 2: Adicionar mensagens
Adicione as Campaigns e mensagens do Canvas que você deseja compilar no seu relatório. Você pode selecionar suas mensagens de duas formas:
- Selecionar manualmente Campaigns e Canvas
- Selecionar automaticamente Campaigns e Canvas com base em regras específicas

Selecionar manualmente Campaigns ou Canvas
Essa opção dá a você a liberdade de escolher quais Campaigns ou Canvas deseja incluir neste relatório.
Selecionar automaticamente Campaigns ou Canvas
Essa opção permite incluir automaticamente todas as mensagens que contêm uma tag específica. Você pode segmentar mensagens que tenham qualquer uma ou todas as tags listadas. Essa opção é útil se você está configurando relatórios recorrentes e costuma marcar suas mensagens de engajamento com tags.

As tags devem corresponder a pelo menos uma Campaign ou Canvas para que o relatório seja gerado. Se você usar Selecionar automaticamente Campaigns e Canvas com base em regras específicas e vir um erro, confirme que pelo menos uma Campaign ou Canvas corresponde às suas tags e outros filtros (por exemplo, quando você exige todas as tags listadas, cada mensagem correspondente deve ter todas as tags).
Etapa 3: Adicionar estatísticas
A etapa Adicionar Estatísticas mostra as estatísticas para os tipos de Campaigns ou Canvas que você selecionou. Por exemplo, se você selecionou mensagens de e-mail, poderá visualizar apenas as estatísticas relevantes de e-mail. Se você escolheu uma combinação de e-mail e push, poderá visualizar as estatísticas desses dois canais.

Os relatórios de engajamento agregam dados por Campaign ou Canvas, não no nível do espaço de trabalho. Para monitorar o volume total de envios ou impressões em todas as Campaigns e Canvas ativos, como envios e impressões por canal em todo o espaço de trabalho, use o Report Builder.

Envios para Operadora está descontinuado, mas continuará sendo suportado para usuários que já o utilizam.
| Canal | Estatísticas disponíveis |
|---|---|
| Envios, Aberturas, Aberturas Únicas, Cliques, Cliques Únicos, Clique para Abrir, Cancelamentos de Inscrição, Bounces, Entregas, SPAM Reportado | |
| Push | Envios, Aberturas, Aberturas por Influência, Bounces, Cliques no Corpo |
| Web Push | Envios, Aberturas, Bounces, Cliques no Corpo |
| Mensagem no app | Impressões, Cliques, Cliques no Primeiro Botão, Cliques no Segundo Botão |
| Webhook | Envios, Erros |
| SMS | Envios, Envios para Operadora, Entregas Confirmadas, Falhas de Entrega, Rejeições |
Etapa 4: Concluir a configuração do relatório
Dê um nome ao seu relatório, escolha como ele será formatado e selecione os destinatários. Por padrão, os relatórios de engajamento são enviados como um arquivo ZIP com dados delimitados por vírgula (onde cada dado é separado por uma vírgula).
Você pode selecionar entre as seguintes opções de compressão e delimitador:
- Compressão: ZIP, Sem compressão ou gzip
- Delimitador: Vírgula (
,), Dois-pontos (:), Ponto e vírgula (;) ou Pipe (|)

As estatísticas são coletadas apenas para o período especificado pelo relatório. Para receber estatísticas precisas de taxa de abertura e cliques, selecione um período que inclua quando os eventos de envio foram realizados para suas Campaigns e Canvas.
Selecionar período
Por padrão, o intervalo de dados exibido é baseado no fuso horário da sua empresa e vai desde a mensagem mais antiga selecionada até a data atual. Você pode personalizar isso selecionando o menu suspenso de datas e usando a seleção de intervalo personalizado OU selecionando o próximo botão de opção e definindo seu intervalo de datas com as opções disponíveis no menu suspenso.
Selecionar exibição de dados
Por padrão, os dados exibidos nos relatórios de engajamento são diários (um dia). Para visualizar esses dados em intervalos diferentes, escolha um número explícito de dias ou semanas para agregar os dados do relatório. Assim, em vez de ver métricas diárias, você pode visualizar seu engajamento por semana, mês, trimestre ou similar. Caso uma agregação baseada em tempo não seja suficiente, você também pode optar por exportar dados no nível da Campaign ou do Canvas.

Exibir dados por Campaign ou Canvas inteiro
Quando você seleciona Exibir Dados por Campaign ou Canvas Inteiro, a Braze agrega as métricas em blocos de 1.825 dias (cinco anos) ao longo do período do relatório.
Se o período abrange mais de um bloco, você pode ver várias linhas para a mesma Campaign ou Canvas com datas diferentes na coluna de data. Algumas linhas podem incluir apenas métricas registradas mais tarde no período (por exemplo, cancelamentos de inscrição). As datas também podem ser de anos antes de você começar a enviar no espaço de trabalho, porque refletem os limites dos blocos na exportação, não apenas o seu primeiro envio.
Para alinhar a coluna de data com o momento em que suas Campaigns e Canvas selecionados realmente enviaram, defina a data de início do relatório em Selecionar período para a data mais antiga que você deseja no arquivo — normalmente quando essas mensagens começaram a ser enviadas — em vez de deixar o intervalo padrão que retrocede até a mensagem selecionada mais antiga.
No CSV exportado, a primeira coluna é a data:
- Exibir Dados por Campaign ou Canvas Inteiro: A data é o início do período do relatório ou um limite de bloco dentro dele, não a data de início da Campaign ou do Canvas.
- Exibir Dados a Cada X Dias ou Semanas: A data de cada linha reflete quando os eventos naquela janela de agregação ocorreram.
Agendar seu relatório
Existem duas opções ao agendar seu relatório:
- Enviar imediatamente: Após o relatório ser iniciado, a Braze enviará este relatório imediatamente.
- Enviar em um horário designado: Essa opção dá a você a flexibilidade de escolher com que frequência deseja receber este relatório. Você pode optar por enviar este relatório a cada número definido de dias, semanas ou meses. Também pode definir quando parar de enviar o relatório.

Etapa 5: Revisar e iniciar
A etapa final da configuração do seu relatório mostra uma visão geral somente leitura das opções configuradas. Revise seu relatório e, quando estiver satisfeito, selecione Iniciar Relatório.
Etapa 6: Verificar seu e-mail
Você receberá um e-mail com links para seus relatórios no horário ou cronograma escolhido. Esses links expiram 1 hora após o envio do relatório. Ao selecionar os links fornecidos, você fará o download automático de um arquivo ZIP contendo seus arquivos CSV — um para todas as Campaigns.
O relatório contém todas as estatísticas selecionadas na seção Adicionar Estatísticas do processo de configuração.
Solução de problemas
As métricas do relatório de engajamento diferem do Dashboard de Desempenho de E-mail
Os relatórios de engajamento e o Dashboard de Desempenho de E-mail usam as mesmas definições de métricas de e-mail. Ambos atribuem aberturas e cliques ao dia em que cada evento ocorreu, e ambos calculam Aberturas Únicas e Cliques Únicos como contagens únicas de sete dias por dia, somadas ao longo do período selecionado. Para definições, consulte Métricas de e-mail e Como as métricas são calculadas na página de dashboards de desempenho de canal.
Se os totais ainda diferirem para as mesmas Campaigns e o mesmo período, verifique o seguinte:
| Verificação | Por que é importante |
|---|---|
| Período e fuso horário | Ambas as superfícies devem cobrir os mesmos dias do calendário no mesmo fuso horário. |
| Seleção de Campaign ou Canvas | O Dashboard de Desempenho de E-mail agrega a atividade de e-mail em todo o espaço de trabalho. Um relatório de engajamento inclui apenas as Campaigns ou Canvas que você selecionou. |
| Linhas diárias versus totais do relatório | Se Data Display divide a exportação em linhas diárias, some essas linhas para comparar com os totais do dashboard para o mesmo período. |
As diferenças são mais comuns quando os números do relatório de engajamento são comparados com a análise de dados de Campaign ou Canvas em vez do Dashboard de Desempenho de E-mail. As páginas de Campaign e Canvas podem exibir métricas de data de envio (por exemplo, envios ou conversões atribuídos à data de envio) junto com aberturas e cliques por data do evento. Consulte O relatório de engajamento não corresponde às métricas do Canvas ou da Campaign.
O relatório de engajamento não corresponde às métricas do Canvas ou da Campaign
Período incompatível
Certifique-se de que as datas no relatório de engajamento correspondam às datas na análise de dados do Canvas ou da Campaign (por exemplo, ambos cobrem 1 a 15 de dezembro), mesmo que o Canvas tenha enviado apenas uma vez. Nas configurações do relatório de engajamento, verifique Data Display para confirmar que você está visualizando o Canvas ou a Campaign corretos. Se Data Display estiver configurado para mostrar dados a cada X dias, você obtém uma linha por data em que as métricas foram registradas para cada etapa.
Se os totais parecerem errados em uma planilha, limpe os filtros extras na exportação. Você pode somar as linhas diárias para reconciliá-las com os totais do Canvas ou da Campaign para o mesmo período.

Se você deseja que as linhas sejam agregadas por Campaign ou Canvas inteiro em vez de intervalos diários, semanais ou outros recorrentes, defina Data Display como Show Data by Entire Campaign or Canvas. Se a contagem de linhas ou as datas parecerem erradas no CSV, consulte Show Data by Entire Campaign or Canvas.
Cliques duplicados de botão em In-App Messages HTML
Se você usa In-App Messages HTML e os Body clicks parecem altos no relatório de engajamento, pode ser que o registro de cliques esteja sendo disparado duas vezes — por exemplo, chamando brazeBridge.logClick() para um clique genérico no corpo e também brazeBridge.logClick('body click') (ou outro ID) na mesma interação. Pesquise no seu markup por brazeBridge.logClick( e alinhe com um padrão por controle. Para o uso recomendado, consulte Rastreamento de botões.
Links quebrados em e-mails de relatórios de engajamento
Se os links em um e-mail de relatório de engajamento agendado não abrirem corretamente no seu cliente de e-mail, tente estas etapas:
- Encaminhe o relatório para uma caixa de entrada do Gmail e abra os links no Google Chrome.
- Nas configurações do relatório de engajamento, confirme que Report Schedule está configurado para enviar quando você espera (por exemplo, imediatamente após o relatório ser gerado, em vez de em um cronograma com atraso).