Creating an In-App Message

In-App messages are great for getting content to your user without interrupting their day via a push notification. Customized and tailored in-app messages will 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 will help 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

From the Messaging Page, click “Create Campaign.”


Step 2: Compose In-App Message

When composing an in-app message, you’ll now see four tabs on the right hand side - click on them to customize different aspects of your message. The pencil allows you to edit content. The paintbrush gives you control over the look and feel of the message. The gear provides a way to add key-value pairs to your in-app message. And the eye icon allows you to send test messages to yourself or to specific user profiles.


Edit all aspects of your message’s content and behavior. Insert text for the header, body, and buttons, adding personalization and multiple languages if necessary. Specify the message’s on-click behavior, as well as how the message can be dismissed. On-click actions that can be leveraged are deep linking into your app, redirecting to a web URL, and viewing a specific News Feed card. If you select the option to redirect to a web URL, your app will open a Safari (iOS) or a Chrome (Android) view of the page within your app.


Step 3: Design In-App Message

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. You can create image-only fullscreen and modal in-app messages to provide your users with a richer experience.


Step 4: Configure Additional Settings

Add key-value pairs to your message if needed.


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.


Additional customization of the appearance of your In-App messages can be accomplished by your developers. See our documentation on In-App Messages for more details.

Step 6: Trigger your Delivery


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.

Unless you check the box titled “Allow users to become re-eligible to receive campaign” under the Schedule portion of 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.

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

The high, medium, and low options for triggered message priorities are buckets, and as such multiple messages could have the same selected priority. To set priorities within these buckets, click on “Set Exact Priority” and you will be able to drag and drop campaigns to order them with the correct priority.

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!


Step 10: Analyze Results Data

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


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.