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.
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.
Pré-requisitos
Para executar relatórios de engajamento, você precisa destas permissões no seu espaço de trabalho:
| Permissão | O que ela permite |
|---|---|
| “Edit Dashboard Reports” | Abrir os relatórios de engajamento e criar, editar e executar relatórios |
| “View Campaigns” | Incluir Campaigns nos relatórios de engajamento |
| “View Canvases” | Incluir Canvas nos relatórios de engajamento |
Criar 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 as mensagens do Canvas que você quer compilar no relatório. Você pode selecionar as mensagens de duas formas:
- Selecionar Campaigns e Canvas manualmente
- Selecionar Campaigns e Canvas automaticamente com base em regras específicas

Selecionar Campaigns ou Canvas manualmente
Com essa opção, você tem liberdade para escolher as Campaigns ou os Canvas que quiser incluir no relatório.
Selecionar Campaigns ou Canvas automaticamente
Com essa opção, você inclui automaticamente todas as mensagens que tenham uma tag específica. Você pode direcionar mensagens que tenham qualquer uma ou todas as tags listadas. Essa opção é útil para configurar relatórios recorrentes quando você marca suas mensagens de engajamento com tags regularmente.

As tags precisam corresponder a pelo menos uma Campaign ou um Canvas para que o relatório seja gerado. Se você usar Selecionar Campaigns e Canvas automaticamente com base em regras específicas e aparecer um erro, confirme se pelo menos uma Campaign ou um Canvas corresponde às suas tags e aos outros filtros. Por exemplo, quando você exige todas as tags listadas, cada mensagem correspondente precisa ter todas elas.
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, só poderá ver as estatísticas relevantes de e-mail. Se escolheu uma combinação de e-mail e push, poderá ver as estatísticas desses dois canais.

Os relatórios de engajamento agregam os 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 um espaço de trabalho inteiro, use o Report Builder.

Envios para a operadora está obsoleto, mas continuará sendo compatível para os 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, Entregues, Denúncias de SPAM | |
| 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 a operadora, Entregas confirmadas, Falhas de entrega, Rejeições |
Etapa 4: Concluir a configuração do relatório
Dê um nome ao relatório, escolha o formato e selecione os destinatários. Por padrão, os relatórios de engajamento são enviados como um arquivo ZIP com os dados delimitados por vírgula (cada dado é separado por uma vírgula).
Você pode escolher 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 Barra vertical (|)

As estatísticas são coletadas apenas para o intervalo de datas especificado no relatório. Para receber estatísticas precisas de taxa de abertura e de cliques, selecione um intervalo de datas que inclua o momento em que os eventos de envio ocorreram nas suas Campaigns e Canvas.
Selecionar período
Por padrão, o intervalo de dados exibido se baseia no fuso horário da sua empresa e vai da mensagem selecionada mais antiga 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 o 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 ver esses dados em intervalos diferentes, escolha um número específico de dias ou semanas para agregar os dados do relatório. Assim, em vez de ver métricas diárias, você pode ver seu engajamento por semana, mês, trimestre ou período semelhante. Se uma agregação baseada em tempo não for suficiente, você também pode exportar os dados no nível da Campaign ou do Canvas.

