Creating Banner campaigns

Learn how to create Banners when you build a campaign in Braze. For more general information, see About Banners.

Prerequisites

These are the minimum SDK versions to start using Banners:

Creating a Banner campaign

Step 1: Create placements in Braze

If you haven’t already, you’ll need to create Banner placements in Braze that are used to define the locations in your app or site can display Banners. To create a placement, go to Settings > Banners Placements, then select Create Placement.

Give your placement a name and assign a Placement ID. Be sure you consult other teams before assigning an ID, as it’ll be used throughout the card’s lifecycle and shouldn’t be changed later. For more information, see Placement IDs.

Step 2: Create a campaign

1. Go to Messaging > Campaigns and select Create Campaign.
2. Select Banner.
3. Name your campaign something clear and meaningful.
4. 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 the relevant tags.
5. Select the placement you previously created to associate it with your campaign.
6. Add variants as needed. You can choose a different message type and layout for each one. For more information on variants, refer to Multivariate and A/B testing.

Step 3: Compose a Banner

To compose your Banner, select Edit message. Here, you can create the Banner and define on-click behavior.

Step 3.1: Style the Banner

You can drag and drop blocks and rows into the canvas area to start building your message.

To customize your message’s background properties, border settings, and more, select Styles. If you only want to customize the style for a specific block or row, select it to make changes.

Step 3.2: Define on-click behavior

When a user clicks a link in the Banner, you can choose to navigate them deeper into your app or redirect them to another webpage. Additionally, you can choose to log a custom attribute or event, which will update your user’s profile with custom data when they click the Banner.

Step 4: Set campaign duration

Choose a start date and time for your Banner campaign. By default, Banners last indefinitely. You can change this by selecting End Time and specifying an end date and time.

Step 5: Set Banner priority (optional)

Banner priority determines the order in which Banners are displayed if they share the same placement. To manually set the priority:

1. Select Set exact priority.
2. Drag and drop the campaigns to order them with the correct priority.
3. Select Apply Sort.

Step 6: Test your message (optional)

Select Preview to you preview your Banner or send a test message.

Keep in mind, your preview may not be identical to the final render on a user’s device due to differences across hardware.

To send a test message, add either a content test group or one or more individual users as Test Recipients, then select Send Test. You’ll be able to view your test message on the device for up to 5 minutes.

While reviewing your test Banner, verify the following:

• Is your Banner campaign assigned to a placement?
• Do the images and media show up and act as expected on your targeted device types and screen sizes?
• Do your links and buttons direct the user to where they should go?
• Does the Liquid function as expected? Have you accounted for a default attribute value in the event that the Liquid returns no information?
• Is your copy clear, concise, and correct?

Step 7: Finish building the campaign

Finish building your campaign by completing the following:

Step 8: Launch your campaign

After you’re finished building and testing your Banner campaign, you’re ready to launch!