Skip to content

Engagement reports

Engagement Reports are Braze’s custom reporting tool, where you can pull engagement statistics for specified messages from campaigns and Canvases.

  • The report is exported as a link embedded inside of a triggered email.
  • Regardless of the number of campaigns or Canvases selected, only a maximum of two .csv files will be generated - one for all of the campaign data, and one for all of the Canvas data.
  • Certain data is aggregated at the ‘campaign’ or ‘Canvas’ level versus at the individual ‘variant’ or ‘step’ level.

Create a new report

  1. In your dashboard account, navigate to Engagement Reports, under Data.
  2. Click + Create New Report.
  3. Add the campaigns and Canvas messages (individually or by tag) that you would like to compile in your report.
  4. Add statistics to your report.
  5. Select the compression and deliminator for your report.
  6. Enter the email addresses of Braze users who should receive this report.
  7. Select the time frame from which you would like your report to run data.
  8. Select the intervals (daily, weekly, etc.) at which would like to see the breakdown of your data.
  9. Schedule your report to send immediately or at a future, specified time.
  10. Run the report, then open it in your email when it arrives!

Add messages to your report

The Add Messages tab allows you to select your messages in two ways:


Manually select campaigns or Canvases

This option gives you the freedom to choose whichever campaigns or Canvases you would like in this report.

Automatically select campaigns or Canvases

This option gives you the ability to automatically include all messages based on a specific tag. You can target messages that have any one or all of the tags listed. This option is useful if you are setting up recurring reports and utilize our tagging system.

Add statistics to your report

The Stats tab will automatically show you stats for the types of campaigns or Canvases you have selected. For instance, if you picked Email messages, you will only see the Email Stats. If you picked a combination of Email and Push, you will see the stats for those two channels.


channel stats available
Email Sends, Opens, Unique Opens, Clicks, Unique Clicks, Click to Open, Unsubscribes, Bounces, Delivered, Reported Spam
Push Sends, Opens, Influenced Opens, Bounces, Body Clicks
Web Push Sends, Opens, Bounces, Body Clicks
In-app message Impressions, Clicks, First Button Clicks, Second Button Clicks
Webhook Sends, Errors
SMS Sends, Sends to Carrier, Confirmed Deliveries, Delivery Failures, Rejections

Set up report data coverage and distribution

The Set Up Report tab allows you to enter your report name, select the compression and delimiter of the report and include whom you would like to send this report to.


Time frame

By default, the data range shown will go from the earliest message selected until the present date. You can customize this by selecting the date dropdown and using the custom range selection OR by selecting the next radio button and defining your date range with the dropdown options available.

Data display

By default, the data displayed in the engagement reports is daily (1 day). Should you like to view this data across different intervals, you can choose an explicit number of days or weeks to aggregate the data for the report. So instead of seeing daily metrics, you can look at your engagement by week, month, quarter, etc. Should a time-centric aggregation not suffice, you can also elect to export data at the campaign or Canvas level.

Schedule your report

There are two options when scheduling your report:


Send immediately

After the report is saved, Braze will send this report Immediately

Send at a designated time

This option gives you the flexibility to choose how frequently you would like to receive this report. You can choose to send this report every X days, weeks or months. Additionally, you can define when to stop sending the report.

Open report

You will receive an email with links to your reports. When you click on the provided links you will automatically download a ZIP file containing your CSV files-one for all Campaigns.

The report, when opened, will contain all the statistics selected in the Add Stats section of the setup process.

New Stuff!