Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _docs/_developer_guide/banners/placements.md
Original file line number Diff line number Diff line change
Expand Up @@ -526,7 +526,7 @@ You can use custom properties from your Banner campaign to retrieve key–value

### Prerequisites

You'll need to [add custom properties]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns/#custom-properties) to your Banner campaign. Additionally, these are the minimum SDK versions required to access custom properties:
You'll need to [add custom properties]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create/#custom-properties) to your Banner campaign. Additionally, these are the minimum SDK versions required to access custom properties:

{% sdk_min_versions swift:13.1.0 android:38.0.0 web:6.1.0 reactnative:17.0.0 flutter:15.1.0 %}

Expand Down
8 changes: 4 additions & 4 deletions _docs/_developer_guide/banners/testing.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
---
nav_title: Test banners
article_title: Test banners
nav_title: Test Banners
article_title: Test Banners
page_order: 2
description: "Learn how to test your Banner message before launching your campaign so you can ensure all media, copy, personalization, and custom attributes render correctly."
channel:
- banners
noindex: true
---

# Test banners
# Test Banners

> Learn how to test your Banner message before launching your campaign so you can ensure all media, copy, personalization, and custom attributes render correctly. For more general information, see [About Banners]({{site.baseurl}}/developer_guide/banners).

## Prerequisites

Before you can test Banner messages in Braze, you'll need to create a [Banner campaign in Braze]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns/). Additionally, verify that the placement you want to test is already [placed in your app or website]({{site.baseurl}}/developer_guide/banners/placements).
Before you can test Banner messages in Braze, you'll need to create a [Banner campaign in Braze]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create/). Additionally, verify that the placement you want to test is already [placed in your app or website]({{site.baseurl}}/developer_guide/banners/placements).

To send a test to either [content test groups]({{site.baseurl}}/user_guide/administrative/app_settings/developer_console/internal_groups_tab/#content-test-groups) or individual users, push must be enabled on your test devices with valid push tokens registered for the test user before sending.

Expand Down
2 changes: 1 addition & 1 deletion _docs/_releases/2025/10_14_25.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ Use [Deal Cards]({{site.baseurl}}/user_guide/message_building_by_channel/email/h

### Templates for Banners

When you [compose your Banner]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns), you can now start with a blank template, use a Braze template, or select a saved Banner template.
When you [compose your Banner]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create), you can now start with a blank template, use a Braze template, or select a saved Banner template.

## Robust channels

