Building a great campaign is only half of the equation — making sure your users actually receive it and engage with it is just as important! With alerts, you can set up performance thresholds that notify you when a campaign isn't performing as expected. If a campaign exceeds one of your alert thresholds, you'll receive a notification in Slack prompting you to sign in and review the campaign's performance.
# In this article
# Required permissions
To create and manage alerts for your project, you'll need the Manage Project Settings permission.
To turn alerts on/off for a campaign, you'll need the Draft Campaigns permission.
# Setting up alerts for your project
To set up your project's alerts, click the gear icon in the navigation toolbar, select Current Project, and select Alerts.
TIP
You can also set up alerts for your project from the Alerts pane on the Command Center homepage.
This opens the Alerts page, where you can create and edit your project's alerts.
You can create alerts for blast and triggered campaigns for these messaging channels:
- Embedded
- In-app
- Push
- SMS
- Web push
NOTE
Campaign Alerts aren’t supported for the RCS message channel at this time.
Alerts can notify you when a campaign has a high bounce rate or unsubscribe rate, a low click rate or clicks, a low open rate or opens, or low sends. (To learn more about how these metrics are calculated, see Metric Definitions.)
# Create an alert
To create an alert, check the box next to the performance metric you want to monitor. Then, enter a value and time frame.
# Choose a destination
Next, set up a webhook to connect Iterable to your alert destination. On the Alerts page, scroll down to the Alert Destination section and click Add Webhook.
Right now, we support Slack as an alert destination, and we'll be adding support for additional destinations in the future.
Give your webhook a name (for example, "Slack Webhook") and choose an authentication option if desired. Leave the Endpoint URL blank for now (you'll fill this in later after you generate a web request URL in Slack).
# Create a Slack workflow
NOTE
Slack workflows require a paid Slack plan. Contact your Slack workspace admin if you need help accessing the Workflow Builder.
To receive performance alert notifications in Slack without signing in to Iterable, create a Slack workflow.
For details on how to create the workflow in Slack's interface, see:
- Build a workflow: Create a workflow in Slack
- Build a workflow: Create a workflow that starts outside of Slack.
Make these choices in the Workflow Builder:
Start the Slack workflow from a webhook. This is the trigger that lets Iterable start the workflow.
-
Add a variable for each field value you want to see in your alert message. For example, you might want to know the campaign's name, ID, medium, type, and state; the template ID; the metric that triggered the alert; and the link to the campaign's analytics page.
For each variable, enter a key and a data type. The key is the name of your variable, and the data type is the kind of data that Slack populates for the variable in each notification you receive. You can add any of the keys in the following table. Enter each key exactly as shown in the table, and use
textas the data type for all variables.Key Data type Information in the notification campaignNametextCampaign name campaignIdtextCampaign ID campaignMediumtextCampaign medium campaignTypetextCampaign type campaignStatetextCampaign state templateIdtextTemplate ID metricAlertNametextName of the metric that triggered the alert campaignAnalyticsLinktextLink to the campaign's analytics page metricAlertTexttextAlert text Add a step that sends a message to your Slack channel. In the message, type any text and emojis you'd like and insert the variables you set up earlier. At send time, Slack replaces each variable with the relevant information for the affected campaign.
Publish the workflow.
# Connect your Slack workflow to Iterable
After you publish your Slack workflow, copy its Web Request URL and add it to the Iterable webhook you created earlier:
-
In Slack, open your published workflow and copy its Web Request URL.
Keep the Web Request URL private. Anyone who has it can start your workflow.
In Iterable, click the gear icon in the navigation toolbar, select Current Project, and select Alerts. Scroll down to the Alert Destination section.
Click the three dots next to your Slack webhook, and click Edit.
-
Under Endpoint URL, paste the Web Request URL you copied in Slack, and click Save Changes.
-
The next time an alert is triggered for one of your campaigns, you should receive a message in your selected Slack channel.
# Enabling and disabling alerts for a campaign
After you set up alerts for your project, any new campaigns you and your team members create automatically have alerts enabled. But you can turn alerts on or off for individual campaigns during the campaign setup process.
# Stand-alone campaigns
To enable or disable alerts for a stand-alone campaign, go to the Campaigns page and create or edit a campaign. In the Delivery and Compliance section, switch the Alerts toggle on or off as needed. Save your changes, and schedule or send the campaign when you're ready.
You can also disable alerts for a campaign from the Campaigns page. Click the three dots, and select Disable alerts.
# Journey campaigns
To enable or disable alerts for a campaign that's part of a journey, open the journey in Studio and add or edit the message tile for the campaign you're interested in. In the Delivery and Compliance section of the tile settings menu, check or uncheck the Alerts box as needed. Click Save Campaign or Update Campaign to apply your changes. When you're ready, save and publish the journey to activate the campaign and start sending it to users who pass through the tile.
# Viewing campaign alerts
The easiest way to view campaign alerts is to open the Command Center where you can view your most recent alerts on the Alerts tab.
You can also check which campaigns have alerts enabled on the Campaigns page. Campaigns that have alerts enabled are indicated with a bell icon.
When a campaign has had an alert within the last 24 hours, a purple alert icon appears in the Status column.
To see a list of recent alerts for a specific campaign, click the three dots and select View alerts.
# Editing your project's alerts
You can make changes to your project's alerts settings at any time. Turn an alert on or off, or adjust the value or time frame, then click Save.
When you edit an alert for triggered campaigns, Iterable uses the new alert settings for all campaigns that haven't been sent yet. For example, if you create an alert that notifies you of a <10% click rate after 24 hours and then change the click rate percentage to <5% before Campaign 1 has been sent, you'll only be notified if Campaign 1's click rate is less than 5% 24 hours after it was sent. If you edit the alert after Campaign 1 has started sending, you'll be notified if its click rate is less than 10% after 24 hours.
# How alerts work
Alerts work slightly differently for blast campaigns and triggered campaigns. It's important to understand how Iterable evaluates your configured performance thresholds for blast and triggered campaigns so you know when and how often you can expect to receive performance alert notifications.
# Blast campaigns
After you send a blast campaign, your specified performance thresholds are evaluated once according to the time frame you've set up for each alert. Once a blast campaign has been sent and you've received notifications for any alerts that occurred, you won't receive any more performance alerts for that campaign.
# Example
Configured alert: Open rate < 10% one hour after send time
| Date | Time | Campaign Performance Status | Alert Notifications |
|---|---|---|---|
| June 15 | 9:00 AM | Campaign sent | None |
| June 15 | 10:00 AM | Open rate = 7% | 1 notification |
# Triggered campaigns
With triggered campaigns, your specified performance thresholds are continuously monitored for as long as the campaign is activated. Performance alert thresholds for triggered campaigns are evaluated within a 24-hour window, according to the cadence determined by the time frame you've specified for each alert. This means you could receive more than one notification for the same alert if it occurs more than once during a 24-hour period.
# Example
Configured alert: Open rate < 80% within the last 12 hours
| Date | Time | Campaign Performance Status | Alert Notifications |
|---|---|---|---|
| June 15 | 9:00 AM | Campaign activated | No notification |
| June 15 | 9:00 PM | Open rate = 90% | No notification |
| June 16 | 9:00 AM | Open rate = 75% | 1 notification |
| June 16 | 9:00 PM | Open rate = 60% | 2 notifications (1 new, 1 existing alert from 9:00 AM) |
| June 17 | 9:00 AM | Open rate = 75% | 1 notification |
| June 17 | 9:00 PM | Open rate = 70% | 2 notifications (1 new, 1 existing alert from 9:00 AM) |
| June 18 | 9:00 AM | Open rate = 70% | 1 notification |
| June 18 | 9:00 PM | Open rate = 90% | 1 notification (existing alert from 9:00 AM, no new alert) |
# Current feature limitations
- You can only turn alerts on for a campaign if project alerts are set up for that message type/channel.
- Project alerts apply to all campaigns for which alerts are enabled — you can't apply specific alerts to a specific campaign.
- You can only receive alert notifications via webhooks, not via email.
- Campaign performance alerts only show specific alert values, not performance trends (a percentage up or down).
# Frequently asked questions
# Do I need to configure a project-level alert before I can enable it for my campaign?
Yes. Right now, any alerts you wish to apply to a campaign must be set up on your project's Alerts page.
# Are alerts automatically enabled for campaigns I've already created?
No, only newly created campaigns. However, you can open any campaigns you created prior to when this feature was released and manually turn on alerts in the Delivery and Compliance section.
# Will I be able to receive alert notifications by email in the future?
Yes, future versions of this feature will support email notifications.
# Can I set up alerts for conversions or events?
Not at this time.
# Want to learn more?
For more information about some of the topics in this article, check out this Iterable Academy course. Iterable Academy is open to everyone—you don't need to be an Iterable customer!