Criador de relatórios
Esta página explica como usar o Criador de relatórios para criar e visualizar relatórios detalhados com dados da Braze, e como adicionar relatórios a dashboards.
O vídeo a seguir apresenta uma visão geral de como criar e personalizar relatórios no Criador de relatórios.
Usando um modelo de relatório
- Acesse Analytics > Report Builder (New).
- Selecione a seta Mais opções ao lado do botão Criar novo relatório e, em seguida, selecione Usar um modelo de relatório.

- Selecione um dos modelos de relatório da biblioteca de modelos da Braze.
- Use os menus suspensos Itens de linha e Tags para encontrar relatórios relevantes para seus casos de uso.

- Use os menus suspensos Itens de linha e Tags para encontrar relatórios relevantes para seus casos de uso.
- Siga a etapa 3 em diante em Criando um relatório para personalizar ainda mais o relatório de acordo com seu caso de uso.
Criando um relatório
- Acesse Analytics > Report Builder (New).
- Selecione Create New Report.
- No menu suspenso Rows, selecione sobre o que você deseja gerar o relatório:
- Campaigns
- Canvas
- Campaigns e Canvas
- Canais
- Tags
Observe que sua seleção em Rows impactará as métricas que você pode visualizar. Por exemplo, você pode visualizar métricas multivariantes somente se gerar o relatório sobre Canvas ou Campaigns com um detalhamento por Variant. Não é possível visualizar essas métricas ao gerar relatórios sobre Campaigns and Canvases, mesmo que essas Campaigns e Canvas tenham testes multivariantes.

- (Opcional) Selecione Add drilldown para detalhar seus dados em visualizações mais granulares:
- Canais
- Data
- Use essa opção para dividir seus dados em intervalos de tempo menores. Por exemplo, se você deseja saber como suas Campaigns se saíram por dia, selecione a seguinte configuração:
- Rows: Campaigns
- Grouping: Data
- Interval: Dias
- Use essa opção para dividir seus dados em intervalos de tempo menores. Por exemplo, se você deseja saber como suas Campaigns se saíram por dia, selecione a seguinte configuração:
- Variantes
- Campaigns e Canvas

Experimente diferentes configurações de opções de detalhamento para explorar as diversas formas de detalhar seus dados.
- Na seção Columns, selecione Customize Metrics.

- Navegue pelas métricas por categoria e marque a caixa de seleção correspondente para adicionar uma métrica ao seu relatório.
- Reordene as métricas e colunas arrastando o ícone pontilhado para cima ou para baixo.
- Em Report content, configure o intervalo de datas para o qual você deseja incluir dados no relatório.
- Em seguida, dependendo das suas seleções na etapa 3, escolha adicionar manualmente ou automaticamente Campaigns, Canvas ou ambos ao seu relatório.
- Adicionar manualmente: Escolha cada Campaign ou Canvas para incluir no relatório usando os filtros de datas de Last Sent e tags ou canais, ou pesquisando pelo nome da Campaign ou do Canvas.

- Adicionar automaticamente: Defina regras para quais Campaigns ou Canvas incluir no relatório. Você só precisa selecionar um campo nesta página.
- Observe que, à medida que Campaigns ou Canvas adicionais atendam às condições definidas nesta tela, eles serão automaticamente adicionados a execuções futuras do seu relatório.
- Banner não é uma opção no menu suspenso Channel, então você não pode usar regras de canal para adicionar automaticamente Campaigns ou Canvas de Banner. Ainda assim, é possível incluir KPIs de Banner nas métricas do seu relatório.

- Adicionar manualmente: Escolha cada Campaign ou Canvas para incluir no relatório usando os filtros de datas de Last Sent e tags ou canais, ou pesquisando pelo nome da Campaign ou do Canvas.
- Execute o relatório selecionando Save & Run.

O relatório pode levar alguns minutos para ser executado, dependendo do intervalo de datas e do número de Campaigns ou Canvas selecionados na etapa de configuração.
Disponibilidade de métricas
Sua seleção de Linhas afeta as métricas que você pode selecionar.

Se você quiser gerar relatórios sobre variantes ou etapas de Canvas, selecione Canvas para as linhas e deixe o campo vazio ou selecione Data como detalhamento. Isso cria um dropdown Visualização de Canvas para ver métricas apenas do Canvas, ou agrupar métricas por variante, etapa ou mensagem.
Quando você agrupa por etapa, a tabela de prévia durante a configuração do relatório exibe no máximo 50 linhas. Execute o relatório ou exporte-o como CSV para visualizar todas as linhas.

