In-app messages
In-app messages help you get content to your user without interrupting their day with a push notification. Customized and tailored in-app messages enhance the user experience and help your audience get the most value from your app. With a variety of layouts and customization tools to choose from, in-app messages engage your users more than ever before. For in-app message examples, check out our case studies.
Prerequisites
Before you can use in-app messaging, you’ll need to integrate the Braze Swift SDK into your app. However, no additional setup is required.
Message types
Each in-app message type is highly customizable across content, images, icons, click actions, analytics, display, and delivery. They are enumerated types of Braze.InAppMessage
, which defines basic behavior and traits for all in-app messages. For the full list of in-app message properties and usage, see the InAppMessage
class.
These are the available in-app message types in Braze and how they will look like for end-users.
Modal
in-app messages appear in the center of the screen and are framed by a translucent panel. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Modal Image
in-app messages appear in the center of the screen and are framed by a translucent panel. These messages are similar to the Modal
type except without header or message text. Useful for more critical messaging, they can be equipped with up to two analytics-enabled buttons.
Full
in-app messages are useful for maximizing the content and impact of your user communication. The upper half of a Full
in-app message contains an image, and the lower half displays text and up to two analytics-enabled buttons.
Full Image
in-app messages are similar to Full
in-app messages except without header or message text. This message type is useful for maximizing the content and impact of your user communication. A Full Image
in-app message contains an image spanning the entire screen, with the option to display up to two analytics-enabled buttons.
HTML
in-app messages are useful for creating fully customized user content. User-defined HTML Full in-app message content is displayed in a WKWebView
and may optionally contain other rich content, such as images and fonts, allowing for full control over message appearance and functionality.
iOS in-app messages support a JavaScript brazeBridge
interface to call methods on the Braze Web SDK from within your HTML, see our best practices for more details.
The following example shows a paginated HTML Full in-app message:
Note that we currently do not support the display of custom HTML in-app messages in an iFrame on the iOS and Android platforms.
Control
in-app messages do not contain a UI component and are used primarily for analytics purposes. This type is used to verify receipt of an in-app message sent to a control group.
For further details about Intelligent Selection and control groups, refer to Intelligent Selection.