You can utilize Campaign Exports in MoEngage to obtain detailed reports on your campaign performance. These reports help you analyze key metrics, including campaign attributes, target audience reach, delivery statistics, conversions, and performance, broken down by locale and variation. You can extract these reports for a specific date range or view data day by day.
You can export two types of campaign reports:
- Basic: This option allows you to generate a default report quickly.
- Advanced: This option allows you to select specific campaigns, customize report attributes, and schedule your exports.
Export a Basic Report
To export a basic report, perform the following steps:
- On the All campaigns page in the MoEngage UI, click Export in the upper-right side.
- On the Export campaign data dialog box, click Basic and then click Continue.
The Export now pane appears. - In the Teams list, select a team (note that this option is visible only if the Teams feature is enabled for your workspace). To create a report using data from multiple teams, simply select all desired teams from the list; just ensure you have the necessary access permissions for each team you include.
- In the Channels list, select the channel types for which you want to export campaign data.
- In the Campaign date field, enter the date range for your campaign selection. Only active campaigns within this selected range are included.
For example, if you select January 1 to January 31, all campaigns with at least one impression during this period are included. - In the Created by list, select the required user names to filter campaigns created by specific users. This field is optional.
- Click Export.
| info |
Note The report is sent to the email address of the logged-in user within 6 hours. |
Export an Advanced Report
To export an advanced report, follow these steps:
Option 1
- On the left navigation menu in the MoEngage UI, go to Reports > Campaigns.
- On the Campaign reports page, click the + New report button in the upper-right corner.
The Export campaigns page appears.
Option 2
- On the All campaigns page, click Export in the upper-right corner.
- On the Export campaign data dialog box, click Advanced and then click Continue.
The Export campaigns page appears.
The advanced report process consists of three steps:
Step 1: Select Campaigns
You can filter and export specific campaigns to include in your report.
- In the Report name field, enter a name for your report. The name must be alphanumeric, start with a letter, and be less than 128 characters long.
- In the Teams list, select a team (note that this option is visible only if the Teams feature is enabled for your workspace). To create a report using data from multiple teams, simply select all desired teams from the list; just ensure you have the necessary access permissions for each team you include.
- In the Channels list, select the channel types for which you want to export campaign data.
- In the Campaign dates field, enter the date range for campaign selection. Campaigns that are active during this period are included, even if they have no impressions. For example, if you select January 1 to January 3, and a campaign (C1) was created on January 1 and had no impressions until January 5, C1 is still included in the report because it was active within the selected date range.
info Note
You can only export data for 90 days at a time. If you need to export for a longer duration, such as 180 days, create multiple reports (for example, Day 0 to Day 90 and Day 90 to Day 180).
- In the Campaigns section, select campaigns to include in the report. You have two options:
- Select all campaigns: Includes all campaigns that meet the filter conditions.
-
Select campaigns manually: Choose specific campaigns to include. Use the campaign search and sorting options to find the campaigns you need.
- Click the Filter campaigns icon to apply advanced filters:
- Under Has campaign tags, select an option.
- All of these: This option allows you to filter the campaigns that have all the selected tags.
- Any of these: This option allows you to filter the campaigns that have any of the selected tags.
- In the Select tags list, select the required tags.
- In the Created by list, select the user who created the campaign.
- In the Approved by list, select the user who approved the campaign.
- Select the Include archived campaigns in the report check box to include archived campaigns in your exports.
- Click Next.
- Under Has campaign tags, select an option.
|
Early Access This is an Early Access feature. To enable it for your account, please contact your MoEngage Customer Success Manager (CSM) or the Support team. |
You can filter and export specific campaigns to include in your report.
- In the Report name field, enter a name for your report. The name must be alphanumeric, start with a letter, and be less than 128 characters long.
- In the Teams list, select a team (note that this option is visible only if the Teams feature is enabled for your workspace). To create a report using data from multiple teams, simply select all desired teams from the list; just ensure you have the necessary access permissions for each team you include.
- In the Campaign channels list, select the channel and delivery types for which you want to export campaign data. The number of selected combinations is displayed. You can hover over the number to see the list of selected channels and delivery types.
- In the Campaign dates field, enter the date range for campaign selection. Campaigns that are active during this period are included, even if they have no impressions. For example, if you select January 1 to January 3, and a campaign (C1) was created on January 1 and had no impressions until January 5, C1 is still included in the report because it was active within the selected date range.
info Note
You can only export data for 90 days at a time. If you need to export for a longer duration, such as 180 days, create multiple reports (for example, Day 0 to Day 90 and Day 90 to Day 180).
-
In the Include performance data field, choose your preferred timeframe:
-
Only for the selected date range: Restricts the data to your specifically chosen dates.
-
For the entire campaign duration: Includes the lifetime performance data of the campaign, from start to finish.
-
- In the Campaigns section, select campaigns to include in the report. You have two options:
- Select all campaigns: Includes all campaigns that meet the filter conditions.
-
Select campaigns manually: Choose specific campaigns to include. Use the campaign search and sorting options to find the campaigns you need.
- Click the Filter campaigns icon to apply advanced filters:
- Under Has campaign tags, select an option.
- All of these: This option allows you to filter the campaigns that have all the selected tags.
- Any of these: This option allows you to filter the campaigns that have any of the selected tags.
- In the Select tags list, select the required tags.
- In the Created by list, select the user who created the campaign.
- In the Approved by list, select the user who approved the campaign.
- Select the Include archived campaigns in the report check box to include archived campaigns in your exports.
- Click Next.
- Under Has campaign tags, select an option.
Step 2: Define Report Format and Content
You can select the attributes for all channels you selected in the previous step:
- Click the channel type.
- Select the attributes to include in the report. You can use the default selection or choose attributes manually. Each selected attribute appears as a new column in the report.
- To add custom attributes, configure a mathematical combination of existing campaign statistics attributes.
For example, if you want to add Click-Through Rate (CTR), set the attribute name as "CTR" and the attribute value as @{campaign-stats.clicks} / @{campaign-stats.impressions}.
- Choose how to display campaign statistics:
- Aggregate: View performance statistics aggregated over the campaign's lifetime.
- Day-wise: View a daily performance breakdown for the campaign. For example, if a campaign is active for seven days, the report shows statistics (impressions, conversions) for each of those seven days.
- Select the Include stats only in the date range check box to pull reports that include data only from your specified date range.
- Select the level of data granularity. You can export statistics broken down by variations and locales. This means the report will include a new row for each variation or locale.
| info |
Note MoEngage does not support locale-level reporting for all channels. This is only supported for In-App, Push, Email, SMS, and RCS campaigns. |
- Select your export format.
- Click Next.
| info |
Note All metrics are calculated and displayed in the App's Timezone. |
|
Early Access This is an Early Access feature. To enable it for your account, please contact your MoEngage Customer Success Manager (CSM) or the Support team. |
Use the left panel to select attributes for your chosen channels and view the report preview on the right.
- Click the channel type.
- Select the attributes to include in the report. You can use the default selection or choose attributes manually. Each selected attribute appears as a new column in the report.
- Use the Search bar to filter for the exact attributes you need.
- If your channels share the same columns, click the Copy function to easily duplicate them. When the Copy columns from another channel window appears, review the list of columns that can be copied and columns that will be skipped. Then, choose how to apply the changes:
- Keep existing selection: Adds the new columns to your current list.
-
Override existing selection: Replaces your current columns with the new ones.
- Use Expand All or Collapse All to manage your view of the selections.
- The Report format preview panel offers a real-time structural mockup. It displays the fields you select from the Report configuration and columns panel, without pulling in actual campaign data, allowing you to visualize and adjust the layout as you build it.
- Select your preferred Split data options to categorize report rows by date, campaign, variation, or locale.
-
By date
Creates a unique row for every day within your selected time range. This is best for tracking performance trends over time. -
By child reportType
Generates a separate row for each child campaign within a periodic campaign. Use this to see how specific segments of a recurring campaign are performing individually. -
By variations
Breaks down data into individual rows for each version of an A/B test. This is essential for identifying which specific creative or copy variation is winning. -
By locales
Produces a separate row for each geographical or linguistic market. This helps you compare performance across different regions or languages.
-
- Click Next.
| info |
Note All metrics are calculated and displayed in the App's Timezone. |
Step 3: Schedule and Deliver Reports
- Configure the report schedule (Daily, Weekly, Monthly, or other options).
- Select a Delivery Mode. You can receive reports via email or extract them using APIs. For more information, see Campaign Report API.
- Click Create report.
|
Early Access This is an Early Access feature. To enable it for your account, please contact your MoEngage Customer Success Manager (CSM) or the Support team. |
In this step, you can define when the report should be generated and how it should be delivered to you.
- Under Send report field, Select the frequency and timing for your report:
-
One Time:
-
As soon as possible: The report will be generated and sent immediately after you click "Create report".
-
At specific date and time: Choose a specific future date and time for the report to be sent.
-
-
Periodic: Schedule the report to be sent automatically at regular intervals:
-
Daily: Sent every day at a specified time.
-
Weekly: Sent on specific days of the week.
-
Monthly: Sent on a specific date every month.
-
-
At specific date and time
If you selected a specific timing or periodic schedule, configure the following:-
Start date: Click the calendar icon to select the date you want the reporting to begin.
-
Send time: Set the exact hour and minute, and select am or pm.
-
-
- Under Report Delivery field, define the file technicalities and the destination for the report:
- File format: Choose between CSV or EXCEL.
- Separator: If CSV is selected, choose the delimiter for your data (Comma ,, Pipe |, Colon :, or Semicolon ;).
- Compression: Select the archive format for the file: Zip, Rar, or Tar.
- Send to:
- Email: Enter the email addresses where the report link should be sent. You can select from existing users in the dropdown. You can select a maximum of 15 recipients for email reports
-
REST API: Select this if you wish to push the report to a configured endpoint via API.
For more information, see Campaign Report API.
- Click Create report.
Manage Exported Reports
You can find exported reports using the following options:
- Search by report name: Locate reports by name.
- Filter: Narrow results by Report type, Report status, Created by, and Team name.
The following fields are available on the Campaign Reports page:
| Field | Description |
|---|---|
| Report Name | Displays the unique name of the report. |
| Created By | Identifies the user who created the reports. |
| Created At |
Displays the time and date when the reports were created. |
| Scheduled At | Displays the time and date when the report must be generated. |
| Teams | Identifies the specific team it belongs to. |
| Report Type |
Displays the type of each report (for example, Onetime). |
| Status |
Displays the status of the report (for example, Successful, Failed, Queued). |
| Actions |
Click the three dots and select Duplicate, Delete, Send to me, or Run again for their respective actions on your desired report. |
| info |
Information To view a report containing data from multiple teams, a user must have access permissions for every individual team included in that report. If a user lacks access to even one of the selected teams, they cannot view the report. |
Understand Report Output Format and Structure
If you choose email as the delivery mode, you will receive a .zip file. The file name combines:
- The report name (same as entered in the Campaign Report Builder), with spaces replaced by underscores. For example: "Report test" becomes "Report_test".
- The report generation date in YYYYMMDD format. For example: "20210217" indicates the report generated on February 17, 2021.
- The compression format, such as .zip.
For example, a final file name might be Report_test_20210217.zip.
File Naming Convention
Channel-Level Reports
If you extract channel-level reports, the .zip file contains a separate file for each channel in the format <Report Name>_<Channel Name>.
Flow Reports
If you extract flow reports, the .zip file contains:
- A flow file in the format <Report Name>_<FLOWS>.
- Separate files for each channel in the format <Report Name>_<Channel Name>.
| info |
Note If you use only a few channels in your report, you will only receive reports for those channels within your selected flows. All metrics are calculated and displayed in GMT for point channel campaigns associated with Flows. |
File Format
Row: Each row represents a distinct campaign, including all relevant details specific to that campaign within the row.
Columns: Each column represents a different attribute. These columns correspond to the customized attributes you selected in Step 2 of report creation.
- Periodic or Flow Campaigns: Periodic or flow campaigns have multiple child instances. Each instance appears in a separate row in the output file. The column for the parent campaign ID is empty for parent campaigns.
- Day-wise Reports: Day-wise reports include a "Date" column. Each row shows the statistics for that specific date.
- Variation and Locale-Level Reports: Variation and locale-level reports include "Variation" and "Locale" columns. Each row shows the statistics for a specific variation and locale.
Understand Channel-Specific Delivery Statistics
General Campaign Report Columns
| # | Column Name in Report | Calculation |
|---|---|---|
| 1 | Delivery Rate | Delivered or Sent |
| 2 | Open Rate | Unique Opens or Delivered |
| 3 | Click-Through Rate (CTR) | Unique Clicks or Delivered |
| 4 | Conversion Rate | Converted Events or Delivered |
| 5 | Hard Bounce Rate | Hard Bounces or Sent |
| 6 | Unsubscribe Rate | Unsubscribes or Sent |
Email Campaign Statistics
| # | Metric | Calculation |
|---|---|---|
| 1 | Bounce Rate | (((Total hard bounces) + (Total soft bounces)) / (Total Sent emails)) * 100 |
| 2 | Open Rate | ((Total unique opens) / (Total delivered emails)) * 100 |
| 3 | Adjusted Open Rate | ((Total unique authentic user opens) / (Total delivered emails)) * 100 |
| 4 | CVR (View Through) | ((Unique conversions) / (Total impressions)) * 100 |
| 5 | CVR (Click Through / In-Session) | ((Unique conversions) / (Total clicks)) * 100 |
Push Campaign Statistics
| # | Metric | Calculation/Description |
|---|---|---|
| 1 | Attempted | Number of users who qualified for the campaign and for whom MoEngage tried sending the message (derived from 'Active Device Tokens'). |
| 2 | Sent Rate | Percentage of campaigns that were sent out of the campaigns that were attempted. (Sent / Attempted) * 100 |
| 3 | Failed Rate | Percentage of campaigns that failed out of the campaigns that were attempted. (Failed To Send / Attempted) * 100 |
| 4 | Impressions | Represents the number of user devices that have received the notification sent by the marketer. |
| 5 | CVR (View Through) | ((Unique conversions) / (Total impressions)) * 100 |
| 6 | CVR (Click Through / In-Session) | ((Unique conversions) / (Total clicks)) * 100 |
SMS & MMS Campaign Statistics
| # | Metric | Calculation/Description |
|---|---|---|
| 1 | Delivered | The count of users to whom the message has been delivered successfully. |
| 2 | Delivered Rate | Percentage of messages successfully delivered out of the messages MoEngage sent. (Delivered / Sent) * 100 |
| 3 | Clicked | Number of times the URL in your SMS/MMS was clicked by the users who received your message. |
| 4 | CTR (Click Through Rate) | (Total Clicked / Delivered) * 100 |
| 5 | Conversion Rate (CVR) | ((Number of conversions) / (Delivered)) * 100 |