Expand Down
2 changes: 1 addition & 1 deletion _docs/_releases/2025/11_11_25.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ You can [add a background row image]({{site.baseurl}}/user_guide/message_buildin

### Copy preview link

Use **Copy preview link** in your [Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns/#step-6-test-your-message-optional), [email custom footers]({{site.baseurl}}/user_guide/message_building_by_channel/email/custom_email_footer/#creating-your-custom-footer), and [email opt-in and unsubscribe pages]({{site.baseurl}}/user_guide/administrative/app_settings/email_settings/?tab=custom%20footer#subscription-pages-and-footers) to generate a shareable link that shows how your content will look like for a random user.
Use **Copy preview link** in your [Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create/#step-5-test-your-message-optional), [email custom footers]({{site.baseurl}}/user_guide/message_building_by_channel/email/custom_email_footer/#creating-your-custom-footer), and [email opt-in and unsubscribe pages]({{site.baseurl}}/user_guide/administrative/app_settings/email_settings/?tab=custom%20footer#subscription-pages-and-footers) to generate a shareable link that shows how your content will look like for a random user.

### WhatsApp messages with optimized delivery

Expand Down
2 changes: 1 addition & 1 deletion _docs/_releases/2025/4_1_25.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ You can [turn off click tracking]({{site.baseurl}}/user_guide/message_building_b
Banners now support Flutter. Additionally, all Banner Card documentation has been overhauled for easier usability. Check out the following articles to get started:

- [About Banners]({{site.baseurl}}/developer_guide/banners/)
- [Creating Banner campaigns]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns/)
- [Creating Banner campaigns]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create/)
- [Embedding Banners into your app]({{site.baseurl}}/developer_guide/banners/placements/)

### WhatsApp click tracking
Expand Down
4 changes: 2 additions & 2 deletions _docs/_releases/home.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ You can [add a background row image]({{site.baseurl}}/user_guide/message_buildin

#### Copy preview link

Use **Copy preview link** in your [Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns/#step-6-test-your-message-optional), [email custom footers]({{site.baseurl}}/user_guide/message_building_by_channel/email/custom_email_footer/#creating-your-custom-footer), and [email opt-in and unsubscribe pages]({{site.baseurl}}/user_guide/administrative/app_settings/email_settings/?tab=custom%20footer#subscription-pages-and-footers) to generate a shareable link that shows how your content will look like for a random user.
Use **Copy preview link** in your [Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create/#step-5-test-your-message-optional), [email custom footers]({{site.baseurl}}/user_guide/message_building_by_channel/email/custom_email_footer/#creating-your-custom-footer), and [email opt-in and unsubscribe pages]({{site.baseurl}}/user_guide/administrative/app_settings/email_settings/?tab=custom%20footer#subscription-pages-and-footers) to generate a shareable link that shows how your content will look like for a random user.

#### WhatsApp messages with optimized delivery

Expand Down Expand Up @@ -285,7 +285,7 @@ Use [Deal Cards]({{site.baseurl}}/user_guide/message_building_by_channel/email/h

#### Templates for Banners

When you [compose your Banner]({{site.baseurl}}/user_guide/message_building_by_channel/banners/creating_campaigns), you can now start with a blank template, use a Braze template, or select a saved Banner template.
When you [compose your Banner]({{site.baseurl}}/user_guide/message_building_by_channel/banners/create), you can now start with a blank template, use a Braze template, or select a saved Banner template.

### Robust channels

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,13 @@ To create a Message component, first add a step to your Canvas. Drag and drop th
### Step 1: Select your messaging channel

You can select from the following messaging channels:
- Banners (in early access)
- Content Cards
- Email
- LINE
- Push notifications
- SMS/MMS/RCS
- In-app messages
- In-app messages
- Webhook
- WhatsApp

Expand Down
Original file line number Diff line number Diff line change
@@ -1,34 +1,61 @@
---
nav_title: Create Campaigns
article_title: Create Banner campaigns in Braze
nav_title: Create a Banner
article_title: Create a Banner
page_order: 1
description: "This reference article covers how to create, compose, configure and send Banners using Braze campaigns."
description: "This reference article covers how to create, compose, configure and send Banners using Braze campaigns and Canvases."
tool:
- Campaigns
channel:
- banners
---

# Create Banner campaigns
# Create a Banner

> Learn how to create Banners when you build a campaign in Braze. For more general information, see [About Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners).
> Learn how to create Banners when you build campaigns and Canvases in Braze. For more general information, see [About Banners]({{site.baseurl}}/user_guide/message_building_by_channel/banners).

{% alert important %}
Creating a Banner message in Canvas is in early access. Contact your customer success manager if you're interested in participating in this early access.
{% endalert %}

## Prerequisites

Before you can launch your Banner campaign, your development team will need to [set up placements in your app or website]({{site.baseurl}}/developer_guide/banners/creating_placements/). You can still draft your Banner campaign in the meantime—you just won't be able to launch the campaign.
Before you can launch your Banner, your development team must [set up placements in your app or website]({{site.baseurl}}/developer_guide/banners/creating_placements/). You can still draft your Banner campaign in the meantime, but you won't be able to launch the campaign until the placements are configured.

## Creating a Banner campaign
## Create a Banner message

{% multi_lang_include banners/creating_placements.md section="user" %}

### Step 2: Create a campaign
### Step 2: 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, targeted messaging campaigns, while Canvases are better for multi-step user journeys.

{% tabs %}
{% tab 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.
4. Add [teams]({{site.baseurl}}/user_guide/administrative/app_settings/manage_your_braze_users/teams/) and [tags]({{site.baseurl}}/user_guide/administrative/app_settings/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]({{site.baseurl}}/user_guide/engagement_tools/testing/multivariant_testing).
7. 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.

{% alert tip %}
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 select **Copy from Variant** from the **Add Variant** dropdown.
{% endalert %}

{% endtab %}
{% tab Canvas %}

1. [Create your Canvas]({{site.baseurl}}/user_guide/engagement_tools/canvas/create_a_canvas/create_a_canvas/) using the Canvas composer.
2. After setting up your Canvas, add a Message step in the Canvas builder. Name your step something clear and meaningful.
3. Select **Banner** as your messaging channel.
4. Select a placement for the Banner.
5. Set the priority for the Banner. [Banner priority]({{site.baseurl}}/user_guide/message_building_by_channel/banners/#priority) determines the order in which Banners are displayed if they share the same placement.
6. Set an expiration for the Banner. This can be after a duration of time after the step is available or at a specific date and time.

{% endtab %}
{% endtabs %}

### Step 3: Compose a Banner {#compose-a-banner}

Expand All @@ -50,11 +77,11 @@ To customize your message's background properties, border settings, and more, se

#### Step 3.2: Define on-click behavior (optional)

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]({{site.baseurl}}/developer_guide/analytics/), which will update your user's profile with custom data when they click the Banner.
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]({{site.baseurl}}/developer_guide/analytics/), which updates your user's profile with custom data when they click the Banner.

{% alert important %}
{::nomarkdown}
On-click behavior can be overridden if a specific element (such as a button, link, or image, of the Banner) has its own on-click behavior. For example, given the following on-click behaviors:<br><ul><li>A Banner has an on-click behavior that redirects to a website's homepage.</li><li>An image in the Banner has an on-click behavior that redirects to a website's product page.</li></ul>If a user clicks the image, they'll be redirected to the product page. However, clicking the surrounding area in the Banner will redirect them to the homepage.
On-click behavior can be overridden if a specific element (such as a button, link, or image, of the Banner) has its own on-click behavior. For example, given the following on-click behaviors:<br><ul><li>A Banner has an on-click behavior that redirects to a website's homepage.</li><li>An image in the Banner has an on-click behavior that redirects to a website's product page.</li></ul>If a user clicks the image, they are redirected to the product page. However, clicking the surrounding area in the Banner redirects them to the homepage.
{:/}
{% endalert %}

Expand Down Expand Up @@ -83,11 +110,12 @@ When you're finished, select **Done**.

![The properties page with a string property with a key of color and value of #FF0000.]({% image_buster /assets/img/banners/example_property.png %})

### Step 4: Set campaign duration
### Step 4: Build the remainder of your campaign or Canvas

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.
{% tabs %}
{% tab Campaign %}

### Step 5: Set Banner priority (optional)
#### Set Banner priority (optional)

[Banner priority]({{site.baseurl}}/user_guide/message_building_by_channel/banners/#priority) determines the order in which Banners are displayed if they share the same placement. To manually set the priority:

Expand All @@ -99,13 +127,7 @@ Choose a start date and time for your Banner campaign. By default, Banners last
If you have multiple Banner campaigns using the same placement ID, we recommend using the drag-and-drop priority sorter to define the exact priority.
{% endalert %}

### Step 6: Test your message (optional)

{% multi_lang_include banners/testing.md page="campaigns" %}

### Step 7: Finish building the campaign

Finish building your campaign by completing the following:
#### Choose your audience

1. In **Target Audiences**, choose segments or filters to narrow your audience. You automatically receive a preview of the approximate segment population. Exact segment membership is calculated before the message is sent.

Expand All @@ -114,6 +136,25 @@ Finish building your campaign by completing the following:
{:start="2"}
2. In **Assign Conversions**, track how often users perform specific actions after receiving a campaign by defining conversion events with up to a 30-day window to count the action as a conversion.

### Step 8: Launch your campaign
{% multi_lang_include target_audiences.md %}

#### Choose conversion events

Braze allows you to track [conversion events]({{site.baseurl}}/user_guide/engagement_tools/messaging_fundamentals/conversion_events/), how often users perform specific actions, after receiving a campaign. You have the option of allowing up to a 30-day window during which a conversion is counted if the user takes the specified action.

{% endtab %}

{% tab Canvas %}

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]({{site.baseurl}}/user_guide/engagement_tools/testing/multivariant_testing/) and [Intelligent Selection]({{site.baseurl}}/user_guide/brazeai/intelligence/intelligent_selection/), and more, refer to the [Build your Canvas]({{site.baseurl}}/user_guide/engagement_tools/canvas/create_a_canvas/create_a_canvas/#step-3-build-your-canvas) step of our Canvas documentation.

{% endtab %}
{% endtabs %}

### Step 5: Test your message (optional)

{% multi_lang_include banners/testing.md page="campaigns" %}

### Step 6: Review and deploy

After you're finished building and testing your Banner campaign, you're ready to launch!
After you've finished building your campaign or Canvas, review its details, [test it]({{site.baseurl}}/user_guide/engagement_tools/campaigns/testing_and_more/sending_test_messages/), then send it when you're ready.
Loading