Selections

Selections are groups of data that can be used to personalize a message for each user in your campaign. After creating a catalog, you can further reference this data by incorporating selections in your Braze campaigns. Note that the free tier of catalogs allows one selection to be created per catalog.

To create a selection, select your catalog and click Create Selection. Select the catalog column from the Filter Field dropdown. Next, select the operator, and enter the attribute. Continue to add any additional filters as needed for filter settings.

In the Sort type section, you can specify the order in which results are returned. This includes an option to randomize the sort order. Next, enter the maximum number of results, up to 10, for the Limit number under the Results limit section.

After setting up the selection, click Create Selection, and the selection will display above the catalog data. Now, you can reference this selection in your messaging.

If you use any Liquid in catalogs, such as custom attributes and custom events, this can result in different results returned for each user in your selection.

Use case

Let’s say you own a meal delivery service and want to send a personalized message to your users who have specific meal preferences based on their most recently viewed food category.

Using a catalog with your meal delivery service’s information for the meal name, price, image, category of the meal, you can create a selection to recommend three meals based on a user’s most recently viewed category.

To use this catalog and selection in a campaign, use the Add Personalization modal in the message composition section of building a campaign. In this example, we’ve selected the catalog with your meal delivery service’s information, and the selection for meal recommendations based on the most recently viewed category. This allows us to display the meal name and price. To further build our message, you can use the selection to also add an image of the first recommended meal.

For example, say you have a user whose most recently viewed category is “Chicken”. Using the set personalization and a Content Card campaign, we can send three meal recommendations that include chicken for this user.

Using the same personalization, we can also send three meal recommendations for a user whose most recently viewed category is “Beef”.