Creating a Push Message

Push notifications are wonderful for time-sensitive calls to action, as well as re-engaging users who haven’t come into the app in a while.

Successful push campaigns drive the user directly to content and demonstrate the value of your app.

To see examples of push notifications, check out our Case Studies.

Step 1: Create a New Push Campaign

Click Create Campaign in the top right corner of the Campaigns page.

From there, select Push Notification within Single Channel Options or Multichannel Campaign if you want to include multiple channels in addition to Push.


Step 2a: Name Your Campaign, Choose Messaging Types, and Compose your Message

Next, you need to name your campaign and select the messaging types and notification style (rich (iOS and Android) or standard) that will be included in the campaign. You select the platform(s) you’re sending a push message to by clicking on the toggle buttons on the right-hand side.


Time to write your push message! Type it into the message box and watch a preview appear in the preview box to the left. Don’t forget to use Liquid tools when writing your push messages to make them personalized and targeted.

Additional Push Customization Steps


You also can Add Languages through the Add Languages button. Braze offers the option to “Internationalize” your message by inserting the Liquid into your message to help set custom messages and fields in specific languages based on a user’s language preferences.

OnClick Behavior

Braze allows you to specify what happens when a user clicks the body of a push notification. Whether you want to do something as simple as open the application or redirect to a specified URL, we have many different ways to customize our push notifications, and therefore the user experience. Here, you can also find the option to set up button prompts within your push notification, for example: yes/no prompt, confirm/cancel, more button, etc.

For more information on platform specific Notification Options, please see our iOS Notification and Provisional Push documentation or Android Notification Options documentation.

Step 2b: Preview and Test Your Message

Arguably one of the most critical steps, testing! After you finish composing your perfect push message, you should test it before sending it out! Navigate to the test page by clicking the “Test” button denoted by the eye symbol. Use Preview Message as User to get a sense of how your message may view on mobile. Use Send Test to ensure that your message displays properly.

Step 3: Schedule Your Push Messaging Campaign


Scheduled Delivery allows you to specify the time you want the message to send, either immediately or at a future time (you can also consider local time in your scheduling). You can also use Intelligent Timing to send the message when the user is most likely to engage. Braze makes this calculation based on a statistical analysis of the user’s interactions with your app.

Messages can also be configured to recur on a daily, weekly (optionally on specific days), or monthly basis.

Intelligent Timing: Braze allows you to define a window during which you would like a user to receive a notification, and Braze will send it to each individual user at the time we determine they are most likely to engage. We make this calculation based upon a statistical analysis of the user’s past interactions with the app.

Action-Based Delivery allows you to specify the time a message will send after a user takes a particular action you are able to use custom events as a trigger action. (selected from the New Trigger Action dropdown.)


Check out our API-Triggered section of the Developer Guide for more on API-Triggered Delivery.


Step 4: Target Users

On the “Target Users” step of the campaign setup, you can choose the target audience for your campaign. Braze now provides all the detailed audience statistics on the footer. The footer will provide only the channels that are targeted by the campaign. Additionally, you will be able to see a breakdown of the ‘Push’ messages as Braze will provide details on how many will receive a Web Push versus an Android Push. In order to see what percentage of your user base is being targeted or the Lifetime Value for this segment, click the “Show Additional Stats” located below the stats footer.

Keep in mind that exact segment membership is always calculated just before the message is sent.

Multi-Channel Footer

Under the Targeting Options section, you’ll find a few options for who you can send your campaign to:

  1. Members of a previously created segment. To do this, select one segment from the dropdown under “Target Users By Segment.”

  2. Users that fall into multiple previously created segments. To do this, add multiple segments from the dropdown under “Target Users By Segment.” The resulting target audience will be users in the first segment and the second segment and the third segment, etc.

  3. Users of one or more previously created segments that also fall under additional filters. After first selecting your segment(s), you can further refine your audience under the “Additional Filters” section. This is demonstrated in the screenshot below, which targets users that are in the 10 Unread Messages segment and are in the Active Users segment , and made a purchase less than 30 days ago.

  4. Users that fall under a series of filters (and are not defined by pre-existing segments). This means you do not need to target a campaign at a pre-existing segment - you can make an ad hoc audience during campaign creation by just using the additional filters, and not selecting any segments under “Target Users By Segment. This will allow you to skip segment creation when sending campaigns to one-off audiences.


Above the Audience Statistics chart, there will be an Audience Summary that spells out which users you’re targeting.

Step 5: Choose Conversion Events

Braze allows you to track whether 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 a conversion event within a time frame that is relevant for your campaign. The conversion window for a conversion event can range from 5 minutes to 30 days. The event will count as a conversion if it takes place during the specified time.

Conversion Event

Step 6: Review and Deploy

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

Confirmation Page

Results Data

Braze will show you the number of messages sent and opened over time for each push campaign you deploy, as shown below:


For push notifications, you’ll be able to view statistics for the number of messages sent, delivered, bounced, opened, and directly opened.

New Stuff!