Creating an In-App Message

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 out of your app. With a variety of layouts and customization tools to choose from, in-app messages engage your users more than ever before.

To see examples of in-app messages, check out our Client Integration Gallery.

Step 1: Create New Campaign

Click Create Campaign to open a new messaging wizard for in-app message campaigns. Then, follow the flow of the messaging wizard to quickly create and launch your in-app message campaign.

createyouriam

  1. Name your campaign something clear and meaningful.
  2. Add Teams and Tags, as necessary.
  3. Add and name as many Variants as you need for this campaign.
    • You can choose different platforms, message types, and layouts for each of your added Variants.
    • If all of the messages in your campaign are going to be similar or have the same content, compose your message before adding additional Variants - you will be able to choose Copy from Variant from the Add Variant dropdown.
  4. Choose a Platform, Message Type, Layout, and Enforced Device Orientation as necessary.

Variant Options by Platform

Click on your desired Platform tab to learn more about the Message Types, Layouts, and other options associated with it.

Universal In-App Messages are accepted by both mobile apps and web applications.

Message Options

Message Type Type Description Available Layouts Other Options
Full-Screen Messages that cover the entire screen with a message block. Image & Text and Image Only Enforced Device Orientation (Portrait or Landscape)
Modal Messages that cover the entire screen with a screen overlay and a message block. Text (with Optional Image) and Image Only None
Slideup Messages that slide into view in a designated place without blocking the rest of the screen. None None

Mobile App In-App Messages are only accepted by mobile apps.

Message Options

Message Type Type Description Available Layouts Other Options
Custom HTML Custom messages that perform as defined in your custom code (HTML, CSS, and/or Javascript). None None

Web In-App Messages are only accepted by websites and applications.

Message Options

Message Type Type Description Available Layouts Other Options
Email Capture Form Typically used to capture the viewer’s email. None None
Custom Web Message Custom messages that perform as defined in your custom code (HTML, CSS, and/or Javascript). None None
Web Modal with CSS Modal messages for web with customizable CSS. Text (with Optional Image) and Image Only None

Step 2: Compose In-App Message

The Compose tab allows you to edit all aspects of your message’s content and behavior.

composeyouriam

The content of the Compose tab vary based on your chosen Message Options in the last step, but may include any of the options below:

Content Options Description
Language See our full list of available languages. Click Add Lanaguages and select your desired languages from the provided list. This will insert liquid into your message. We recommend selecting your languages before writing your content so you can fill in your text where it belongs in the liquid.
Image Upload Image, Pick a Badge, or use Font Awesome. Where applicable, click Include Image or Upload Image and follow the presented instructions. Each message type and platform may have it’s own suggested proportions and requirements - be sure to check what those are before commissioning or making an image from scratch!
Button Text & On Click Behavior Add up to two buttons. You can create and edit custom button text and color. You can also add Terms of Service Link within Web Email Capture forms.
Device Options Restrict send to only iOS devices. Click Change and check the box as desired.
Message Close Options Dismiss Automatically or Wait for User Swipe or Touch. Dismiss Automatically allows you to select how many seconds the message will remain on the scree. Wait for User Swipe or Touch will require a dismissal or close option.
Header & Body Text Completely custom copy (often with custom HTML capabilities) with the options to include liquid and other types of personalization. Some message types do not need and therefore do not ask for headers.
Position From Bottom of App Screen or From Top of App Screen. This only exists in the Universal Slideup message builder.
HTML & Assets Completely custom via upload, URL, or copy and paste. Copy and paste HTML into the available space and upload your assets via ZIP.
Email Capture Input Placeholder Custom copy. This is used solely in the Web Email Capture Form and will direct your users to input the desired content into the space.

Buttons

When available for your message type, you can have up to two buttons appear below your body of text. By default, the button on the right (Button 2) is formatted to be more visually drawing to your user. We recommend using this button for singular or primary actions.

If you choose to only use one button, it will automatically adjust to take over the available space at the bottom of your message, instead of leaving room for an additional button.

Step 3: Design In-App Message

The Style tab allows you to adjust all visual aspects of your message. Upload an image or badge, or pick a pre-designed badge icon. Change the colors of the header and body text, buttons and background by selecting from a palette or entering a hex, RGB or HSB code.

The content of the Style tab vary based on your chosen Message Options in the last step, but may include any of the options below:

