Set optional message features
You can enable optional features in the Settings step in an In-App Automation or Scene.
Ban List
If your project has a Ban ListAn externally maintained record of users that should not be included in Airship message audiences. Before sending a message, Airship validates the audience members with the Ban List. Any matching recipients are dropped from the audience before sending the message. enabled and its request URL includes send time variables, you can override their default values for this message only. Each one is listed under the heading Default value for <variable>. Enter a new value for any variable.
This setting does not appear if Bypass Ban List is enabled.
Bypass Ban List
Bypass your Ban ListAn externally maintained record of users that should not be included in Airship message audiences. Before sending a message, Airship validates the audience members with the Ban List. Any matching recipients are dropped from the audience before sending the message. when sending business-critical or otherwise required messages, such as privacy policy update notifications.
If you have a Ban List but do not see this option in the composer, enable it in your project settings. See Bypassing your Ban List in the Ban List documentation.
Campaign categories
Campaign categories are labels that group messages of a similar type or messaging strategy for aggregate reporting. Campaigns help you track the efficacy of both your individual messages and a messaging campaign as a whole. You can add a maximum of ten categories.
Enter a campaign category name, then select Add. Category names have a 64-character maximum.
For categories defined in message limits, its limit displays after the category. To override the limit, select the check box for Ignore limit for this message.
Campaign categories are listed in the Message Detail section of Message Reports.
Choose message priority
Assign a priority to ensure that your audience sees the highest priority messages first.
Message priority determines the order in which messages appear to users; messages appear to the user in order from highest to lowest priority. Message priority is an integer between 1-100, where 1 is the highest priority, 100 the lowest. If a user receives two messages with the same priority, the more recently updated message appears first. Priority is shared across In-App Automations and Scenes.For example, you may have two messages configured to display on the next app open: an urgent account security warning, and a promotional marketing message. If you have assigned a high priority to the security warning and a lower priority to the marketing message, the higher priority message will appear first.
Use the slider to set rough priorities, or look at the number value to make fine distinctions.
Setting a priority is useful because multiple messages can become eligible for display at one time.
Setting message priority does not guarantee one message will display before another, because all other other conditions must be met for a message to become eligible for display. Priority is available as a tiebreaker when you have multiple messages ready for display.
Custom keys
Custom keys are additional key-value pairs in your push notification payload for use by custom code in your app or website. You can use custom keys to pass additional campaign identifiers for analytics, pass user information to the device, control the look and feel of the app, provide image links, etc.This option appears in Settings for Scenes only. For In-App Automation, configure custom keys in the Content step.
Enter a key and value. Select Add another for additional keys.
Override default missed behavior action
Override the project-level setting, specifying how the message is handled when audience conditions are not fully met.
Select one of:
Cancel: The message cannot be displayed again on the device, even if the message is edited.
Ignore: The message will not count toward the display limit set in Repeat this message, and the waiting period will not apply. The trigger event must occur again before the message is eligible for redisplay.
Increment: The message will count toward the display limit set in Repeat this message, and the waiting period will apply. The trigger event must occur again before the message is eligible for redisplay.
Ignore channel message limits
Override the project-level Message LimitsLimits that cap the number of messages you can send within a specified time frame, preventing you from over-messaging your users. They are set at the project level. to ensure that your audience will receive your message even if they’ve reached the message limit.
You may want to override message limits for important information like breaking news, account alerts, or location proximity-based content.
This option is present only when one or more multiple-channel message limits are set.
Repeat this message
Determine whether the message can be repeated a limited or unlimited amount of times and the minimum waiting period before it is eligible for redisplay.
- Select Limited number of displays or Unlimited number of displays.
- (For limited displays only) Enter the maximum number of times the message should be displayed.
- Enter the minimum number of seconds, minutes, hours, or days that must elapse before a message becomes eligible for redisplay.
TriggersAn event that causes an In-App Automation or Scene to appear to your audience. are not monitored while a message is ineligible for display. The trigger event must occur again after the minimum time elapses before the message will redisplay.
For example, if you set the maximum number of displays to 3 and the minimum time between displays to 1 week, the message will display a maximum of 3 times and at most once per week.
For Scenes only, you can override Repeat by selecting Dismiss and cancel Repeat when configuring a button’s scene behavior or when configuring the Submit Responses button action. See Button or Button Group in Configure Scene content and Submit responses in Actions for in-app experiences.
Specify start and end dates
Set start and end dates and times during which your message can be displayed.
Select a date, then select a time and time zone.
Categories