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: Choose where to build your message
Not sure whether your message should be sent using a campaign or a Canvas? Campaigns are better for single, simple messaging campaigns, while Canvases are better for multi-step user journeys.
- Go to Messaging > Campaigns and click Create Campaign.
If you are using the older navigation, you can find Campaigns under Engagement.
- Select Push Notification, or, for campaigns targeting multiple channels, select Multichannel Campaign.
- Name your campaign something clear and meaningful.
- Add Teams and Tags as needed.
- Tags make your campaigns easier to find and build reports out of. For example, when using the Report Builder, you can filter by particular tags.
- Add and name as many variants as you need for your campaign. You can choose different platforms, message types, and layouts for each of your added variants. For more on this topic, refer to Multivariate and A/B testing.
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 can then choose Copy from Variant from the Add Variant dropdown.
- Create your Canvas using the Canvas composer.
- After you’ve set up your Canvas, add a step in the Canvas builder. Name your step something clear and meaningful.
- Choose a step schedule and specify a delay as needed.
- Filter your Audience for this step as necessary. You can further refine the recipients of this step by specifying segments and adding additional filters. Audience options will be checked after the delay at the time messages are sent.
- Choose your advancement behavior.
- Choose any other messaging channels which you would like to pair with your message.
Step 2: Specify delivery platforms
Start by choosing which platform should receive the push: iOS, Android, or Web. Use this selection to limit the delivery of a push notification to a specific set of apps. For multichannel campaigns or Canvases, click Add Messaging Channel to add additional push platforms.
Because platform selections are specific to each variant, you could try testing message engagement per platform!
Step 3: Select notification type (iOS and Android)
For iOS and Android, select your notification type:
- Standard Push
- Push Stories
- Inline Image (Android only)
Step 4: Compose your push message
Now it’s time to write your push message! The Compose tab allows you to edit all aspects of your message’s content and behavior.
The content of the Compose tab varies based on your chosen notification type in the previous step, but may include any of the following options:
Notification channel or group (iOS and Android)
Add copy in multiple languages using the Add Languages button. We recommend selecting your languages before writing your content so you can fill in your text where it belongs in the Liquid. See our full list of available languages.
Title and body
Start typing in the message box and watch a preview appear in the preview box to the left. Push messages must be formatted in plain text. To add a headline to an iOS push notification, use the Title field.
To make your push personalized and targeted, you can include Liquid.
Need help creating awesome copy? Try using the AI copywriting assistant. Input a product name or description and the AI will generate human-like marketing copy for use in your messaging.
Where supported, your app icon is automatically added as the image for your push notification. You also have the option to send rich notifications, which allow for more customization in your push notifications by adding additional content beyond copy.
For additional guidance on using images in your push notifications, refer to the following articles:
Specify what happens when a user clicks the body of a push notification with On-Click Behavior. For example, you can prompt customers to open your application, redirect customers to a specified Web URL, or even open a specific page of your application with a deep link.
Here, you can also set up button prompts within your push notification, such as:
If a user has your app installed on multiple devices, by default, your push message is sent to all devices with a valid push token assigned. If desired, you can select Only send this push to the user’s most recently used device.
There is some nuance for this setting. If this option is selected, Braze will limit multiple sends from occurring except when a campaign targets multiple platforms, such as both iOS and Android. If the user has your app on both an iOS and an Android device, they will receive a push for both platforms. If a user’s most recently used device isn’t push enabled, the message will not send.
For iOS, you can further limit messaging by only sending push notifications to iPad devices, or only sending to iPhone and iPod devices.
Step 4a: Preview and test your message
Testing is arguably one of the most critical steps. After you finish composing your perfect push message, test it before sending it out. Select the Test tab and use Preview Message as User to get a sense of how your message may view on mobile. Use Send Test to send yourself a test push and ensure that your message displays properly.
Step 5: Build the remainder of your campaign or Canvas
Build the remainder of your campaign; see the following sections for further details on how to best utilize our tools to build push notifications.
Choose delivery schedule or trigger
Push messages can be delivered based on a scheduled time, an action, or based on an API trigger. For more, refer to Scheduling your campaign.
For action-based delivery, you can also set the campaign’s duration and Quiet Hours.
Choose users to target
Next, you need to target users by choosing segments or filters to narrow down your audience. You’ll automatically be given a snapshot of what that approximate segment population looks like right now. Detailed audience statistics for the channels targeted by your campaign are available in the footer. To see what percentage of your user base is being targeted and the Lifetime Value for this segment, click Show Additional Stats.
Why does my Total Reachable Users metric not match the sum of all channels?
When you view the Total Reachable Users for your filtered audience, you may notice that the sum of the individual columns is smaller than the Total Reachable Users. This gap is usually because there are a number of users who qualify for the segment or filters in the campaign, but are not reachable through push (for example, because they don’t have valid or active push tokens).
Keep in mind that exact segment membership is always calculated just before the message is sent.
You can also choose to only send your campaign to users who have a specific subscription status, such as those who are subscribed and opted in to push.
Optionally, you can also limit delivery to a specified number of users within the segment, or allow users to receive the same message twice upon a recurrence of the campaign.
Multichannel campaigns with email and push
For multichannel campaigns targeting both email and push channels, you may want to limit your campaign so that only the users who are explicitly opted in will receive the message (excluding subscribed or unsubscribed users). For example, say you have three users of different opt-in statuses:
- User A is subscribed to email and is push enabled. This user doesn’t receive the email but will receive the push.
- User B is opted-in to email but is not push enabled. This user will receive the email but doesn’t receive the push.
- User C is opted-in to email and is push enabled. This user will receive both the email and the push.
To do so, under Audience Summary, select to send this campaign to “opted-in users only”. This option will ensure that only opted-in users will receive your email, and Braze will only send your push to users who are push enabled by default.
With this configuration, don’t include any filters in the Target Users step that limit the audience to a single channel (for example,
Push Enabled = True or
Email Subscription = Opted-In).
Choose conversion events
Braze allows you to track how often users perform specific actions, conversion events, after receiving a campaign. 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.
If you haven’t done so already, complete the remaining sections of your Canvas component. For further details on how build out the rest of your Canvas, implement multivariate testing and Intelligent Selection, and more, refer to the Build your Canvas step of our Canvas documentation.
Step 6: Review and deploy
After you’ve finished building the last of your campaign or Canvas, review its details. For campaigns, the final page will give you a summary of the campaign you’ve just designed. Confirm all the relevant details, make sure you’ve tested your message, then send it and watch the data roll in!
Next, check out Push reporting to learn how you can access the results of your push campaign. For push notifications, you’ll be able to view statistics for the number of messages sent, delivered, bounced, opened, and directly opened.