Mostrar dados por Campaign ou Canvas inteiro
Quando você seleciona Mostrar 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 abranger mais de um bloco, você poderá ver várias linhas para a mesma Campaign ou o mesmo 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 anteriores, em anos, ao início dos seus envios no espaço de trabalho, porque refletem os limites dos blocos na exportação, e não apenas o seu primeiro envio.
Para alinhar a coluna de data com o momento em que as Campaigns e os Canvas selecionados foram realmente enviados, defina a data de início do relatório em Selecionar período como a data mais antiga que você quer no arquivo (normalmente, quando essas mensagens começaram a ser enviadas). Não deixe o intervalo padrão, que volta até a mensagem selecionada mais antiga.
No arquivo CSV exportado, a primeira coluna é a data:
- Mostrar dados por Campaign ou Canvas inteiro: A data é o início do intervalo de datas do relatório ou um limite de bloco dentro dele, não a data de início da Campaign ou do Canvas.
- Mostrar dados a cada X dias ou semanas: A data de cada linha reflete quando os eventos daquela janela de agregação ocorreram.
Agendar o relatório
Há duas opções para agendar o relatório:
- Enviar imediatamente: Depois que o relatório for lançado, a Braze o enviará imediatamente.
- Enviar em um horário definido: Essa opção oferece flexibilidade para escolher com que frequência você recebe o relatório. Você pode enviá-lo 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 lançar
A última etapa da configuração mostra uma visão geral, somente para visualização, das opções configuradas. Revise o relatório e, quando estiver tudo certo, selecione Lançar 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 depois do envio do relatório. Ao selecionar os links, você baixará automaticamente um arquivo ZIP com 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 performance de e-mail
Os relatórios de engajamento e o dashboard de performance 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. Ambos também calculam Aberturas únicas e Cliques únicos como contagens únicas de sete dias por dia, somadas ao longo do intervalo de datas selecionado. Para ver as definições, consulte Métricas de e-mail e Como as métricas são calculadas na página de dashboards de performance de canal.
Se os totais ainda forem diferentes para as mesmas Campaigns e o mesmo período, verifique o seguinte:
| Verificação | Por que é importante |
|---|---|
| Intervalo de datas e fuso horário | As duas fontes precisam cobrir os mesmos dias do calendário no mesmo fuso horário. |
| Seleção de Campaign ou Canvas | O dashboard de performance de e-mail agrega a atividade de e-mail de todo o espaço de trabalho. Um relatório de engajamento inclui apenas as Campaigns ou os Canvas que você selecionou. |
| Linhas diárias versus totais do relatório | Se a Exibição de dados dividir a exportação em linhas diárias, some essas linhas para comparar com os totais do dashboard no mesmo intervalo. |
As diferenças são mais comuns quando você compara os números do relatório de engajamento com a análise de dados de Campaign ou Canvas, em vez do dashboard de performance de e-mail. As páginas de Campaign e Canvas podem mostrar métricas por 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
Intervalo de tempo incompatível
Confira se as datas no relatório de engajamento correspondem às datas na análise de dados do Canvas ou da Campaign (por exemplo, ambos cobrem de 1 a 15 de dezembro), mesmo que o Canvas tenha sido enviado apenas uma vez. Nas configurações do relatório de engajamento, verifique a Exibição de dados para confirmar que você está vendo o Canvas ou a Campaign correta. Se a Exibição de dados estiver configurada para mostrar dados a cada X dias, você recebe uma linha por data em que métricas foram registradas para cada etapa.
Se os totais parecerem errados em uma planilha, remova os filtros extras da exportação. Você pode somar as linhas diárias para conciliá-las com os totais do Canvas ou da Campaign no mesmo intervalo de tempo.

Se quiser linhas agregadas por Campaign ou Canvas inteiro, em vez de agrupamentos diários, semanais ou outros recorrentes, defina a Exibição de dados como Mostrar dados por Campaign ou Canvas inteiro. Se a contagem de linhas ou as datas parecerem erradas no CSV, consulte Mostrar dados por Campaign ou Canvas inteiro.
Cliques duplicados em botões de mensagens no app em HTML
Se você usa mensagens no app em HTML e os Cliques no corpo parecem altos no relatório de engajamento, talvez o registro de cliques esteja sendo disparado duas vezes. Por exemplo, ao chamar brazeBridge.logClick() para um clique genérico no corpo e também brazeBridge.logClick('body click') (ou outro ID) na mesma interação. Procure brazeBridge.logClick( no seu código e use um único padrão por controle. Para conhecer o uso recomendado, consulte Rastreamento de botões.
Links quebrados em relatórios de engajamento enviados por e-mail
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 se o Agendamento do relatório está configurado para enviar quando você espera (por exemplo, imediatamente após a geração do relatório, em vez de em um agendamento com atraso).