With Engagement Reports, customers can now extract data across multiple Campaigns and/or Canvases. Customers have the ability to:
- Run a one time report or Schedule a report to be sent later.
- Email the report Daily, Weekly, or Monthly.
- Set a defined time range of data to include or do a rolling window with scheduled reports.
- Choose a defined number of messages to be included in the report or automatically insert messages based on tags.
- Select from over 20+ KPI Metrics.
- 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.
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.
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.
|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|
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”.
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.
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.
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.
|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|