Engagement Reports

With Engagement Reports, customers can now extract data across multiple Campaigns and/or Canvases. Customers have the ability to:

  1. Run a one time report or Schedule a report to be sent later.
  2. Email the report Daily, Weekly, or Monthly.
  3. Set a defined time range of data to include or do a rolling window with scheduled reports.
  4. Choose a defined number of messages to be included in the report or automatically insert messages based on tags.
  5. Select from over 20+ KPI Metrics.
  6. Choose various delimiters and compression types for the report.

How To Use

Creating A New Report

Navigate to Data » Engagement Reports. Note that your Braze user account must have ‘Export User Data’ access to utilize Engagement Reports. To create a new report, click ‘Create New Report’ located on the top right of the page.

engagement_reports_menu

Add Messages

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

engagement_reports_message_selection

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 Stats

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 Sent, Opens, Unique Opens, Clicks, Unique Clicks, Unsubscribes, Bounces, Delivered, Reported Spam
Push Sent, Opens, Influenced Opens, Bounces, Body Clicks
Web Push Sent, Opens, Bounces, Body Clicks
In App Message Impressions, Clicks, First Button Clicks, Second Button Clicks
Webhook Sent, Errors

engagement_report_add_stats

Set Up Report

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. Additional functionality now includes “Data Coverage” and “Schedule Report”.

Data Coverage

Time Frame: By default the data range shown will go from the earliest message selected till 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.

engagement_reports_data_coverage

Schedule 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 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.

engagement_reports_schedule_report

About the Report

  • The report is exported as a link embedded inside of a triggered email.
  • Regardless of the number of Campaigns or Canvases selected, only a max of 2 CSV files will be generated - one for all of the Campaign data, and one for all of the Canvas data.
  • The report, when opened, will contain all the statistics selected in the ‘Add Stats’ section of the setup process.
  • Certain data is aggregated at the ‘Campaign’ or ‘Canvas’ level versus at the individual ‘variant’ or ‘step’ level.

Reports are not saved, and re-running the report can result in updated statistics.

Report Glossary

Statistic Description
Date Represents the date of the data shown. This will coordinate to your company timezone
id Canvas API identifier. You can retrieve a list of Canvas id’s through this API or utilize that identifier to further query details, time series data, and rollups
name Name of the Canvas as written in the dashboard
variant_name Name of the Canvas path as written in the dashboard
step_name Name of the Canvas step as written in the dashboard
unique_recipients Integer count of the number of users who have received Campaign or Canvas messages
type Indicates whether the data in the row are specific to a variant, step, or specific message within a step
sent Integer count of the number of push, email and or webhook messages successfully fired from the platform
delivered Integer count of the number of emails that did not bounce and made it to a user’s inbox
opens (Email) Integer count of all the times users open an email. For the equivalent metric for push, please find total_opens and direct_opens
unique_opens (Email) Integer count of the unique instances users open an email
clicks Integer count of all of the clicks tracked on an Email or In-App Message. Please note that for In-App Messages, this metric only populates for those that do not have buttons
unique_clicks (Email) Integer count of all unique clicks tracked on an email message
reported_spam Integer count of the number of times users clicked on the spam button in their inbox. This metric does not track the number of times an email went directly into a user’s spam folder.
bounces Indicates whether the Email or Push message failed to reach to user. Email-related data will indicate a hard bounce
unsubscribes Integer count of the number of users who unsubscribed from an email message
direct_opens Integer count of all the times users directly clicks/tapped on a push notification
total_opens Integer count of al the time users logged a direct_open or influenced open
entries Integer count of all the users who entered into a Canvas. This number does not always equal the number of users who received messages from Canvas steps, as segmentation and or triggering criteria can affect this
errors Integer count of non-200 error responses from wehook campaigns and Canvases
revenue Any purchase event logged by a user who entered the canvas and is still within the primary conversion event window will be attributed here. The amount is converted into dollars. Users can multiple purchases within this period and all amounts will be attributed back to the day of purchase
conversions Number of users who have performed the primary conversion event, or “conversion event A,” on that particular day
conversions_by_entry_time Number of users who have entered into a Canvas on that particular day and also performed “conversion event A” by the end of the conversion deadline
conversions1 Number of users who have performed “conversion event B” on that particular day
conversions1_by_entry_time Number of users who have entered into a Canvas on that particular day and also performed “conversion event B” by the end of the conversion deadline
conversions2 Number of users who have performed “conversion event C” on that particular day
conversions2_by_entry_time Number of users who have entered into a Canvas on that particular day and also performed “conversion event C” by the end of the conversion deadline
conversions3 Number of users who have performed “conversion event D” on that particular day
conversions3_by_entry_time Number of users who have entered into a Canvas on that particular day and also performed “conversion event D” by the end of the conversion deadline
WAS THIS PAGE HELPFUL?