Skip to content

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

  1. Acesse Analytics > Report Builder (New).
  2. 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.

    Menu suspenso do botão "Criar novo relatório" com opções para criar um relatório personalizado ou usar um modelo.

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

      Janela "Modelos de relatório da Braze" com uma lista de modelos da Braze disponíveis para seleção.

  4. Siga a partir da etapa 3 em Criando um relatório para personalizar ainda mais o relatório de acordo com seu caso de uso.

Criando um relatório

  1. Acesse Analytics > Report Builder (New).
  2. Selecione Create New Report.
  3. No menu suspenso Rows, selecione sobre o que você deseja gerar o relatório:
    • Campaigns
    • Canvas
    • Campaigns e Canvas
    • Canais
    • Tags

    Sua seleção de Rows impacta as métricas que você pode visualizar. Por exemplo, você pode visualizar métricas multivariantes somente se gerar o relatório com base em Canvas, ou Campaigns com um detalhamento por Variant. Não é possível visualizar essas métricas ao gerar relatórios de Campaigns e Canvas, mesmo que essas Campaigns e Canvas tenham testes multivariantes.

A seção "Rows and columns" com campos para selecionar as linhas e agrupamentos do seu relatório.

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

A seção "Customize Metrics" com opções para selecionar múltiplas métricas.

  1. 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.
  2. Em Report content, configure o intervalo de datas para o qual você deseja incluir dados no seu relatório.
  3. 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 o nome da Campaign ou Canvas.

      A seção "Manually add campaigns and canvases" com uma lista de Campaigns para selecionar.

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

        A seção "Automatically add campaigns and canvases" com campos para definir regras sobre quais Campaigns e Canvas devem ser adicionados ao relatório.

  4. Execute o relatório selecionando Save & Run.

Disponibilidade de métricas

Sua seleção em Linhas afeta as métricas que você pode selecionar.

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 por canal incluem todas as estatísticas, independentemente de a variante ter sido excluída. Por exemplo, 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, pois os envios de variantes de mensagem excluídas são filtrados.

No mesmo relatório, Destinatários únicos pode ser maior do que 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 Impressões únicas omite as estatísticas das variantes excluídas nas agregações por mensagem.

Visualização de um relatório

Após executar seu relatório, você pode visualizar os resultados em formato de tabela na página de resultados do relatório.

Uma tabela com os dados do relatório para as métricas de cada Campaign.

Criação de 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.

Um gráfico com os dados do relatório e opções para configurar o eixo x, o eixo y, o tipo de gráfico e outros.

Download de um gráfico de relatório

Para baixar uma imagem do gráfico do relatório, selecione o ícone de pontos e escolha uma opção de download.

Um menu com opções de download para diferentes formatos de arquivo.

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 específico 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.

Janela "Schedule an email" com campos para escolher o formato do relatório, quem deve recebê-lo e quando deve ser enviado.

  • Download CSV: Baixe um CSV do relatório.

Adicionando um relatório a um dashboard

  1. Selecione o ícone de três pontos no topo da tabela do relatório.
  2. Selecione Adicionar ao dashboard.
  3. Selecione se deseja criar um novo dashboard ou adicionar a um dashboard existente.

    Janela com opções para selecionar se você deseja adicionar o relatório a um dashboard novo ou existente.

  4. Siga as etapas no Dashboard Builder para saber mais sobre como criar um dashboard.

Permissões de equipe

Os relatórios do Criador de relatórios não suportam atribuição de equipe como Campaigns ou Canvas. Não é possível limitar um relatório salvo a uma equipe específica ao criá-lo.

Usuários com permissão “View Dashboard Reports” no nível de equipe (em vez de no nível do espaço de trabalho) ainda podem usar o Criador de relatórios, mas a visibilidade dos relatórios é limitada:

  • Esses usuários só veem relatórios em que todas as Campaigns e Canvas selecionados estão atribuídos às suas equipes.
  • Relatórios com Canais como linhas ficam ocultos.
  • Relatórios que usam seleção automática para adicionar Campaigns ou Canvas ficam ocultos, porque a Braze não consegue verificar o acesso da equipe para mensagens que podem ser adicionadas quando o relatório é executado.

O Criador de relatórios (legado) define por equipe quais Campaigns e Canvas você pode adicionar a um relatório, mas os relatórios salvos não são filtrados da lista da mesma forma que no Criador de relatórios (novo). Para configuração de permissões, consulte Configuração de permissões de usuário e Equipes.

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. Envios e outras métricas são preenchidos apenas para a atividade 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 o Ú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.

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 pelo seu bucket S3.
New Stuff!