Report Alerts

Overview

You can use alerts to set up Slack or email notifications when Heap graph or funnel analysis results go above or below a certain threshold. This enables you to quickly spot and address changes in crucial business metrics.

For example, if you see a drop in checkout conversion, you can review and fix any issues within that flow that might be holding back potential buyers. If you see a sudden increase in new signups, you can tailor marketing efforts to this new group of users to encourage additional engagement.

We recommend setting alerts for reports that you tend to check often, such as multiple times a week. You can set the alert threshold to ensure you’re only receiving them when significant changes occur.

Set New Alert

You can set alerts on graph and funnel reports. To set an alert, navigate to the report you want to add the alert for or save a new report.

To add the alert, click the three dots in the top-right corner and click Configure Threshold Alerts in the drop-down that appears.

In the pop-up that appears, select: 

• Whether the alert should be set off by an increase or decrease in metrics
• The amount and type of change:
  • Percent: If you have a conversion rate of 50%, and you choose a threshold of 10%, you’ll get alerted if the conversion rate drops below 45%
  • Percentage points: If you have a conversion rate of 50%, and you choose a threshold of 10 percentage points, you’ll get alerted if the conversion rate drops below 40%
• The comparison period for the alert to be compared to, e.g. previous month, quarter, or year
• Send via Email: Add the email addresses that the alert should be sent to – you can select a Heap team member via autocomplete or type in a non-Heap team members’ email
• Send via Slack: Select the Slack channels this alerts should be sent to – note that you cannot set up report alerts for private Slack channels

Once you click Enable, the alert will be set for this report.

For email alerts, when the alert is set off, all email addresses added to the alert will immediately receive an email like the one below. Note that alerts will be computed at 1am PDT (12am PST once DST is over) nightly, regardless of the recipient’s time zone.

Add Heap to Slack

To set alerts that will be delivered as Slack notifications, you must first set up Slack with your Heap workspace. You’ll be prompted to do this when setting up an alert. Click the ‘Add Heap to Slack…’ button to get this set up.

You’ll be prompted to grant permission for Heap to access Slack. Once you grant permission, you’ll be redirected back to Heap to finish setting up your alert.

Once enabled, here’s how your alert will look in Slack:

Viewing Reports with Alerts Set

To see reports that have alerts enabled, navigate to the Reports page, click the Has Alerts option from the Alerts dropdown.

Updating & Deleting Alerts

You can review and update an alert at any time by navigating to the report and selecting Configure Threshold Alerts via the drop-down in the top-right corner.

Review and update the options listed in the Edit Alert pop-up to your heart’s content. You can also delete this alert by clicking Remove Alert in the bottom left corner.

Limitations

Currently, alerts are not supported for:

• Reports using a group by
• Reports using a compare
• Reports using the date range granularity ‘Date to Now’
• Reports using a custom date range
• Graphs using Hour, Week, or Month granularity
• Graphs using average time between
• Graphs with ratios
• Multigraphs
• Environments aside from Production