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.
Creating a selection
To create a selection, do the following.
- Select your catalog and go to the Selection tab, then click Create Selection.
- Select the catalog column from the Filter Field dropdown.
- Select the operator and enter the attribute.
You can create up to 30 selections per catalog.
- In the Sort type section, specify the order in which results are returned. This includes an option to randomize the sort order.
- Enter the maximum number of results, up to 50, for the Limit number under the Results limit section.
- Click Create Selection and the selection will display above the catalog data.
- Create a campaign, then click the plus sign in the Message composer.
- In the Add Personalization modal, select:
- Catalog Items as the Personalization Type
- The catalog name
- The type of selection
String fields with more than 1,000 characters cannot be filtered.
Liquid in selection results
Using any Liquid in catalogs, such as custom attributes and custom events, 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, and 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 your 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, you can send three meal recommendations that include chicken for this user.
Using the same personalization, you can also send three meal recommendations for a user whose most recently viewed category is “Beef”.