Report Builder

The Report Builder allows you to compare the results of multiple campaigns or Canvases in a single view so that you can easily determine which engagement strategies most impacted your key metrics. For both campaigns and Canvases, you’re able to export your data and save your report to view in the future.

Campaign Comparison Example

Use this report to answer key engagement questions, for example:

  • Which were the best performing campaigns or Canvases for a specific tag or channel?
  • Which variants of multivariant campaigns had the most uplift over the control?
  • Which seasonal promotion campaign led to a higher purchase rate — the summer sale, fall sale, or winter sale?
  • Which push notifications within this Canvas had the highest open rates?
  • Which steps in this group of Canvases had the most conversions?
  • Did Version 1 of a welcome email or Version 2 of a welcome email lead to higher engagement and conversion? Did the changes work?
  • How do different delivery methods (e.g. 3 scheduled pushes vs. 3 action-based pushes vs. 3 API-triggered pushes) impact your open rates, conversion rates, or purchase rates?
  • Have the ongoing improvements to lapsing user messages positively impacted your KPIs over time?

Run a Report

1. Within the Dashboard, navigate to the Report Builder page in the lefthand navigation.

2. Create a new report by selecting one of your options: a campaign comparison report or a Canvas comparison report. If you choose to run a report on campaigns, you can select between a Manual or Automated report. Reports may contain either campaigns or Canvases, but not both together.

Campaign Dashboard

Below are the differences between these two options.

Action Manual Automated
Building Report You will be able to narrow down your campaign list using filters, and then check off specific campaigns. You will build your report by using the filter options to narrow down your campaign list.
Saving and Viewing Report You can save your report. The next time you view it, you will be able to view the same campaign you previously added, as these campaigns still fall under your “Last Sent” filter. You can save your report. The next time you view it, the report will automatically update to include all campaigns that currently match your filters.
Editing Report You can click Edit Report to add or delete campaigns from your report You can edit your report by adjusting your filter criteria.

Note that for both options, the current limit on the maximum number of campaigns in a report is 50.

Canvas reports work similarly to a manual campaign report in that Canvas selections and report updates must also be done manually. You can include at most 5 Canvases in one report.

3. Once you’ve created your report, you’ll find a blank table containing campaigns in each row. The table will populate once you select Edit Columns and choose the metrics you’d like to add. From here, click Run Report to generate your metrics.

Campaign Options

Your table will populate with the metrics you choose.

You can also toggle calculations for the average of any rate or numerical metric or total for any numerical metric.

4. You can select a specific time period to view your report’s data for. If a particular campaign, Canvas, Canvas variant, or Canvas step does not have any data for your selected time period, the results for that row will be blank.

Campaign numerical metric

Campaign Comparison Report with Multivariate Campaigns

For any multivariate campaigns, you can view these metrics broken down by your variants and control group by clicking the arrow next to the campaign name. The rows containing your variants will include performance results for that variant, and the row containing your control will include just the results for your conversion events.

Campaign Note Note: The metrics populating the row for your overall campaign will reflect the performance of its variants, but will not include the performance of the control. For instance, Primary Conversion Event A for your overall campaign will be the sum of the Primary Conversion Event A for your variants, and this will not include the Primary conversion Event A for your control.

Canvas Comparison Report Breakdown

Within a Canvas report, you can view your Canvases broken down by:

  • Variants - this will allow you to see the high-level stats for your overall Canvases, as well as stats for each variant, which can be expanded by clicking the arrow next to the Canvas name.

  • Steps - you’ll be able to view step-level metrics, with each row of the report containing the row of a step.

  • Message - similar to a step-level breakdown, the message-level breakdown contains the name of steps in each row. However, within Edit Columns, you’ll have access to message-level metrics, such as channel-specific stats like email clicks and push opens.

Note that within the Braze dashboard, you can preview the first 50 rows of your Canvas report. You can access the full report when you export a CSV.

Naming Your Report

Name your report before saving it. If a report is saved without being named, Braze will apply a default name of Campaign Comparison Report.

Campaign Note

Saving and Accessing Reports

You can save your report and name it by using the Save button. Saved reports can be viewed at a later point on the Report Builder page.

When you access a saved manual report, you will be able to view the same campaigns you previously added, as these campaigns still fall under your “Last Sent” filter.

When you access a saved automatic report, the report will automatically update to include all campaigns that currently match your filters. For instance, if your report filtered campaigns with the tag “Promotion,” then each time you view this report, you will be able to see all campaigns with the “Promotion” tag, even if these campaigns were created after you made this report.

Editing Reports

In a manual report, you can edit a report via the Edit button in the upper right. From there, you can select/un-select campaigns to include in your report.

In an automatic report, simply toggle your filters to narrow down the results in your report.

Exporting Reports

You can also download your report to CSV using the Export button.

If your report contains any multivariant campaigns, your export will include 2 CSV files - one file containing only the top-level metrics for each campaign, and another file that contains variant level metrics. The file containing variant metrics will have variant_ appended to the beginning of its name. The first time you export an automated report, you’ll receive a pop-up asking you to grant permission for downloading multiple files - click Allow.

Canvas Comparison Reports

Your CSV export will reflect whichever breakdown view you were on when you clicked Export. For instance, if you were on the step-level breakdown view, your export will contain data on your step metrics. To export data from a different breakdown, you’ll need to navigate to that breakdown first, and click Export from there.

If you download a variant breakdown Canvas report, you’ll receive 2 CSV files - one containing top-level metrics for each Canvas, and another containing variant level metrics. The first time you export a report like this, you’ll receive a pop-up asking you to grant permission for downloading multiple files - click Allow.

Report FAQs

If I delete a variant from a multivariant campaign, will the data from that variant be available in a future report?
No; data from deleted variants within a multivariant campaign will not appear in Report Builder.

Which types of campaigns and Canvases can be included in a report?
Any campaigns and Canvases that have last sent messages within the past 12 months will be eligible for a report.

Campaign Download

New Stuff!