Relatórios de engajamento
Os relatórios de engajamento permitem extrair estatísticas de engajamento de mensagens específicas de Campaigns e Canvas e recebê-las por e-mail no horário de sua preferência.
Com os relatórios de engajamento, você pode selecionar manualmente as Campaigns e os Canvas que serão incluídos no seu relatório por e-mail. Também é possível especificar regras para selecionar automaticamente as Campaigns e os Canvas relevantes.
Independentemente do número de Campaigns ou Canvas selecionados, são gerados até dois arquivos CSV: um com todos os dados de Campaign e outro com 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 ficam salvos no dashboard da Braze.
Alguns dados são agregados no nível da Campaign ou do Canvas, e não no nível de cada variante de campanha ou etapa do Canvas. Se você excluir uma etapa do Canvas após o lançamento, os dados dessa etapa também serão removidos 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 campanhas nos relatórios de engajamento |
| “View Canvases” | Incluir Canvas nos relatórios de engajamento |
Criação de 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 mensagens de Campaigns e Canvas que você quer reunir no seu relatório. Você pode selecionar suas mensagens de duas maneiras:
- 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 quaisquer Campaigns ou Canvas que quiser incluir neste relatório.
Selecionar automaticamente Campaigns ou Canvas
Essa opção permite incluir 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 se você estiver configurando relatórios recorrentes e costuma marcar suas mensagens de engajamento com tags.

As tags devem corresponder a pelo menos uma Campaign ou um Canvas para que o relatório seja gerado. Se você usar Selecionar automaticamente Campaigns e Canvas com base em regras específicas e encontrar 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 deve 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 de e-mail relevantes. Se escolheu uma combinação de e-mail e push, poderá ver as estatísticas desses dois canais.

Os relatórios de engajamento agregam dados por Campaign ou Canvas, e 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 um espaço de trabalho, use o Report Builder.

Envios para a operadora está obsoleto, mas continuará com suporte 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, Entregues, Marcados como 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 na 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 (cada dado é separado por uma vírgula).
Você pode escolher entre as seguintes opções de compactação e delimitador:
- Compactação: ZIP, Sem compactaçã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 taxa 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 datas exibido é baseado 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 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 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 algo parecido. Se uma agregação por 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 adiante no período (por exemplo, cancelamentos de inscrição). As datas também podem ser anos anteriores 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), em vez de manter o intervalo padrão, que volta até a mensagem selecionada mais antiga.
No 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, e 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 seu relatório
Existem duas opções para agendar seu 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 dá a você flexibilidade para escolher com que frequência quer receber 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 do relatório mostra uma visão geral, somente para visualização, das opções que você configurou. Revise seu 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 após o envio do relatório. Ao selecionar os links fornecidos, você fará o download automático de 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. Os dois também calculam Aberturas únicas e Cliques únicos como contagens únicas de sete dias por dia, somadas em todo o 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 e-mail.
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 superfícies 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 Data Display 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 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 performance de e-mail. As páginas de Campaign e Canvas podem exibir métricas pela data de envio (por exemplo, envios ou conversões atribuídos à data de envio) junto com aberturas e cliques pela 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 divergente
Confira se as datas do relatório de engajamento correspondem às datas da análise de dados do Canvas ou da Campaign (por exemplo, ambos cobrindo de 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á vendo o Canvas ou a Campaign correta. Se Data Display estiver configurado para mostrar dados a cada X dias, você terá uma linha por data em que as métricas foram registradas para cada etapa.
Se os totais parecerem errados em uma planilha, remova 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 pela Campaign ou pelo Canvas inteiro, em vez de agrupamentos 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 em botões de mensagens no app em HTML
Se você usa mensagens no app em HTML e os Body clicks parecerem altos no relatório de engajamento, talvez o registro de cliques esteja sendo disparado duas vezes. Isso acontece, 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 ver o uso recomendado, consulte Rastreamento de botões.
Links quebrados em relatórios de engajamento enviados por e-mail
Se os links de 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 Report Schedule está configurado para enviar quando você espera (por exemplo, imediatamente após a geração do relatório, em vez de em um cronograma com postergação).