Formatting Input Description
Color Profile Apply from In-App Message Templates Gallery. Click Apply Template and select from gallery. Then, click Save.
Text Alignment Left, Center, or Right. Only available for newer Braze SDK versions.
Header HEX color code. Your desired HEX color will display. You will also be able to choose the opacity of the color.
Text HEX color code. Your desired HEX color will display. You will also be able to choose the opacity of the color.
Buttons HEX color code. Your desired HEX colors will display. You will also be able to choose the opacity of the colors. You can choose colors for: the message’s Close Button Background as well as each button’s Background, Text, and Border.
Background Color HEX color code. Your desired HEX color will display. You will also be able to choose the opacity of the color. This is the background of the entire message and will clearly display behind your text body.
Frame Color HEX color code. Your desired HEX color will display. You will also be able to choose the opacity of the color. Only available for newer Braze SDK versions. This is the frame around the entire message.
Chevron or other Close Message Option HEX color code. Your desired HEX color will display. You will also be able to choose the opacity of the color.

Web Modal CSS

If you choose to use a web-only, Web Modal with CSS message, you can apply your own template or write your own CSS in the provided space. This space is already pre-filled with the CSS shown in your message preview, and you should feel free to adjust it slightly to meet your needs.

If you choose to apply your own template, click Apply Template and choose from the In-App Message Template Gallery. If you don’t have any options, you can upload a CSS Template using the CSS Template builder.

Step 4: Configure Additional Settings

Add key-value pairs to your message if needed.

InAppNewComposer3

Step 5: Preview Message

Preview what your message will look like to a random user, a specific user or a customized user - the latter two are especially useful if your message contains personalization or multiple languages. You can also preview messages for either mobile devices or tablets to get a better idea of what users will experience.

InAppNewComposer4

Step 6: Trigger Your Delivery

Schedule

In-app message delivery is entirely based off of of the following action triggers:

  • Making a purchase
  • Opening the app/webpage
  • Performing a custom event (only works with events sent via the SDK)
  • Opening a specific push message
  • Automatically schedule campaigns to send at a certain time with respect to the local time of each of your users.
  • Messages can also be configured to recur on a daily, weekly (optionally on specific days), or monthly basis.

A start date and time must be selected, however, an end date is optional. An end date will stop that specific in-app message from showing up on devices after the specified date/time.

Additionally, unless you check the box titled “Allow users to become re-eligible to receive campaign” in the campaign wizard, each user will only receive the contents of a campaign once, and only new users that meet the criteria will receive the campaign on subsequent deliveries.

Finally, once you’ve selected the action the in-app message will be triggered off of, you should also set a priority. If two messages are triggered off of the same action, high priority messages will be scheduled to appear on users’ devices before messages with lower priorities.

Event Prioritization

Bucket Prioritization

Step 7: Choose Target Segment

Next, you need to choose the target segment from the dropdown menu. You’ll automatically be given a snapshot of what that approximate segment population looks like right now. Keep in mind that exact segment membership is always calculated just before the message is sent.

Target Page

Step 8: Choose Conversion Events

Braze allows you to track how often users perform specific actions (Conversion Events) after receiving a campaign. You can specify any of the following actions as a “Conversion Event”:

  • Opens App
  • Makes Purchase
    • This can be a generic purchase or a specific item
  • Performs specific custom event

You have the option of allowing up to a 30 day window during which a conversion will be counted if the user takes the specified action.

Conversion Event

Step 9: Review and Deploy

The final page will give you a summary of the campaign you’ve just designed. Clicking “Start Campaign” will enable it to send. Confirm all the relevant details and watch the data roll in!

confirm

Step 10: Analyze Results Data

For each in-app message campaign, Braze will show you impressions, unique impressions, clicks, revenue, and conversions.

Results

Original In-App Messages

Braze moved over to a new form of in-app messages with the following SDK releases:

  • iOS: 2.19.0
  • Android: 1.13.0
  • Web: 1.3.0

Prior to these releases, Braze supported “original in-app messages.” Support for original in-app messages will be provided for any customer who ran an in-app campaign prior to the new release. All of the campaign stats are unaffected by the change, and those who’ve sent original in-app messages will have the opportunity to send others via the “Create Campaign” button on the campaign screen.

Choices

WAS THIS PAGE HELPFUL?