Documentation Index

Fetch the complete documentation index at: https://moengage.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

Alerts let you monitor your analysis data without manually checking dashboards. You define a condition on a saved analysis, and MoEngage emails you when that condition is met — so you can respond to anomalies, drops, and spikes as soon as they happen. You can create alerts on the following analysis types:

• Behavior
• Retention
• Funnels
• Session and source

​

Applications

With alerts, you can:

• Track behavior trends — get notified when total events, unique users, or unique sessions for a tracked event change significantly.
• Monitor retention — watch a specific retention day, such as D7, and get notified when retention moves up or down.
• Catch funnel drop-offs — alert on conversion between any two steps of a funnel to spot regressions in the customer journey.
• Watch session and acquisition health — track session count, bounce rate, or revenue across sources and get notified when a key metric shifts.

​

Who can create alerts

Alerts can be created and managed by users with the Admin, Manager, Marketer, or Analyst role. Developers can’t create or manage alerts. You can configure alert access for each role under Settings > Account > Team Management > OOB Alerts Management.

​

Create an Alert

Creating an alert is a two-step process: Step 1: Create Analysis Step 2: Create a new Alert

​

Create Analysis

You can set an alert on any saved Behavior, Retention, Funnel, or Session and source analysis. The high-level flow is the same across analysis types:

​

Example: Behavior analysis

The following walkthrough creates a Behavior analysis on the App/Site Opened event so you can alert when the app or site is opened more than 50 times.

1. Navigate to the left sidebar on your MoEngage dashboard > Analyze > Behavior.
2. In the Events & Filters section, click the dropdown and then select App/Site Opened.
   Optional

   You can add the following filters to your event:

   • Add multiple attributes - You can add multiple attributes to your event by selecting the AND or OR logical operators. The analysis will execute all the attributes and then display the result to you.
   • Split events - You can use the Split by option to compare the selected attribute with another from the drop-down. To learn more, see Comparing Properties.
   • Add multiple events - You can use the + Add Event button to add a maximum of 10 events to your analysis. The analysis will execute all the events and display the result to you.
3. Filter the users to whom this analysis may apply. The Behavior analysis is performed on all users having access to the workspace by default. You can also segment users using the Filter by users option.
   To learn more, see Filter Users.
4. In the Behavior Options section, select an analysis type to calculate. The following are the analysis types you can create alerts on:
   • Total Events
   • Unique Users
   • Unique Sessions
   • Aggregation
   • Total Events Per User
5. Click Apply.
6. Once you view the Behavior Chart for the selected analysis, click the Save dropdown and then select Save to My Studio.

​

Create a new Alert

Once you’ve created your analysis, you can then set an alert for that analysis from My Studio. To create an alert,

1. Navigate to the left sidebar on your MoEngage Dashboard > Analyze > My Studio.
2. Select your analysis from the list of Saved analysis.
3. Click Apply to view the analysis chart and then select your chart type and related granularity. See Alert Subscription Details for supported chart and granularity combinations.
   • Alerts aren’t supported on hourly chart granularity.
   • Alerts aren’t supported when time-series or segment comparison is applied.
   • The timezone defaults to your app timezone.
4. Click Set alert to create a new alert for the selected analysis.
5. On the Create alert pop-up, enter the following details:
   • Alert Name — a unique name for the alert.
   • Alert Criteria — the trigger condition. The available conditions depend on the analysis type. See Alert criteria by analysis type.
   • Alert Recipients — the email addresses of subscribers who should receive the alert. Recipients must have access to the workspace.
   • Alert evaluation time — when the alert is evaluated and the email is sent.
6. Click Create.

​

Alert criteria by analysis type

The conditions you can set on an alert depend on the analysis type.

​

Behavior

Trigger an alert based on event counts or aggregated values. Available conditions:

• Above — triggers when the count for the selected analysis goes above the threshold value.
• Below — triggers when the count goes below the threshold value.
• Increased by percentage (%) or value (#) — triggers when the count exceeds a comparative threshold relative to a past duration baseline.
• Decreased by percentage (%) or value (#) — triggers when the count falls below a comparative threshold relative to a past duration baseline.

You can also refine the criteria using:

• Select event — the event you chose during analysis creation.
• Select Split by — an event attribute and value. For example, on the App/Site Opened event, split by Platform where Platform is Android.
• Select Compare by — a user attribute and value. For example, on the App/Site Opened event, compare by last known country where country is USA.

​

Retention

Trigger an alert on retention for a specific day in your cohort, such as D7.

• Supports Increased by or Decreased by percentage (%) or value (#).
• Above and Below thresholds aren’t applicable for Retention.

Retention alerts query a rolling window of recent data — up to 365 days for monthly retention. Data older than the window can’t be evaluated for alerts, even if it’s stored in your workspace.

​

Funnel

Trigger an alert on conversion between any two steps of the funnel.

• The first step of the funnel is fixed. You select the second step to compare conversion against.
• Supports Above or Below a percentage, or Increased/Decreased by percentage (%) or value (#).
• Split by attributes are supported.

​

Session and source

Trigger an alert on session-level metrics across sources, such as session count, bounce rate, or revenue.

• Most metrics support Above, Below, Increased by, or Decreased by — either as a fixed value or as percentage (%) or value (#) compared to a baseline.
• Bounce rate only supports Increased by or Decreased by percentage (%).

​

Comparison periods

For Increased by and Decreased by conditions, the comparison periods you can choose depend on the chart granularity: Previous Quarter and Custom Range aren’t supported.

​

View the Email Alert

After you set up an alert, you receive an email when the specified conditions are met. The email includes a visualization and details about the alert: the change in the metric, the percentage change, and the timestamp of when the data was evaluated.

​

Unsubscribe, Subscribe, and Delete Alerts

Follow the steps below to view and manage your alerts in your MoEngage dashboard:

1. Click the Settings icon on the left sidebar of your MoEngage dashboard.
2. Scroll down to Reports and Alerts and then select Alert management from the dropdown.
3. Select the Analytics alerts tab and then search for the alert that you want to view or manage.
   The options listed below can be used to narrow down your alert:
   • Use the search bar to find your alert.
   • Use the Created by dropdown to filter the alert based on the creator’s identity.
   • Use the Subscribed by dropdown to filter the alert based on the alert recipients.
4. Once you locate your alert, click the vertical ellipsis icon under the Actions column at the right end of the table.
5. You can take the following actions:
   • Unsubscribe: After you remove current users from the alert, they won’t get any more alerts for the chosen analysis.
   • Subscribe Others: By choosing a user’s email address from the dropdown, you may add multiple users to the alert subscription.
   • Delete: An alert that is deleted will be permanently removed.

​

Alert Subscription Details

This section explains how alerts behave for different chart types and granularities.

​

Limitations

• A workspace can have a maximum of 10 alerts. To increase this limit, reach out to your CSM or account manager.
• Alerts are delivered by email only.