Banner invitations

A banner invitation prompts users while they are using the app and is a non-blocking invite method. Use a timer to display the invitation for a limited time, or use the sticky feature to keep the invite onscreen until the user decides how to respond.

Once triggered, a transition animation presents the banner to the user. This invite uses the system default, but the native alert system can be selected, and invitation actions can be gesture based or not. The invite position, text, and appearance can be customized.

In-app banner invite at top and bottom of screen.

Additional information for implementing the in-app banner invite includes the following:

SDK version must be above v2.17 for both Android and iOS.
Preserved existing "one invite display per session" logic.
Text is aligned in the center.
Multiple languages are supported in UTF-8.
Supported for both iOS and Android.

Command Center Example (iOS)


Platform	Summary
iOS	The SDK creates a new UIWindow and adds a view controller that contains the banner view as the root view controller
Android	The SDK adds the banner to the activity window. The position is set with the layout parameters. Code example `activity.getWindow().addContentView(bannerView, params)`

Banner Invitation Design options

When a survey form uses a banner invitation, the following options are available.

General settings : Expand to change settings such as font, text, and color.
Position : Where on the device screen to display the banner. Choose from a fully visible banner using Top drawer or Bottom drawer options, or use the partial views feature and the Top partial drawer or Bottom partial drawer option.
Button settings : Expand to change settings such as how gestures control the banner.
Duration : How long the banner should remain shown on the device screen. Choose from either a number of seconds, typed in the text box, or check the Sticky box to have the banner displayed until it is dismissed.
Preview : Adjusted invite preview to visualize where the banner is shown on a mobile devices according to the currently selected position.

General settings

Title : Type the title of the invitation. "Let us know what you think" is the default title. Limited to 30 characters. Cannot be empty.
Body : Type the text of the body of the invitation. "It only take a couple of minutes and will help us improve the app" is the default body text. Limited to 70 characters. Cannot be empty.
Font : Choose from one of the system fonts listed in the drop-down menu to customize the banner's text, for example to align with the font used in the app.
Text Color : Select the text color of the invite. Make sure your selection contrasts with the background color.
Background Color : Select the background color of the invite. Make sure your selection contrasts with both the text color and the mobile app screens on which you intend it to be displayed.

Button settings

Button Display : Override the default gesture based control of the invitation, and instead use buttons to control the invite.

Gesture-based invites

By default the Button Display option is not enabled, meaning the invite is controlled by user gestures. How the invite responds to these gestures depends on the device operating system. Generally, the following gestures are recognized.


Button display	Accept gesture	Dismiss gesture	Decline gesture	Dock gesture
Active	None	Banner invite timeout passed	Swiping up when banner in top position or swiping down when banner in bottom position Swiping sideways (Android only)	Long press on the banner anywhere except the buttons
Inactive	Pressing the banner anywhere	Banner invite timeout passed	Swiping up when banner in top position or swiping down when banner in bottom position Swiping sideways (Android only)	Long press on the banner anywhere

The decline gesture can start a quarantine to ensure the invite is not triggered again for a set period of time. By comparison, if the invite times out after the time period specified by the Duration option then the invite has been deferred.