Content Card customization

Content Card data models

The Braze Web SDK supports several unique Content Card card types, ab.ClassicCard, ab.Banner, ab.CaptionedImage which share a base model, ab.Card.

Customizing the default UI

Braze UI elements come with a default look and feel that matches the composers within the Braze dashboard and aims for consistency with other Braze mobile platforms. Braze’s default styles are defined in CSS within the Braze SDK.

By overriding selected styles in your application, it is possible to customize our standard feed with your own background images, font families, styles, sizes, animations, and more. For instance, the following is an example override that will cause Content Cards to appear 800px wide:

1
2
3
body .ab-feed {
  width: 800px;
}

Create a custom UI

Refreshing the feed

To refresh and sync a user’s feed with Braze servers, use the requestContentCardsRefresh method.

1
2
3
4
5
import braze from "@braze/web-sdk"

function refresh(){
  braze.requestContentCardsRefresh();    
}

Listening for card updates

When cards are refreshed, a callback function can be subscribed to:

1
2
3
4
5
6
import braze from "@braze/web-sdk"

braze.subscribeToContentCardsUpdates(function(updates){
  const cards = updates.cards;
  // do something with the latest instance of `cards`
});

Logging analytics events

Log impression events when cards are viewed by users.

1
2
3
import braze from "@braze/web-sdk"

braze.logCardImpressions(cards, true);

Log card click events when users interact with a card.

1
2
3
import braze from "@braze/web-sdk"

braze.logCardClick(card, true);