Message limits
Set message limits to cap the number of messages Airship sends to a user within a time period, preventing you from over-messaging your audience.
Project-level limits
You can set individual limits for push notifications, web push notifications, SMS, and commercial email. Each can have more than one limit, such as 1 message per hour and 3 per day.
Limits are shared within each of these groups:
Scenes and In-App Automations — One limit covers both. A Scene enabled for both app and web counts as one message, so Airship can display it in the app and on the web within the same time period. Embedded ContentAn alternative Scene format that can be displayed on any app or web screen in a view defined by a developer. It can also be presented as a story. is excluded.
Sequences and Automations — Each Automation and each message in a Sequence counts toward the limit. The limit applies to named usersA contact identified with an ID you provide, such as a customer ID from your CRM. Associating channels with that ID maps multiple devices and channels to one individual. Each named user has a unique named user ID., or to each channel when no named user is set.
A message in a Sequence or Automation counts toward both the limit for its channel and the Sequence and Automation limit. For example, with push notifications limited to 1 per day and Sequences and Automations limited to 2 messages per day, a Sequence that sends 2 push notifications in one day delivers only the first.
If a user has reached the push notification limit, Airship suppresses a push notification and any in-app message sent with it from the Airship dashboard, so the user receives neither. Airship still delivers a Message Center message sent with the push notification.
Campaign categories
You can apply a project-level message limit to a single campaign categoryAn optional delivery feature used to group messages of similar types or messaging strategies for aggregate reporting. They help you track the efficacy of both your individual messages and a messaging campaign as a whole.. Every limit type except Sequences and Automations supports this. For example, a limit can cap messages in a Promotions category at 1 per day.
Exclusions
Message CenterAn app inbox where you can display rich messages. The messages support native content, HTML, video, and more. messages are not limited since they only appear within your app and are less obtrusive than other notification types. The user must actively open the messages in your app to experience them.
Silent push notifications are also excluded from message limits since they are not viewed by users.
Set project message limits
Set up to 50 limits for how many messages Airship sends a user within a time period:
- In the sidebar, select the settings icon ().
- Under Project settings, select Message Limits.
- Select Add or Edit for the item you want to limit, then enter the maximum number of messages and a time frame of up to 72 hours or 90 days. Scenes and In-App Automations can also be set to minutes and seconds.
- (Optional, not supported for Sequence and Automation) Select Add a category and choose a campaign category or create a new one.
- Select Add.
Overriding project-level limits
You can override project-level message limits for a message, so Airship sends it even if a user has reached a limit. Overriding limits suits important messages such as breaking news, account alerts, or location proximity-based messages. Message-level limits for Sequences and Automations still apply.
Enable Ignore Channel Message Limits in these composer steps:
- Message, A/B Test, and Automation: Delivery
- In-App Automation and Scene: Settings
In a Sequence, enable it under Limits in the Sequence settings. See Scheduling and frequency in Create a Sequence.
In the API, set the bypass_frequency_limits push option to true in the Push object.
Message-level limits for Sequences and Automations
You can limit the number of messages Airship sends to a user per day or in total from an Automation or a Sequence. A Sequence limit applies to each message in the Sequence individually, so a limit of 1 sends a user each message once.
When a user reaches a message-level limit on an Automation, Airship suppresses the message. When a user reaches a message-level limit on a Sequence, Airship suppresses the message and the user exits the Sequence. A user who reaches a project-level limit, including a category limit, does not exit the Sequence.
For Automations, set limits in the Setup step. See Rule Limits in Create an Automation.
For Sequences, set the limits in the Sequence settings. See Scheduling and frequency in Create a Sequence.