Creating and Using a Segment Extension
This article will walk you through how to use a Segment Extension to enhance your segmentation capabilities
A Segment Extension expands our existing segmentation capabilities by enabling you to target more precise lists of users based on their custom event and purchase behavior in the past 365 days. You can create a maximum of 10 Segment Extensions per App Group. After these extension lists are generated, they can then be included or excluded as a filter in your segments. When creating a Segment Extension, you can also specify that the list be regenerated once every 24 hours.
Step 1: Navigating to the Segment Extension Section
From the left-hand side of the Dashboard under Engagement, expand the Segments section, and click Segment Extension. From the Segment Extensions table, click + Create New Extension.
Step 2: Name Your Segment Extension
Name your Segment Extension by describing the type of users you intend to filter for. This will ensure that this extension can be easily and accurately discovered when applying it as a filter in your segment.
Step 3: Choose Your Criteria
Select between a purchase or custom event criteria for targeting. Once you’ve selected the desired event type criteria, choose which purchased item or specific custom event you’d like to target for your user list. Then choose how many times (more than, less than, or equal to) the user would need to have completed the event, and how many days to look back, up to 365 days.
Event Property Segmentation
To increase targeting precision, select the Add Property Filters checkbox. This will enable you to drill down based on the specific properties of your purchase or custom event. We support event property segmentation based on string, numeric, boolean, and time objects. We also support segmentation based on nested event properties.
Segment Extensions rely on long term storage of event properties and don’t have the 30-day custom event property storage limit. This means you can look back on event properties tracked within the past year, and tracking doesn’t wait until the extension has been set up first.
Using event properties within Segment Extensions does not impact data point usage.
You can specify whether you want this extension to represent a single snapshot in time, or whether you want this extension to regenerate on a daily basis. Your extension will always begin processing after the initial save. If you would like the extension to be regenerated daily, select the Regenerate Extension Daily checkbox and the regeneration will begin processing at around midnight each day in your company’s time zone.
Starting on November 29, 2021, the setting to regenerate extensions daily will be automatically turned off for unused Segment Extensions. Braze defines unused extensions as ones that meet the following criteria:
- Not used in any active campaigns, Canvases, or segments
- Not used in any inactive (draft, stopped, archived) campaigns, Canvases, or segments
- Have not been modified in over 7 days
Braze will notify the company contact and creator of the extension when this setting is turned off. The option to regenerate extensions daily can be turned on again at any time.
Step 4: Save Your Segment Extension
Once you click Save, your extension will begin processing. The length of time it takes to generate your extension depends on how many users you have, how many custom events or purchase events you’re capturing, and how many days you’re looking back in history.
While your extension is processing, you will see a small animation next to the name of the extension, and the word “Processing” in the Last Processed column on the extension list. Note that you will not be able to edit an extension while it is processing.
Step 5: Using Your Extension in a Segment
Once you have created an extension, you can use it as a filter when creating a segment or defining an audience for a campaign or Canvas. Start by choosing Braze Segment Extension from the filter list under the User Attributes section.
From the Braze Segment Extension filter list, choose the extension you wish to include or exclude in this segment.
To view the extension criteria, click View Extension Details to show the details in a modal popup.
Now you can proceed as usual with creating your segment.