| Métrica | Descrição |
|---|---|
| Métricas de conversão | Disponível para Campaigns, Canvas, Campaigns e Canvas. |
| Entradas | Disponível para Campaigns, Canvas, Campaigns e Canvas, Tags. |
| Data do último envio | Disponível para Campaigns, Canvas, Campaigns e Canvas. Exibida apenas para Campaigns agendadas — não é preenchida para Campaigns baseadas em ação ou disparadas por API. |
| Envios | Disponível para cada canal relevante. |
| Mensagens enviadas | Disponível para Campaigns, Canvas, Campaigns e Canvas, Tags. |
| Linha de assunto | Disponível para Campaigns de e-mail com detalhamento por Variante, Canvas e Canvas com detalhamento por Variante. |
| Receita total | Disponível para Campaigns, Canvas, Campaigns e Canvas, Tags. Indisponível com detalhamento por Canais. |
| Impressões únicas | Disponível para Campaigns, Canvas, Campaigns e Canvas, Tags. |
| Destinatários únicos | Disponível para Campaigns, Canvas, Campaigns e Canvas, Tags. Indisponível com detalhamento por Canais. |
Variantes de mensagem excluídas
As estatísticas de variantes de mensagem excluídas não são exibidas quando você detalha seu relatório por Campaigns ou Canvas. No entanto, os totais no nível do canal incluem todas as estatísticas, independentemente de a variante ter sido excluída. Por exemplo, os Envios de e-mail incluem todos os envios de e-mail, mas se você detalhar essas estatísticas por Campaign, os números podem ser menores porque os envios de variantes de mensagem excluídas são filtrados.
No mesmo relatório, os Destinatários únicos podem ser maiores do que as Impressões únicas quando uma variante de mensagem foi excluída após o envio. Os Destinatários únicos no nível da Campaign ainda podem incluir usuários que receberam a variante excluída, enquanto as Impressões únicas omitem estatísticas de variantes excluídas nas agregações no nível da mensagem.
Visualizando um relatório
Após executar seu relatório, você pode visualizar os resultados em formato de tabela na página do relatório.

Criando um gráfico de relatório
Na parte inferior da página, você pode criar um gráfico dos seus dados selecionando um Tipo de gráfico e configurando as métricas do gráfico. Por padrão, você verá a primeira métrica.


Para criar um gráfico de linhas, selecione Date como opção de detalhamento ao configurar o relatório. Isso exibirá tendências ao longo do tempo.
Baixando um gráfico de relatório
Para baixar uma imagem do gráfico de relatório, selecione o ícone de pontos e escolha uma opção de download.

Compartilhando um relatório
Você pode compartilhar um link do dashboard para o relatório selecionando Share e uma destas opções:
- Share a link: Copie e compartilhe o link.
- Send or schedule an email: Envie um e-mail imediatamente ou em um horário designado contendo um link de download que expira após uma hora. Você pode selecionar destinatários entre os usuários da empresa listados no menu suspenso Email Recipients ou inserir qualquer outro endereço de e-mail.

O menu suspenso Email Recipients lista apenas os usuários da empresa na Braze e salva seus endereços de e-mail entre os agendamentos de relatórios. Endereços de e-mail externos devem ser inseridos manualmente cada vez que você criar um novo agendamento de relatório. Se você envia relatórios com frequência para destinatários externos, como um contato de parceiro, considere adicioná-los como usuário da empresa com as permissões apropriadas para que o endereço apareça no menu suspenso.

- Download CSV: Faça o download de um CSV do relatório.
Adicionando um relatório a um dashboard
- Selecione o ícone de três pontos no topo da tabela do relatório.
- Selecione Adicionar ao dashboard.
- Selecione se deseja criar um novo dashboard ou adicionar a um dashboard existente.

- Siga as etapas em Criador de dashboards para saber mais sobre como criar um dashboard.
Solução de problemas
O relatório não mostra envios para uma Campaign ou Canvas
Uma Campaign ou Canvas aparece no relatório quando a data do Último envio está dentro da janela de Último envio que você configurou. Os Envios e outras métricas são preenchidos apenas para atividades dentro do intervalo de datas de Mostrar dados para. Se a mensagem não foi enviada durante o período de Mostrar dados para, a linha ainda pode listar a Campaign ou Canvas com zero envios.
Por exemplo, suponha que Último envio seja de 1º de janeiro de 2025 a 14 de abril de 2025, então uma Campaign é incluída, mas Mostrar dados para é de 1º de dezembro de 2024 a 14 de janeiro de 2025. Se essa Campaign não teve envios em dezembro ou janeiro, ela ainda aparece na tabela sem métricas de envio.
O link de download expirou
Os links de download de relatórios expiram após uma hora. Se o seu link expirou, gere um novo relatório e faça o download dentro de uma hora. Não há como estender o tempo de vencimento.
Se você tiver um bucket Amazon S3 conectado em Integrações com parceiros, talvez seja possível recuperar dados de relatórios mais antigos navegando diretamente no seu bucket S3.