Creating a Content Card
This article covers how to create a Content Card in Braze. Here, we’ll cover choosing a messaging type, composing your card, and scheduling your message delivery.
You can create a Content Card using the Braze platform using campaigns and Canvases.
Step 1: Choose where to build your message
Not sure whether your message should be send using a campaign or a Canvas? Campaigns are better for single, simple messaging campaigns, while Canvases are better for multi-step user journeys.
Steps:
- Go to the Campaigns page and click Create Campaign.
- Select Content Cards, 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.
Steps:
- Create your Canvas using the Canvas wizard.
- 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. Steps containing Content Cards can be scheduled or action-based.
- 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. You can either Advance when Message Sent, which advances your users to the next steps when the Content Card is sent, or Immediately Advance Audience, which advances users when the Content Card is sent, or if the Content Card is aborted for any reason.
- Choose any other messaging channels that you would like to pair with your message.
Step 2: Specify your message types
Next, select a Card Type. Braze provides three Content Card types out-of-the-box: Classic, Captioned Image, and Banner.
To learn more about the expected behavior and look of each of these message types, refer to Creative Details, or check out the links in the following table. These Content Card types are accepted by both mobile apps and web applications.
| Message Type | Example | Description |
|---|---|---|
| Classic |  |
The Classic Card has a simple layout with a bolded title, message text, and an optional image that sits to the left of the title and text. It’s best to use a square image or icon with the Classic Card. |
| Captioned Image |  |
The Captioned Image Card allows you to showcase your content with copy and an attention-grabbing image. |
| Banner |  |
The Banner Card allows you to get creative and command attention with space for images, GIFs, and other non-text based content. |
Step 3: Compose a Content Card
You can edit all aspects of your message’s content and behavior in the Compose tab of the message editor.
The content here varies based on the Card Type chosen in the previous step, but may include any of the following options:
Language
Click Add Languages and select your desired languages from the provided list. This will insert Liquid into your message. 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 message
Write anything you want. There are no limits, but the faster you can get your message across and get your customer clicking—the better! We recommend clear and concise titles and message content. These fields are not provided for Banner Cards.
Image
To add an image to your Content Card, click Add Image or provide an image URL. Clicking Add Image opens the Media Library, where you can select a previously uploaded image or add a new one. Each message type and platform may have its own suggested proportions and requirements—be sure to check what those are before commissioning or making an image from scratch! Content Card message fields are limited to 2KB in total size.
Pin to top
A pinned card will display at the top of a user’s feed and can’t be dismissed by the user. If more than one card in a user’s feed is pinned, the pinned cards will display in chronological order. Once a card has been sent, you cannot update its pinned option retroactively. Changing this option after a campaign has been sent will only affect future sends.
On-click behavior
When your customer clicks on a presented link in the card, your link can either lead them deeper into your app or to another site. If you choose an on-click behavior for your Content Card, remember to update your Link Text accordingly!
The following actions are available to take for Content Card links:
| Action | Description |
|---|---|
| Redirect to Web URL | Open a non-native web page. |
| Deep Link into App | Deep link into an existing screen in your app. |
| Log Custom Event | Choose a custom event to trigger. Can be used to display another Content Card or trigger additional messaging. |
| Log Custom Attribute | Choose a custom attribute to set for the current user. |
Content Card message fields are limited to 2KB in total size, calculated by adding the byte-size length of the following fields: Title, Message, Image URL, Link Text, Link URL(s), and Key/Value Pairs (names + values). Messages that exceed this size will not be sent. Note that this does not include the size of the image but rather the length of the Image URL.
Each user is eligible to receive up to 100 non-expired and non-dismissed Content Cards. As a user becomes eligible for more than 100 cards, Braze will begin to remove older cards from their feed, even if they were unread.
Step 4: Configure additional settings (optional)
You can use key-value pairs to create categories for your Cards, create multiple Content Card Feeds (Android, Web, iOS, and customize how Cards are sorted.
To add key-value pairs to your message, switch to the Settings tab and click Add New Pair.
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 Content Cards.
Choose delivery schedule or trigger
Content Cards can be delivered based on a scheduled time, an action, or based on an API trigger. For more, refer to Scheduling your campaign.
You can also set the campaign’s duration and Quiet Hours and determine the Content Card’s expiration. Set a specific expiration date or the days until a Card expires, up to 30 days. All variants have identical expiration dates.
Frequency Capping does not apply to Content Cards.
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. Keep in mind that exact segment membership is always calculated just before the message is sent.
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 step. 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, test it, then send it!
After a Content Card is launched, it can’t be edited. It can only be stopped from sending to new users and removed from users’ feeds.
Next, check out Content Card reporting to learn how you can access the results of your Content Card campaigns.
Things to know
Capabilities not yet supported
The following capabilities are not yet supported for Content Cards:
- Vouchers
- Frequency Capping
- Re-ordering Content Cards from the Braze UI
- Post-launch Edits
Sending behavior
Once Content Cards have been sent, similar to emails, they sit waiting in an “inbox” ready to be delivered to the user. Once content is pulled into the Content Card (at time of displaying), the content cannot be changed during its lifespan. This applies even if you are calling an API through Connected Content, and the data from the endpoint changes. This data will not get updated. It can only be stopped from sending to new users and removed from users’ feeds. If you modify a campaign, only future cards that are sent will have the update.
If you need to remove old cards, you must stop the campaign to do so. To stop a campaign, open your Content Card campaign and select Stop Campaign. Stopping the campaign will prompt you to decide how to handle users that have already received your card. If you would like to remove the Content Card from your users’ feeds, select Remove card from feed. The card will then be hidden by the SDK on the next sync.
Card removal events
Some Content Cards are only relevant up until a user performs some action. For example, a card nudging users to activate their account shouldn’t be shown once the user completes that onboarding task.
Within a campaign or Canvas Message, you can optionally add a Removal Event to specify which custom events or purchases should cause previously sent cards to be removed from that user’s feed; triggered via SDK or REST API.
You can specify multiple custom events and purchases that should remove a card from a user’s feed. Once any of those actions are performed by the user, any existing cards sent by the campaign’s cards will be removed. Any future eligible cards will continue to be sent according to the message’s schedule.
Updating sent cards
If you find you need to make changes to cards that have already been sent:
- Stop your campaign.
- Remove active Content Cards from users’ feeds.
- Edit your campaign as needed.
- Restart your campaign.
Edit this page on GitHub