Alert Analytics comprises 2 sections: Request Performance and Channel Performance.
The Request Performance section of the dashboard gives you information about the number of requests received, their statuses, error stats for the requests, and trends.
Filter Requests
You can filter the statistics available by specifying the period for which you want to analyze the performance using the Date Range option.
The following options are available in the Date Range filter:
-
- Today
- Yesterday
- Last 7 Days
- This Week
- Last Week
- Last 30 Days
- This Month
- Last Month
- Custom Range
- Last ‘X’ Days/Weeks/Months
Request Performance
This section helps you understand the API level metrics and performance as illustrated below.
Stats available
This section shows the number of requests received by the Alert API for a given Alert ID and has the following metrics:
-
- Total requests received
- Count and Percentage of requests processed successfully by MoEngage (sent to your chosen Email / SMS service provider)
- Count and Percentage of requests that failed to be processed and sent by MoEngage
Error Table
The Request (API level) errors are shown in a table as illustrated below.
The error table contains the following information:
-
- Error code
This field contains the error code returned by the API for the request. - Error
This field contains information about the type of error encountered while processing the request. - Description
This field contains a description of the error returned by the API for the request. - Count(%)
This field contains the number & percentage of errors (as a total of total errors) encountered for each error type.
- Error code
For example, if there is an invalid alert ID in the request (when the Alert ID of a stopped Alert is used in the request), the error table is as follows.
List of Possible Errors
Here is a list of possible errors that may occur at the API level.
Error Code | Error | Description |
---|---|---|
400 |
Bad Request |
This response is returned in the following cases:
|
401 |
Authorization Failed |
This response is returned when the authorization fails due to incorrect values for the APPKEY and HTTP Auth Header. |
409 |
Duplicate Request |
This response is returned when a request is sent with the same transaction id as a previously successful or in-progress request within a 5-minute interval. |
429 |
Rate Limit Reached |
This response is returned when the number of requests per minute has exceeded 10k. |
500 |
Internal Server error |
This response is returned when the system runs into an unexpected error. |
Time Trends
The Trends section showcases the performance of the Alerts based on the following granularities:
- Hours
- Days
- Weeks
- Months
For example, in the images shown below, the number of requests received and the number of requests that were sent for an Alert are shown in weekly time intervals.
Channel Performance
The channel performance is available for all the channels configured in the Alert.
Stats available
This section varies according to the channel. The channel-level metrics and error details are available here.
The following stats are available for the SMS channel:
-
Total Requests Received
This is the total number of requests received for a given Alert with SMS channel details as part of the payload. In the case of Alerts with multiple channels, this number denotes the number of requests with SMS as part of it. -
Requests Processed Successfully (Sent)
This is the total number of SMS requests processed successfully or sent to the vendor successfully. -
Delivered
This is the total number of requests that have been delivered to the user. This is only available for Alerts employing native SMS connectors in MoEngage. -
Clicks
This is the total number of clicks by all the users (who have received the messages) for the links in the message. In cases where multiple links are present in the message, this will show the aggregate of total clicks across all links. -
Delivery Failed
This is the total number of requests for which the SMS notification has not been delivered. This information is passed on to the SMS vendor and can represent various reasons like the Recipient is unreachable, the Inbox full, and so on. For more information, refer to Common SMS Errors.
The following stats are available for the Email channel:
-
Total Requests Received
This is the total number of requests received for a given Alert with Email channel details as part of the payload. In the case of Alerts with multiple channels, this number denotes the number of requests with Email as part of it. -
Requests Processed Successfully (Sent)
This is the total number of email requests processed successfully or sent to the vendor successfully. The percentage denotes the total request processed successfully for every request received. -
Delivered
This is the total number of emails that have been delivered to the user. This is only available for Alerts employing vendors SendGrid and Amazon SES. The percentage denotes the total number of emails delivered successfully for every request received. For more information, refer to Common Email Errors. -
Clicks
This is the total number of clicks by all the users (who have received the messages) for the links in the email body. -
Opened
This is the total number of opens for the emails sent. This is counted for all users to whom the Alert emails were sent. -
Delivery Failed
This is the total number of requests for which the emails have not been delivered. - BouncesThis is the total number of hard bounces for the Email channel.
For more information, refer to Email Channel Stats.
The following stats are available for the Push channel:
-
Total Requests Received
This is the total number of requests received for a given Alert with Push channel details as part of the payload. In the case of Alerts with multiple channels, this number denotes the number of requests with Push as part of the payload. - Total Device Tokens Applicable This is the total number of user devices that qualify to receive the notification per request. Note: Only the five most recently active device tokens available in the User Profile will be considered for sending the Alert for the Push channel.
-
Requests Processed Successfully
This is the total number of Push notification requests processed successfully or sent to the vendor successfully. The percentage denotes the total request processed successfully for every request received. -
Total Request Delivered(Impressions)
This is the total number of user devices that have received the notification. -
Total Clicks
This is the total number of notifications clicked by the users after the notification delivery for every request received. -
Delivery Failed
This is the total number of requests for which the notifications have not been delivered due to errors in sending the messages to GCM/APNS. For more information, refer to Common Push Errors.
For more information, refer to Push Channel Stats.
The following stats are available for the WhatsApp channel:
-
Total Requests Received
This is the total number of requests received for a given alert with WhatsApp channel details as part of the payload. In the case of alerts with multiple channels, this number denotes the number of requests with WhatsApp messages as part of it. -
Requests Processed Successfully (Sent)
This is the total number of WhatsApp requests processed successfully. -
Delivered
This is the total number of WhatsApp requests that have been delivered to the user. -
Read
This is the total number of WhatsApp messages read by the user.
For more information, refer to WhatsApp Stats. -
Clicks
This is the total number of clicks by all the users (who have received the messages) for the links in the WhatsApp message. In cases where multiple links are present in the message, this will show the aggregate of total clicks across all links.