Sending test messages
This reference article goes over how to send test messages across the different Braze channels and how to incorporate custom event properties and user attributes.
By testing out your campaigns, you can make sure everything about it is just right!
Before sending out a messaging campaign to your users, you may want to test it to make sure it looks right and operates in the intended manner. You can create and send test messages to select devices or team members using the tools in the dashboard.
Make sure to save your campaign draft after testing to avoid deleting your campaign. You can send test messages without saving the message as a draft.
Channel-specific test sending
For steps to send test messages, refer to the following section for your channel.
After drafting your email message, click Preview and Test. From this page, select the Test Send tab and add your email address or user ID in the Add Individual Users field. When you’re ready, click Send Test to send your drafted email to your inbox.
After drafting your mobile push, select the Settings tab and add your email address or user ID in the Add Individual Users field. When you’re ready, click Send Test to send your drafted message to your device.
After creating your web push, select the Settings tab. Check Send Test to Myself and click Send Test.
If you have already accepted push messages from the Braze dashboard, you will see the push come through in the corner of your screen. Otherwise, click Allow when prompted, and the message will appear.
If you have push notifications set up within your app and on your test device, you can send test in-app messages to your app to see what it looks like in real-time. After drafting your in-app message, select the Test tab and add your email address or user ID to the Add Individual Users field. When you’re ready, click Send Test. A test push message will appear at the top of your device screen.
Directly clicking and opening the push message will send you to your app, where you’ll be able to view your in-app message test.
After creating your Content Card, you can send a test Content Card to your app to see what it will look like in real-time. After drafting your Content Card, select the Test tab and select at least one Content Test Group or individual user to receive this test message.
After creating your SMS/MMS message, you can send a test message to your phone to see what it will look like in real-time. After drafting your message, select the Test tab and select at least one Content Test Group or individual user to receive this test message.
After creating your webhook, you can do a test send to check the webhook response. Select the test tab and select send test to send a test send to the supplied webhook URL. You may also select an individual user to preview the response as a specific user.
News Feed card
Sending a test News Feed card requires you to set up a test segment and subsequently send a test campaign out.
Step 1: Create a designated test segment
Once you set up a test segment, you can utilize these messaging channels. The process takes a few short steps and, if configured properly, will only need to be done once.
Go to the Segments page and create a new segment. In the dropdown menu under Add Filter, locate the testing filters at the bottom of the list.
Use these testing filters to select users with specific email addresses or external user IDs.
These filters have the following options:
- Equals - Looks for an exact match of the email or user ID you provide. Use this if you only want to send the test campaigns to devices associated with a single email or user ID.
- Does not equal - Use this if you want to exclude a particular email or user ID from test campaigns.
- Matches - Finds users that have email addresses or user IDs that match part of the search term you provide. You could use this to find only the users with an “@yourcompany.com” address, allowing you to send messages to everyone on your team.
These filters can also be used in conjunction to narrow down your list of test users. For example, the test segment could include an email address filter that
matches “@braze.com” and another filter that
does not equal “email@example.com”. You can also select multiple specific emails by using the
matches option and separating the email addresses with a “|” character (e.g.,
After adding the testing filters to your test segment, verify that you’ve selected only the users you intended by clicking Preview at the top of the segment editor or by exporting that segment’s user data to CSV. To export segment user data, click the User Data dropdown and select CSV Export All User Data.
Exporting the segment’s User Data to CSV will give you the most accurate picture of who falls under that segment. The Preview tab is only a sample of users in the segment and therefore may appear to have not selected all intended members. For more information, check out [Viewing and Understanding Segment Data].
Once you’ve confirmed that you’re only targeting the users you want to receive the test message, you can either select this segment in an existing campaign that you want to test or click the Start Campaign button in the segment menu.
Step 2: Send a test campaign
To send test News Feed cards, you need to target your previously created test segment. Begin by creating a multichannel campaign and following the usual steps. When you reach the Target Users step, select your test segment as shown in the following image.
Finish confirming your campaign and launch it to test your News Feed cards.
Be sure to check the box titled “Allow users to become re-eligible to receive campaign” under the Schedule portion of the campaign wizard if you intend to use a single campaign to send a test message to yourself more than once.
Campaign personalized with user attributes
If you are using personalization in your message, you’ll need to take additional steps to properly preview your campaign and check that user data is properly populating the content.
When sending a test message, make sure to choose either the option to Select Existing User or preview as a Custom User.
If selecting an existing user, enter a specific app user’s user ID or email in the search field. Then use the dashboard preview to see how your message would appear to that user, and send a test message to your device that reflects what that user would see.
If previewing as a customized user, enter text for various fields available for personalization, such as the user’s first name and any custom attributes. Once again, you can enter your own email address to send a test to your device.
Campaign personalized with custom event properties
Testing campaigns personalized with custom event properties differs slightly from testing other types of campaigns outlined. The most robust way to test campaigns personalized using custom event properties is to trigger the campaign yourself. Begin by writing up the copy involving the event property:
Then use action-based delivery to deliver the campaign when the event occurs.
If you’re testing an iOS push campaign, you must set the delay to 1 minute to allow yourself time to exit the app since iOS doesn’t deliver push notifications for the currently open app. Other types of campaigns can be set to deliver immediately.
Target the users as you would for testing using either a testing filter or by targeting your own email address and finish creating the campaign.
Go into your app and complete the custom event, and the campaign will trigger, and you should see the message customized with the event property:
Alternatively, if you are saving custom user IDs, you can also test the campaign by sending a customized test message to yourself. After writing the copy for your campaign, select the Test tab and choose Customized User. Add the custom event property on the bottom of the page, add your user ID or email address to the top box, and click Send Test.
You should receive a message personalized with the property.