Carousel view

This section covers implementing a multi-card carousel feed where a user can swipe horizontally to view additional featured cards. To integrate a carousel view, you’ll need to use a fully customized Content Card implementation—the “run” phase of the crawl, walk, run approach.

With this approach, you will not use Braze’s views and default logic but will instead display the Content Cards in a completely custom manner by using your own views populated with data from the Braze models.

In terms of the level of development effort, the key differences between the basic implementation and the carousel implementation include:

• Building your own views
• Logging Content Card analytics
• Introducing additional client-side logic to dictate how many and which cards to show in the carousel

Implementation

Step 1: Create a custom view controller

To create the Content Cards carousel, create your own custom views and subscribe for data updates. Note that you won’t be able to use Braze’s default ContentCardFragment, as it’s only able to handle our default Content Card types.

Step 2: Implement analytics

When creating a fully custom view controller, Content Card impressions, clicks, and dismissals are not automatically logged. You must implement the respective analytics methods to ensure impressions, dismissal events, and clicks get properly logged back to Braze’s dashboard analytics.

For information on the analytics methods, refer to Card analytics methods.

Step 3: Create a Content Card update handler

Follow the steps for Using multiple Content Card feeds to set key-value pairs on cards and create a Content Card update handler.

For Android-specific developer documentation on the Content Cards class, methods, and attributes in Kotlin, refer to the Android com.braze.ui.contentcards.view documentation.

Considerations

• By using completely custom views, you will not be able to extend or subclass the methods used in ABKContentCardsController. Instead, you’ll need to integrate the data model methods and properties yourself.
• The logic and implementation of the carousel view is not a default type of Content Card in Braze, and therefore the logic for achieving the use case must be supplied and supported by your development team.
• You will need to implement client-side logic to display a specific number of cards in the carousel at any one time.